飞书集成模式

简道云支持与飞书进行集成,通过飞书自建应用并完成相关配置,即可在飞书工作台使用简道云。

1. 注册飞书

首先,需要在 飞书 注册账号创建团队。

已创建过团队则忽略此步骤,直接 登录 飞书账号。

2. 创建自建应用

创建完团队后,需要进入 飞书开放平台 创建一个内部应用。

  • 未创建过可以直接点击「创建应用」

  • 已创建过滑动到页面中间区域选择「创建企业自建应用」

然后按照要求填写好应用资料,填写完毕点击「确定创建」。

最后点击应用详情,在「凭证与基础信息」中,将参数 AppID 和 App Secret 记录下来。

并在综合信息处修改应用图标:

3. 设置权限

进入「权限管理」页面,需开通以下 13 种权限:

  1. 获取用户 user ID
  2. 获取用户基本信息
  3. 以应用的身份发消息
  4. 给多个用户批量发消息
  5. 给一个或多个部门的成员批量发消息
  6. 获取用户组织架构信息
  7. 获取角色权限
  8. 获取通讯录部门组织架构信息
  9. 获取部门基础信息
  10. 以应用身份读取通讯录
  11. 校验用户是否为应用管理员
  12. 获取应用信息
  13. 获取应用管理员 ID

在「权限管理」中,将上述需要设置的 13 项权限一一选择,然后点击「批量开通」。如下图所示:

4. 安全设置

在「安全设置」中的「重定向 URL」中添加:https://lark.jiandaoyun.com/lark/corp/install/callback

5. 获取事件订阅必要参数

访问「事件订阅」,首次访问需点击重置 Encrypt Key:

然后记录参数 Encrypt Key 和 Verification Token。

6. 启用网页

择「应用功能 >> 网页」在右侧开启网页,地址任意填写(由于最终使用的地址必须在简道云中安装完成才能获取,因此初次安装可以随意填写,后续会修改)。

7. 发布初始版本

点击左侧的版本管理与发布, 点击右侧的创建版本.

版本详情页面如下填写:

  • 应用版本号: 1.0.0
  • 更新说明: 初始版本

填写基础资料:

然后点击「申请线上发布」:

此时企业管理员将会在飞书 App 内收到一条申请请求,管理员点击详情进行审批并通过。

注:如果是飞书管理员创建的应用, 则自动审批通过了, 无需审核应用。

8. 在简道云中绑定

需要先登录(注册)好 简道云 账号,登录后访问地址 https://lark.jiandaoyun.com/lark/corp/install,将上述步骤获取的参数 + 企业名称(可自定义输入企业名称)填入表单,点击「安装」:

复制页面上的 5 项信息存档:(重要,一定要复制下来进行存档‼️)

  • 桌面端主页
  • 移动端主页
  • 重定向URL1
  • 重定向URL2
  • 请求地址URL

在跳转后的页面点击授权后回到简道云,停留在最终页面

停留在此页面:将此页面的URL一一填写到步骤【9】中的相关位置。

9.飞书相关配置

9.1 参数回写飞书

将上述页面中的信息回填到飞书开放平台。

  • 将重定向 URL1 和 URL2 参数填写至飞书自建应用 → 安全设置下的重定向 URL 中;
  • 将桌面端主页, 移动端主页参数填写至飞书自建应用 → 网页下的桌面端主页及移动端主页中;
  • 将请求地址 URL 参数填写至飞书自建应用 → 事件订阅下的「请求网址URL」中。

1)重定向 URL 设置

2)网页配置

3)请求地址设置

9.2 启用机器人

启用机器人,可以用于接收消息提醒。

9.3 事件订阅配置

在事件订阅中,将以下事件进行添加。

  • 通讯录
    • 用户状态变更
    • 通讯录变更

9.4 配置 H5 可信域名

配置 H5 可信域名可以使用定位等 JSAPI 功能。可信域名:

https://lark.jiandaoyun.com

在「安全设置 >> H5 可信域名」处添加可信域名。

9.5 重新发布版本

全部填写完毕后,由于信息发生变动,需要重复【7】的步骤,再发布一个新版本。

10. 调整通讯录可见范围

访问 https://feishu.cn/admin/appCenter/manage,在「工作台 >> 应用管理」中找到刚才的自建应用,点击右侧的配置,按需配置通讯录可用性权限。

配置完成后需要在简道云中重新同步通讯录。

11. 绑定完成

完成上述步骤后,即完成了简道云与飞书的绑定,拥有可用性权限的成员可以在飞书中使用简道云。

12. 参数修改

当飞书后台的参数发生变动后,需要在简道云中完成同步修改。

右上角头像 >> 企业管理 >> 企业信息 >> 授权信息「修改」>> 进行参数修改

13. 登录使用

不同身份的成员登录使用简道云的方式参见:飞书登录方式

Copyright(C)2023 HFBangFu Inc. All Rights Reserved 皖ICP备12017563号-5