飞书集成模式

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

1. 注册飞书

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

2. 创建自建应用

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

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

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

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

3. 设置权限

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

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

4. 安全设置

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

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

访问「事件与回调 >> 加密策略」，首次访问需点击重置 Encrypt Key：

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

6. 启用网页

选择「应用能力 >> 添加应用能力」，在右侧选择网页应用添加，地址任意填写（由于最终使用的地址必须在简道云中安装完成才能获取，因此初次安装可以随意填写，后续会修改）。

进行网页应用配置：

7. 发布初始版本

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

版本详情页面如下填写:

填写基础资料：

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

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

8. 在简道云中绑定

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

复制页面上的 5 项信息存档:（重要，一定要复制下来进行存档‼️）

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

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

9.飞书相关配置

9.1 参数回写飞书

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

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. 登录使用

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