飞书自建应用集成

2047 上次更新时间:2022-05-06 10:59:37

Document

应用集成说明

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

集成步骤

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.确认使用人包含当前用户。