简道云如何与飞书集成连接?揭秘如何在飞书中使用简道云!
作为一款强大的平台,简道云不仅支持在平台内部快速搭建企业应用,也能通过第三方集成,在其他应用中使用相关的功能。例如,简道云能支持与飞书进行集成,通过飞书自建应用并完成相关配置,即可在飞书工作台使用简道云。那么简道云如何与飞书集成连接?完成以下步骤即可!
步骤导览:
- 1. 注册飞书(已创建过团队则忽略此步骤,直接登录飞书账号)
- 2. 创建自建应用
- 3. 设置权限
- 4. 安全设置
- 5. 获取事件订阅必要参数
- 6. 启用网页
- 7. 发布初始版本
- 8. 在简道云中绑定
- 9.飞书相关配置
- 9.1 参数回写飞书
- 9.2 启用机器人
- 9.3 事件订阅配置
- 9.4 配置 H5 可信域名
- 9.5 重新发布版本
- 10. 调整通讯录可见范围
- 11. 绑定完成
- 12. 参数修改
1. 注册飞书
首先,需要在 飞书 注册账号创建团队。
已创建过团队则忽略此步骤,直接 登录 飞书账号。
2. 创建自建应用
创建完团队后,需要进入 飞书开放平台 创建一个内部应用。
- 未创建过可以直接点击「创建应用」
- 已创建过滑动到页面中间区域选择「创建企业自建应用」
然后按照要求填写好应用资料,填写完毕点击「确定创建」。
最后点击应用详情,在「凭证与基础信息」中,将参数 AppID 和 App Secret 记录下来。
并在综合信息处修改应用图标:
3. 设置权限
进入「权限管理」页面,需开通以下 13 种权限:
- 获取用户 user ID
- 获取用户基本信息
- 以应用的身份发消息
- 给多个用户批量发消息
- 给一个或多个部门的成员批量发消息
- 获取用户组织架构信息
- 获取角色权限
- 获取通讯录部门组织架构信息
- 获取部门基础信息
- 以应用身份读取通讯录
- 校验用户是否为应用管理员
- 获取应用信息
- 获取应用管理员 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,将上述步骤获取的参数 + 企业名称(可自定义输入企业名称)填入表单,点击「安装」:
在跳转后的页面点击授权后回到简道云,停留在最终页面。
停留在此页面:将此页面的URL一一填写到步骤【9】中的相关位置。
复制页面上的 5 项信息存档:(重要,一定要复制下来进行存档‼️)
- 桌面端主页
- 移动端主页
- 重定向URL1
- 重定向URL2
- 请求地址URL
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. 参数修改
当飞书后台的参数发生变动后,需要在简道云中完成同步修改。
右上角头像 >> 企业管理 >> 企业信息 >> 授权信息「修改」>> 进行参数修改: