Skip to main content

企业微信对接指南


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

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

第一阶段:授权代开发

1、进入组织后台授权页面

超级管理员依次点击 个人头像 > 组织管理 >第三方平台,选择企业微信。

企业微信、钉钉、飞书、Welink只能选择一个平台对接,如果已经对接了一个,其他平台就不再显示了。只有关闭已集成的对接才可以对接其他平台。

2、扫码授权

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

扫码后依次点击页面底部的按钮,直到授权完成。

点击二维码下方的[确认]按钮,然后联系您的顾问协助完成第二阶段的代开发

在代开发完成前,这个页面和企业微信的对接应用的状态都会显示为开发中

第二阶段:代开发协助处理

此阶段的操作需要HAP顾问联系您时一起协作完成。

3、授权通讯录权限

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

操作步骤如下图:

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

第三阶段:完成对接

4、修改对接应用的基本信息

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

  • 1)打开对接应用

    进入 应用管理 > 应用 > 自建应用栏,点击 HAPAPaaS平台。

  • 2)进行相关操作

    可以修改名称、图标、描述等信息,或者停用/启用。删除应用在当前应用最下方。

5、配置同步人员范围

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

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

同步黑名单

如果您想同步完整的部门结构,但又有一些用户不想同步到HAP(如实习生、兼职人员),您可在企业微信通讯录管理中添加自定义文本信息字段命名为“同步”,不需要同步的账号将此字段设置为0,HAP会识别此标识且不进行同步。

  • 1)通讯录中添加自定义字段

  • 2)将不需要同步人设置为0

  • 3)授权给HAP获取自定义信息

    在授权字段中选择扩展属性。

6、同步通讯录

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

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

开始同步

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

本次同步内容:

1)绑定关系

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

  • 左侧是HAP的组织账号(还未绑定企业微信),在右侧选择要绑定的第三方平台账户。

  • 系统会根据姓名自动匹配相同姓名的账户(有姓名匹配标签),如果不对,可以移除重新选择绑定

2)同步内容概览

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

  • 新增组织用户数

    如果获取到的企业微信账户未绑定到组织账户,同步时将会自动创建新的HAP账户并与之自动绑定。如下图,右侧詹善福(企业微信账户)还未选择绑定,那么确定同步时会自动创建新账号。

  • 匹配到已有组织用户数

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

  • 同步企业微信用户数

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

3)确认同步

确认绑定关系后,点击同步按钮即可。

如果本次同步还有企业微信账户没有被绑定到组织账户,则会有以下提示,让您再次确认,如果无误,点击【确认】按钮即可。

管理已绑定关系

管理员在组织管理后台>集成>第三方平台>数据同步中,可以查看和管理现有的账号绑定关系。

  • 可以查看目前已经绑定的账户

  • 可以取消现有绑定,被取消的企业微信账户将不能再登录HAP,再次点击同步时,可以重新绑定。

7、接口费用

HAP和企业微信做对接,需要调用企业微信的接口。企业微信针对接口的调用是按账户数收费的,这笔费由用户承担,管理员先在组织后台下单确认费用,然后联系顾问代支付给企业微信。

下单时,仅仅为当前所有的用户购买了接口使用权。如果后续有新人增加,需要您为新用户再次购买。

如果没有为用户支付接口费用,在使用时会提示应用无法使用。

企业微信的企业ID

8、启用微信扫码登录

支持企业微信扫码快速登录HAP,不过依然需要一些配置,以及和HAP对接人的协作。

详情参考:

9、查看对接效果

  • 在企业微信工作台,可以免密登录HAP

  • 同步了部门和人员信息


文档问题反馈

文档中是否有错别字、内容过期、难以理解等问题? 点此给我们反馈吧