飞书集成模式（独享版）
1. 简介
2. 创建企业
创建企业时，需要填写以下信息：
- 企业名称：后期可修改；
- 管理员用户名：创建后不可修改，管理员通过此用户名登录企业；
- 登录密码：不可更改，管理员通过此用户名登录企业，因此创建时，需要记住该密码；密码至少包含数字、大写字母、小写字母及特殊字符中的三种
- 成员分配数量：默认 10 人，可直接输入人数，后期可修改。（成员分配数量不可超过剩余可分配人数）
3. 集成步骤
3.1 注册飞书
首先，需要在 飞书 注册账号创建团队。
注：已创建过团队则忽略此步骤。
3.2 创建应用
创建完团队后，需要在 飞书开放平台 创建一个自建应用。
未创建过应用的用户可以直接点击「创建应用」新建一个自建应用，如下图所示：
已创建过应用的用户滑动到页面中间区域选择「创建企业自建应用」，如下图所示：
按照要求填写好应用资料，填写完毕点击「确定创建」。
然后点击应用详情，获取相关参数，如下图所示：
在应用详情「凭证与基础信息」中的参数 AppID 和 App Secret 复制备份，如下图所示：
并在综合信息处修改应用图标：
3.3 设置权限
选择权限管理，至少添加以下 13 种权限：
- 获取用户 user ID
- 获取用户基本信息
- 以应用的身份发消息
- 给多个用户批量发消息
- 给一个或多个部门的成员批量发消息
- 获取用户组织架构信息
- 获取角色权限
- 获取部门组织架构信息
- 获取部门基础信息
- 以应用身份读取通讯录
- 校验用户是否为应用管理员
- 获取应用信息
- 获取应用管理员ID
在权限管理中，搜索需要添加的权限，全部选择完毕后，点击批量申请：
上述权限均为免审核权限，点击「批量开通」即可开通。
3.4 安全设置
在安全设置中的重定向 URL 中添加重定向URL，URL 地址组成为：
https://{你的独享版服务域名}<:非标端口></二级路径>/lark/corp/install/callback
其中 lark 以前的部分为您需要绑定的简道云独享版账号的自有域名。如下图所示：
3.5 获取Encrypt Key和Verification Token
访问「事件订阅」页面，若首次访问，需点击重置 Encrypt Key，然后复制 Encrypt Key 和 Verification Token 进行备份。如下图所示：
3.6 启用网页
点击「应用功能 >> 网页」在右侧开启网页，地址任意填写(由于最终使用的地址必须在简道云中安装完成才能获取，因此初次安装可以随意填写，后续会修改)。
3.7 发布初始版本
点击左侧的版本管理与发布, 点击右侧的创建版本.
版本详情页面如下填写:
- 应用版本号: 1.0.0
- 更新说明: 初始版本
然后「点击申请发布」。
此时企业管理员将会在飞书 App 内收到一条申请请求，管理员点击详情进行审批并通过。
注：如果是飞书管理员创建的应用， 将自动审批通过， 无需审核应用。
3.8 在简道云中绑定
3.8.1 登录简道云账号
管理员登录独享版配置中心，在「基础信息 >> 平台信息」处，找到访问地址，并以此账号进行登录：
注：登录的账号需为内置模式的独享版账号，如果是已经绑定的集成模式独享版账号，则需要先解绑为内置模式，再来绑定飞书。
3.8.2 绑定飞书
登录后在浏览器新开一个页面，访问地址：
https://{你的独享版服务域名}<:非标端口></二级路径>/lark/corp/install
将 lark 之前的内容替换成您自己的域名再访问。如：https://hc.jiandaoyun.com/lark/corp/install。
然后将上述步骤获取的参数 + 企业名称填入下方对应位置，填写完毕「点击安装」。如下图所示：
然后点击「授权」：
授权后，停留在最终页面，请勿离开。如下图所示：
复制页面上的 5 项信息存档，以防丢失:（重要，一定要复制下来进行存档‼️）
- 桌面端主页
- 移动端主页
- 重定向URL1
- 重定向URL2
- 请求地址URL
3.9 飞书相关配置
3.9.1 参数回写飞书
将上述页面中的信息回填到 飞书开放平台。
- 将重定向URL1和URL2参数填写至飞书自建应用 → 安全设置下的重定向URL中；
- 将桌面端主页, 移动端主页参数填写至飞书自建应用 → 网页下的桌面端主页及移动端主页中；
- 将请求地址URL参数填写至飞书自建应用 → 事件订阅下的「请求网址URL」中。
1）重定向 URL 设置
2）网页配置
3）请求地址设置
3.9.2 启用机器人
启用机器人，可以用于接收消息提醒。
3.9.3 事件订阅配置
在事件订阅中，将以下事件进行添加。
- 通讯录
- 用户状态变更
- 通讯录变更
3.9.4 配置 H5 可信域名
配置 H5 可信域名可以使用定位等 JSAPI 功能。可信域名为您自己的域名：
https://{你的独享版服务域名}
然后在「安全设置>>H5 可信域名」处添加可信域名。如下图所示：
3.9.5 重新发布版本
全部填写完毕后，由于信息发生变动，需要重复【7】的步骤，再发布一个新版本。
3.10 调整通讯录可见范围
访问 https://feishu.cn/admin/appCenter/manage，在「工作台 >> 应用管理」中找到刚才的自建应用，点击右侧的配置，按需配置通讯录可用性权限。如下图所示：
配置完成后需要在简道云中重新同步通讯录。
4. 登录账号
4.1 创建者身份登录
至此，账号集成相关配置已全部完成。
登录独享版控制台，点击基础信息中的访问地址，通过企业管理员用户名和密码即可以创建者身份登录简道云企业中：
登录 通讯录，可以看到已经同步过来的飞书集成模式成员，如下图所示：
4.2 成员身份登录
除创建者身份以外的其他成员（包括管理员）登录简道云时，可以通过企业账号 URL 进行登录。如下图所示：
还可以直接在飞书客户端登录简道云：
5. 集成模式解绑操作
独享版飞书集成模式解绑时，需按照如下所示步骤进行：
1）管理员前往飞书管理后台停用并删除简道云应用，接着进入「简道云 >> 管理后台 >> 企业信息」处解绑飞书。详情参见：解绑飞书。
2）简道云应用停用后，管理员登录独享版配置中心，在「企业管理 >> 企业列表」处，找到需要解绑的应用，点击「修改企业信息」，选择企业账号模式为「内置模式」。如下所示：
6. 注意事项
当飞书后台的参数发生变动后，需要在简道云中完成同步修改。「右上角头像>>企业管理>>企业信息>>授权信息「修改」>>进行参数修改」，如下图所示：
400-111-0890
在线咨询