飞书集成模式配置指南
飞书集成模式配置指南
飞书集成模式允许第三方应用与飞书平台进行深度整合，用户可以通过飞书工作台直接访问和使用这些应用，实现单点登录和统一管理。这种集成方式不仅简化了用户的操作流程，还提高了工作效率。本文将详细介绍如何配置飞书集成模式，包括创建自建应用、设置权限、添加应用能力等关键步骤。
1. 概述
本产品支持与飞书集成，通过飞书自建应用完成相关配置，并建立飞书单点登录关系。成员可直接在飞书工作台中使用本产品，或通过飞书手机号登录本产品。
2. 创建自建应用
建议由飞书企业超级管理员进行以下操作。
请飞书企业超级管理员进入飞书开放平台创建一个内部应用。如下图所示：
填写应用基本信息后，点击「创建」。如下图所示：
在「凭证与基础信息」中，将 AppID 和 App Secret 信息记录下来。
3. 设置权限
自建应用需要获取以下权限，缺少权限可能会导致部分功能异常，请开通以下所有权限。
- 校验用户是否为应用管理员
- 获取应用管理员 ID
- 获取通讯录基本信息
- 获取部门基础信息
- 获取通讯录部门组织架构信息
- 获取用户组信息
- 获取用户基本信息
- 获取用户组织架构信息
- 获取用户受雇信息
- 获取用户手机号
- 以应用的身份发消息
- 获取企业信息
- 获取与上传图片或文件资源
在「权限管理」中，搜索并勾选上述的所有权限，然后点击「批量开通」。如下图所示：
4. 添加应用能力
在「添加应用能力」中，添加「机器人」、「网页应用」能力。如下图所示：
进入「网页应用」页面，配置项可任意填写，最终地址需在本产品中配置后才能获取，此处可随意填写，后续步骤中会修改。如下图所示：
完成以上设置后，进入「版本管理与发布」, 点击右侧的创建版本，填写相关信息后发布版本，使配置生效。如下图所示：
注：如果是飞书管理员创建的应用，无需审批。若需要审批，请管理员进行审批并通过。
5. 飞书集成配置
回到本产品中，请超管进入安全管理页面，开启「飞书集成」。如下图所示：
将第 2 节获取的 AppID 和 App Secret 填写在弹窗中，点击「下一步」。如下图所示：
复制「重新定向 URL」、「网页应用配置」信息，填写在飞书中。如下图所示：
回到自建应用中，进入「安全设置」页，将重定向 URL 填写在此处。如下图所示：
进入网页应用中，重新编辑配置，将弹窗中的「网页应用配置 URL 」填写在桌面端主页、移动端主页。如下图所示：
信息填写完成后，需要创建一个新版本使配置生效。如下图所示：
6. 设置通讯录权限范围
访问飞书管理后台，在「工作台 >应用管理」中找到刚才的自建应用，点击右侧的配置，按需配置通讯录权限，即在本产品中的可同步的企业成员。
操作 | 实现效果 |
|---|---|
不勾选保持一致、不配置任何人 | 无法正常同步成员、无法获取成员部门信息 |
不勾选保持一致、配置范围与可见范围不一致 | 产品中的企业成员为「通讯录权限范围」的成员仅能同步「通讯录权限范围」的部门信息同步企业成员成功后，会将不在「通讯录权限范围」内的用户踢出（成员变为已离职状态） |
与可用人员范围保持一致 | 正常同步成员、正常获取成员部门信息修改「应用可见范围」，本产品中的成员列表也会跟随变化，同步后的企业成员为应用可见范围的成员 |
7. 实现效果
7.1 登录使用
- 回到配置界面，点击「确定」。如下图所示：
- 在飞书工作台中会展示自建应用，点击即可在工作台中使用本产品。如下图所示：
注：若用户在飞书企业下，同时部署了多个本产品的应用，且出现同时登录的场景，可能会导致工作台企业切换异常，请重新打开应用。
- 如果在浏览器中使用产品，可使用飞书手机号登录，且企业标签会切换成「飞书自建」标签。如下图所示：
7.2 成员同步
设置完成后，进入本产品，在「成员管理」中可以获取「通讯录权限范围」的成员，并获取部门信息。如下图所示：
若通讯录权限范围发生变化，可点击「立即同步」同步最新成员，或设置「每天0点自动同步」。如下图所示：
7.3 消息通知
在飞书集成模式下，自动化通知新增「飞书通知」方式，支持自定义发送通知给对应成员，实现每日数据报告或预警通知效果。
详情参见文档：自动化-消息通知
8. 解绑企业
解绑飞书企业后，飞书通讯录、飞书消息等功能将不可用。如需解绑飞书企业，关闭「飞书集成」按钮即可。如下图所示：