钉钉、企微、飞书/Lark集成HAP时组织结构的同步规则介绍
HAP已经完成和钉钉、企微和飞书/Lark的对接集成,在对接后,需要同步两侧的账号以及组织架构的信息。
一、同步的字段
同步的方向: 【企微/钉钉/飞书】的账号和部门信息同步覆盖到HAP。
如下表所示,是目前支持同步的字段,√表示支持同步,X表示不支持同步。

说明:
- 手机号和邮箱 :
- 工号: 企业微信默认不同步,但支持绑定自定义字段信息实现同步
- 职位: 企业微信可通过职务字段同步
- 组织角色: 企业微信可通过选择同步标签字段
二、同步的依据字段
优先通过手机号,其次通过邮箱
优先通过手机号来匹配两个平台之间的账号,如果手机号找不到,则通过邮箱查找匹配,如果依旧匹配不到,则创建新的HAP账号并建立关联,新的HAP账号绑定的是一个虚拟的邮箱。
仅支持钉钉和飞书,企业微信需要手动同步并选择绑定的账号
账号匹配流程图

以下2种情况不会匹配关联
- 1、HAP系统中已经有相同的手机号/邮箱账户,但是不在这个您的组织中,不匹配关联。
- 2、HAP账号已经邀请加入组织,但是对方还未激活,不匹配关联。
三、同步的用户范围
仅仅会将【钉钉/企业微信/飞书】侧的有效激活账号同步覆盖到HAP。
如果同步后,钉钉/企业微信/飞书的账号离职了,再次同步后,HAP这边的账号也会自动办理离职。
- 1、企业微信侧同步的用户范围设置

选择人员的范围可以是部门、成员和标签,如果选择了成员和标签,那么不会同步部门信息的。
- 2、钉钉侧同步的用户范围设置

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

四、如何定时同步
钉钉、飞书完成集成对接后,支持定时自动同步通讯录,如每天凌晨1点自动同步一次。
企业微信同步时由于不能获取用户的手机号邮箱等信息,无法自动绑定账户,不能定时同步。
使用示例
可以在任意应用创建一个定时触发的工作流,触发后调用发送API请求节点即可。注:触发时间频率根据需要设定,人数越多同步越慢,因此频率可以低一些,建议最多控制在每小时一次

文档问题反馈

