Skip to main content

飞书集成

平台可以通过集成飞书实现组织架构同步、飞书应用集成与免登、流程消息打通飞书通知等功能。

组织同步​

组织同步功能能将飞书的组织部门架构及成员信息同步到平台，简单几步即可完成配置：

1、 进入系统集成-飞书，查看组织同步需要填写的基本信息​

image.png

需要填写的信息主要包括：应用基础信息、应用地址、事件订阅、同步配置等。

2、 创建飞书平台对接应用​

管理员需要进入飞书开发平台开发者后台, 创建企业内部应用

image.png

创建应用后即可在飞书应用凭证与基础信息里查看 AppId 和 App secret，复制后填写到平台飞书基础信息里。

3、填写飞书应用首页地址​

打开飞书应用能力-网页能力，点击编辑按钮，填写对应的首页地址。

image.png

应用电脑端主页和手机端主页可以从平台飞书集成那获取，应用首页地址可以填写 PC 端首页地址。

4、设置应用权限​

在飞书应用->权限管理里设置同步范围并设置通讯录接口权限，目前只支持同步所有员工。

image.png

应用必须要授权通讯录权限，否则同步时将无法获取组织成员数据。必须添加的权限有以下 6 个，请复制名称逐个搜索后，点击右侧的申请选择将会自动获取权限。

  • 以应用身份读取通讯录
  • 获取部分基础信息
  • 获取部门组织架构信息
  • 获取用户基础信息
  • 获取用户邮箱信息
  • 获取用户 user ID

5、开启消息订阅​

配置消息订阅支持在飞书组织成员数据变更时，通过订阅消息机制自动同步到平台。进入飞书后台开发配置-事件订阅，在订阅管理处获取加密 aes_key 和签名 token(如未生成可以点击按钮重新生成)。将复制后的信息填写到平台飞书集成的加密密钥和 token 处，同时将平台的事件通知地址复制到飞书应用后台事件回调请求网址里。

image.png

如果飞书后台保存成功，则代表事件订阅设置成功。注意请求地址需要公网可访问的平台通知地址。

6、发布飞书应用​

在飞书应用后台-应用发布里进行应用发布操作，如果应用设置有变更，需发布新版本才会生效。

image.png

7、同步组织架构​

在平台管理中心-组织架构处点击组织同步，选择飞书，点击确认同步即可触发异步同步任务，稍后平台将自动完成组织架构的同步。完成组织同步后即可在平台对不同成员设置角色及权限，成员可以通过飞书直接打开对应的应用。注意组织同步对应的应用在飞书打开将默认进入平台工作台，如果想在飞书内直接通过飞书应用列表打开单个应用，则需要新增飞书应用级接入。

注意组织内的用户必须使用具备唯一标识能力的字段进行同步，默认是手机号，需要每个成员都填写手机号)，此外可在平台自定义同步规则里设置邮箱、用户 ID 等作为唯一标识。

飞书应用集成​

飞书应用接入无需处理组织同步信息，接入步骤比组织级别应用简单。只需要创建应用并填写应用的首页地址即可。应用的首页地址在平台应用-应用设置-系统集成里可以看到

image.png

企微消息通知​

在流程属性里，打开飞书通知即可完成流程与飞书通知的对接。流程流转时，将通过飞书自动发送信息给对应的审批人，审批人可以在飞书内点击链接直接登录应用进行审批操作。

image.png