Skip to main content

钉钉、企微、飞书集成HAP时组织结构的同步规则介绍


HAP已经完成和钉钉、企微和飞书的对接集成,在对接后,需要同步两侧的账号以及组织架构的信息。

一、同步的字段

同步的方向: 【企微/钉钉/飞书】的账号和部门信息同步覆盖到HAP。

如下表所示,是目前支持同步的字段,√表示支持同步,X表示不支持同步。

说明:

  • 手机号和邮箱

    • SaaS不支持同步,是因为需要通过手机号和邮箱来匹配两个平台之间的已有账号是否是同一个人

    • 企业微信集成时不能获取到企业用户的手机号和邮箱

    • 私有部署的钉钉和飞书在绑定账号后,支持将手机号和邮箱同步覆盖到HAP

  • 工号: 企业微信默认不同步,但支持绑定自定义字段信息实现同步

  • 职位: 企业微信可通过职务字段同步

  • 组织角色: 企业微信可通过选择同步标签字段

二、同步的依据字段

优先通过手机号,其次通过邮箱

优先通过手机号来匹配两个平台之间的账号,如果手机号找不到,则通过邮箱查找匹配,如果依旧匹配不到,则创建新的HAP账号并建立关联,新的HAP账号绑定的是一个虚拟的邮箱。

仅支持钉钉和飞书,企业微信需要手动同步并选择绑定的账号

账号匹配流程图

以下2种情况不会匹配关联

  • 1、HAP系统中已经有相同的手机号/邮箱账户,但是不在这个您的组织中,不匹配关联。

  • 2、HAP账号已经邀请加入组织,但是对方还未激活,不匹配关联。

三、同步的用户范围

仅仅会将【钉钉/企业微信/飞书】侧的有效激活账号同步覆盖到HAP。

如果同步后,钉钉/企业微信/飞书的账号离职了,再次同步后,HAP这边的账号也会自动办理离职。

  • 1、企业微信侧同步的用户范围设置

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

    特殊规则:如果您想同步完整的部门结构,但又有部分用户不想同步到HAP占用账号数量(如实习生),您可在企业微信通讯录管理中添加自定义文本信息字段“同步”,并将不同步的账号设置为0,HAP会识别此标识且不进行同步。详情参考

  • 2、钉钉侧同步的用户范围设置

    注意,这里是同步的人员,如果同步的人在钉钉工作台可见HAP应用,还需要设置以下范围。

  • 3、飞书侧同步的用户范围设置

四、如何定时同步

钉钉、飞书完成集成对接后,支持定时自动同步通讯录,如每天凌晨1点自动同步一次。

企业微信同步时由于不能获取用户的手机号邮箱等信息,无法自动绑定账户,不能定时同步。

  • 接口地址:

    https://liteapi.mingdao.com/sync?p=xxxx&c=yyyy

    私有部署地址为:${服务器地址}/integrateapi/sync/auto?p=x&c=y ,例如,http://172.17.30.60:8880/integrateapi/sync/auto?p=x&c=y

  • 参数说明:

    • 参数P

      是36位的组织编号,获取路径:HAP组织管理 > 组织信息 > 组织编号

    • 参数c

      不同对接平台的参数值如下:

      • 钉钉使用的是 CorpId; 在钉钉后台首页获取。

      • 企业微信使用的 企业ID; 在企微管理后台获取。

      • 飞书对接使用的是 App ID; 在飞书对接应用中获取。

      • 华为云对接使用的是 client_id

使用示例

可以在任意应用创建一个定时触发的工作流,触发后调用发送API请求节点即可。注:触发时间频率根据需要设定,人数越多同步越慢,因此频率可以低一些,建议最多控制在每小时一次


文档问题反馈

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