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


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

一、同步的字段

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

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

说明:

  • 手机号和邮箱

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

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

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

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

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

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

二、同步的依据字段

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

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

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

账号匹配流程图

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

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

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

三、同步的用户范围

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

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

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

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

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

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

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

四、如何定时同步

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

SaaS版企业微信由于无法自动绑定账户,则不建议使用此方式。

  • 接口地址:

    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位的组织编号,获取路径:明道云组织管理 > 组织信息 > 组织编号

    • 参数c

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

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

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

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

      • 华为云对接使用的是 client_id

使用示例

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


文档问题反馈

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

results matching ""

    No results matching ""