飞书集成模式

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

1. 注册飞书

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

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

2. 创建自建应用

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

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

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

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

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

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

3. 设置权限

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

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

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

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 参数填写至飞书自建应用 → 事件与回调下事件配置的「配置订阅方式」中。

1)重定向 URL 设置

2)网页配置

3)配置订阅方式

9.2 添加机器人

添加机器人应用,可以用于接收消息提醒。

9.3 事件订阅配置

在事件与回调中,将以下事件进行添加。

  • 员工入职 v2.0
  • 员工信息变化 v2.0
  • 员工离职 v2.0
  • 通讯录范围权限被更新 v2.0

注:已经配置过飞书集成模式的老用户,依然可以通过添加「用户状态变更 v1.0」和「通讯录变更 v1.0」这两个事件完成配置。

9.4 配置 H5 可信域名

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

https://lark.jiandaoyun.com

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

9.5 重新发布版本

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

10. 调整通讯录可见范围

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

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

11. 绑定完成

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

12. 参数修改

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

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

13. 登录使用

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

文档内容是否对您有帮助?
有帮助
没帮助没帮助
如需获取即时帮助,请联系技术支持
咨询
扫码领取100+零代码资料简道云官方微信号400-111-0890
图标在线咨询
立即体验