应用集成说明

参考飞书介绍：飞书开放平台

集成步骤

1、配置速融云团队后台

团队设置→绑定模式→飞书绑定（自建应用）。

2、登陆飞书后台创建应用

飞书官网：https://open.feishu.cn/app

3、设置应用详情

填写飞书应用名称、应用描述，点击确定创建。

4、设置应用凭证与基础信息

点击自建应用，复制 App ID、App secret 备用。

在速融云后台，粘贴 App ID、App secret 。

在飞书事件订阅，重置 Encrypt Key ，复制Encrypt Key、Verification Token 到速融云-飞书绑定页面。

保存速融云的飞书应用信息，复制事件订阅地址备用。

在飞书事件订阅，在「请求网址URL」粘贴事件订阅地址链接，点击保存即可。

如下图点击「添加事件」，添加具体如下。

请按照下述进行添加事件：

• 用户状态变更
• 通讯录变更
• 部门新建
• 部门被删除
• 部门信息变化
• 删除人员类型事件
• 通讯录范围权限被更新
• 员工入职
• 员工离职
• 员工信息变化
• 用户变更

注意事项：如果遇到重复的事件名称，请选择第一个（比如：当有新的「员工入职」的时候触发此事件）。

如下图点击「以应用身份读取通讯录」→「开通权限」。

回到速融云页面，复制桌面端、移动端地址、重定向地址复制备用。

5、启用飞书网页

在飞书应用功能→网页→网页配置，粘贴桌面端主页、移动端主页链接，点击保存。

6、配置重定向 URL

在飞书安全设置→重定向 URL 复制该链接，点击添加。

7、配置测试

在速融云团队设置，点击配置测试，如配置成功则进行下一步。

8、启用飞书的机器人

作用：可接受到应用推送的消息，并进行处理。

9、自建应用集成的权限管理

注意：需配置权限管理，否则不能正常使用。

请按照下述添加权限管理：

用户

• 获取用户邮箱信息
• 获取用户手机号
• 获取用户 user ID

消息

• 以应用的身份发消息（历史版本）
• 给多个用户批量发消息
• 给一个或多个部门的成员批量发消息
• 获取用户发给机器人的单聊消息（历史版本）
• 获取用户在群聊中@机器人的消息（历史版本）

通讯录

• 获取部门组织架构信息
• 以应用身份访问通讯录（历史版本）

应用管理​

• 获取应用信息

10、在飞书创建应用并发布

点击创建→创建版本，设置版本详情，点击保存后发布。

保存发布后，您会看到当前版本已发布，也会在飞书上收到审核通过消息提醒。

注意：如果您在飞书上已设置应用审核规则或关闭自建应用免审，请点击飞书管理后台，在「工作台」→「应用审核」，点击审核即可收到审核通过消息。

11、同步飞书组织构架

完成同步后，即可在飞书使用速融云应用。

演示图

飞书 web 端

飞书移动端

常见问题

问：为什么无法获取同步成员信息？
​
答：1.请确认应用是否已经发布。
​

​
2.请确认相关权限已经打开。
​
通讯录

• 获取部门组织架构信息
• 以应用身份访问通讯录（历史版本）

问：为什么收不到系统消息推送？

答：1.需要检查您的机器人是否已经配置，如果没有打开机器人则无法推送。

2.需要确认消息相关权限是否打开，请检查以下权限：

• 以应用的身份发消息（历史版本）
• 给多个用户批量发消息
• 给一个或多个部门的成员批量发消息
• 获取用户发给机器人的单聊消息（历史版本）
• 获取用户在群聊中@机器人的消息（历史版本）

问：为什么打开登录不了

答：1.请确认应用是否已经发布。

2.请确认相关权限已经打开。
​
通讯录

• 获取部门组织架构信息
• 以应用身份访问通讯录（历史版本）

3.确认使用人包含当前用户。