企业微信对接指南

对接方式说明： 根据企业微信自建应用的策略规定，SaaS平台要对接企业微信，需通过“代开发模式”完成对接，即用户扫码授权后，统一交给服务商（HAP）完成剩余的对接工作。

注：私有部署用户和已按自助开发模式完成对接的，可参考自助对接方式进行对接或修改。

第一阶段：授权代开发

HAP 管理员点击【个人头像】 > 【组织管理】 > 【集成】 > 【企业身份】，选择企业微信。

HAP 只能对接一个平台，如果已经对接了一个，其他平台不再显示，关闭已集成后可以对接其他平台。

企业微信管理员用企业微信APP扫描页面中的二维码进行授权。

扫码后依次点击页面底部的按钮，直到授权完成。授权完成后，点击二维码下方的[确认]按钮，然后联系您的顾问协助完成第二阶段的代开发操作。

此阶段的操作需要和顾问一起协作完成。

在代开发时，HAP需要获取通讯录授权，届时您的企业微信会收到消息推送，点击授权即可。

操作步骤如下图：

完成以上步骤后，只需等待代开发完成，完成后企业微信会有消息提醒，如下图：

点此打开企业微信后台，扫码登录。

贵司使用企业微信的人员是100人，但是使用HAP的人数可能是50人，并非同步所有的账号。超过HAP授权人数时会无法同步，因此我们可以根据部门和指定人员来确认好同步的人员范围，设定范围如下图：

选择人员的范围可以是部门、成员和标签。如果只选择了成员和标签，则不会同步部门信息。

当您需要同步完整部门架构，但希望排除个别用户（如实习生、兼职人员）时，可在企业微信通讯录中新增自定义文本字段“同步”。将不需要同步的账号把该字段值设置为0，HAP会识别该标识并跳过同步。

1）添加“同步”自定义字段

在企业微信后台进入“通讯录” - “通讯录管理”，点击"企业内资料显示"旁边的 "修改"按钮，在弹窗中点击"添加自定义信息" ，命名为“同步”。
2）将不需要同步人设置为0

在通讯录的组织架构中，将不需要同步人员的“同步”字段设置为0
3）授权给对接应用获取自定义信息

在企业微信后台打开对接应用，点击“授权信息”卡片中"查看"按钮，然后点击底部的"编辑权限"，展开“成员基本信息”，勾选“扩展属性”后保存。

私有部署不需要做这一步操作。

开启【同步根目录】后，将企业微信组织架构的根节点（通常为组织名称），作为一级部门进行同步

企业微信账号要一键登录HAP，那么在HAP也必须要有一个关联绑定的组织账户，对接完成前最后一步就是同步账户数据，将企业微信账户和HAP组织账户绑定起来。

由于企业微信的通讯录限制，服务商（HAP）在获取企业微信账户时，不能获取到手机号和邮箱地址，因此在同步时不能准确的匹配两个平台间的账户，只能通过相同姓名默认关联，再由操作人员决定是否关联正确，如果不正确可以手动关联。

组织超级管理员进入组织管理后台 > 集成 > 第三方平台 > 点击【同步】按钮。然后会显示出本次同步的内容，确认好绑定同步的内容后点击确认同步。

本次同步内容：

在下方表格区，将第三方平台(企业微信)账户绑定到HAP组织账户

选择完成账号绑定关系后，在上方会有本次同步的信息汇总

新增组织用户数

如果获取到的企业微信账户未绑定到组织账户，同步时将会自动创建新的HAP账户并与之自动绑定。如下图，右侧詹善福（企业微信账户）还未选择绑定，那么确定同步时会自动创建新账号。
匹配到已有组织用户数

本次同步将要绑定组织账户的企业微信账户数量。下方的解绑和绑定都会改变此值。
同步企业微信用户数

是在本次同步前已经绑定过组织账户的企业微信账户数量。再次点击同步仅同步信息。如果历史没有绑定过，则不显示此项。