明道云如何与飞书对接集成


集成说明

明道云可以在飞书中以自建应用的方式进行集成。集成后,支持直接将飞书侧的组织架构同步到明道云中,以及在飞书客户端直接打开明道云,另外也支持将应用与工作流消息推送到飞书。

集成步骤

1、进入明道云组织后台

[!TIP]企业微信、钉钉、飞书只能选择一个平台对接,如果已经对接了一个,另外两个就不再显示了。

2、打开对接指南页面

点击【如何获取对接信息?】,即可打开安装指南页面和必要的对接信息。

3、登录飞书开放平台,创建应用

飞书开放平台地址为 (https://open.feishu.cn/app) ,然后点击“创建应用”。

[!TIP]注意:飞书和lark是两个相互独立的平台。明道云仅支持和飞书的对接,请确保您登录的应用后台地址是 open.feishu.cn,open.larksuite.com 是不支持对接的。

4、填写应用基本信息

其中应用图标从第2步的对接指南应用中下载。

5、进入飞书应用的详情页

确定创建应用后,会先进入应用列表,然后点击应用名称进入应用详情。

  • 应用列表
  • 应用详情

    6、在飞书应用中设置主页地址

    地址从第2步的对接指南页中获取

    • 在飞书应用中配置“网页”,记得先启用。

    • 在安全配置中配置URL

7、启用飞书应用的机器人

启用机器人功能,这样在飞书消息侧就能直接收到明道云内部的流程、应用消息。

8、添加需要的权限

需要添加7个接口的权限:

  • [用户]获取用户邮箱信息
  • [用户]获取用户手机号
  • [用户]获取用户userid
  • [消息]以应用的身份发消息
  • [消息]给多个用户批量发消息
  • [通讯录]以应用身份访问通讯录(历史版本)
  • [应用管理]获取应用信息

操作如下图,每次只能添加一个权限、因此要操作7次。 全部权限获取完后,如下图:

9、创建版本发布和可用人员范围

飞书中的应用每次做了调整,都需要创建一个发布的新版本以及确认可用人员范围。

设置同步的人员和部门

这里选择的人员和部门,就是在飞书中可见“明道云”应用的人员,也是同步到明道云的人员。

举个例子:您公司使用飞书的是100人,使用明道云的人数是30人,那么这里就选择那30人,通过部门或指定人员来选择控制范围。

对于后续的同步,都是依据此范围。例如选择了销售部,如果飞书中有员工不在销售部了,再一次同步通讯录时,明道云系统会自动将此人办理离职,如果飞书有新的人加入了销售部,再一次同步通讯录时,明道云会自动同步创建此员工的账号或恢复账号。

10、飞书管理员审核并发布

11、完善明道云平台中和飞书的对接信息

将App ID和App Secret写入到下面的地方

如何获取App ID和App Secret

12、同步通讯录

同步后,会将飞书的人员信息新增到更新同步进明道云

同步前必看

从飞书的通讯录同步到明道云,是依据手机号进行匹配关联的。

同步的时候是按手机号匹配的,如果明道云组织中有相同手机号的账户,则直接建立和飞书的关联,如果没有则自动创建新的明道云账户。

  • 即使明道云系统中已经有相同的手机号账户,但是不在这个您的组织中,依然不匹配关联,而是会创建新的账户。

示例: 在飞书中,员工绑定的手机号是199-9999-9999, 在同步到明道云的组织时,这个组织网络内有个账户也绑定了手机号199-9999-9999, 如果有则直接关联,如果没有,则自动创建一个新的账户并关联。

  • 即使明道云系统中现在有个199-9999-9999的账户,但不在您的组织网络内,依然不会同步并关联的,而是自动创建一个新的明道云账户。

在同步前,管理员要做好及明晰以下两点

  • 1、确定好使用明道云的飞书账号范围, 范围设置参考文本第9步。

  • 2、已经有明道云账号的且加入组织的员工,一定要让员工核对好明道云账户绑定的手机号和飞书的手机号是否一致,如果不一致,请尽快绑定或换绑保持一致,全部确认后再进行同步通讯录的操作。

  • 3、还没有明道云账户的员工,点击同步后,会自动创建一个明道云账户

13、完成集成

进入飞书工作台,可以直接打开明道云。

  • 飞书PC端

  • 飞书APP

results matching ""

    No results matching ""