飞书自建应用集成

659 上次更新时间:2021-09-30 19:32:09

Document

应用集成说明

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

集成步骤

1、配置速融云团队后台

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

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

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

3、设置应用详情

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

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

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

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

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

保存速融云的飞书应用信息,点击保存后即可获取桌面、移动端地址、重定向地址,复制备用。

5、启用飞书网页

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

6、配置重定向 URL

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

7、配置测试

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

8、启用飞书的机器人

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

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

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

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

用户

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

消息

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

通讯录

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

应用管理

  • 获取应用信息

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

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

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

11、同步飞书组织构架

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

演示图

飞书 web 端

飞书移动端

常见问题

问:为什么无法获取同步成员信息?

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



2.请确认相关权限已经打开。

通讯录

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

问:为什么收不到系统消息推送?

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

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

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

问:为什么打开登录不了

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

2.请确认相关权限已经打开。

通讯录

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

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