集成飞书

1. 集成能力

No.	能力类型	描述	是否支持
1	ONES 消息通知到飞书	ONES 中产生的消息将通知到飞书，并且支持点击查看详情页面。	支持
2	同步成员与组织架构到 ONES	以飞书企业成员与组织架构作为数据源（User Provider），同步到 ONES 实现快速启用与统一帐号管理。	支持
3	通过飞书登录到 ONES	通过飞书的帐号验证服务，登录到已绑定的 ONES 中，实现安全快捷单点登录。	支持

ONES 支持与飞书集成，实现 ：

1. ONES 系统用户与飞书用户绑定；

2. ONES 系统消息通知到飞书效果；

3. 飞书通知打开 ONES 对应详情页面。

2. 使用说明

2.1 公有云版系统

① 在系统【团队配置中心】（多团队下【组织管理】）> 【第三方帐号】> 点击【飞书】。

② 在【绑定飞书】页面，按照引导在飞书管理后台获取、安装「ONES 助手」应用，并完成配置后即可。

飞书「ONES 助手」启用与配置说明

2.2 私有部署/高可用部署版系统

① 私有部署或高可用部署版本系统用户，需要通过创建飞书自建应用的方式实现 ONES 与飞书的集成。

飞书自建应用创建指南：https://open.feishu.cn/document/uQjL04CN/ukzM04SOzQjL5MDN?lang=zh-CN

② 在系统【团队配置中心】（多团队下【组织管理】）> 【第三方帐号】> 点击【飞书】。

③ 在新打开的配置页面，将你创建的飞书自建应用信息：App ID、App Secret；以及订阅时间配置信息：Encrypt Key、Verification Token，填写到对应输入框中。

并且确认已经在你的飞书自建应用中开启「机器人」能力。

确认完成以上设置后，即可点击「下一步」。系统将检查设置内容，如出现报错请检查你填写信息是否有误或未打开「机器人」能力。

④-1 网页配置。在你的飞书自建应用中「启用网页」，并且把 ONES 系统提供的「桌面端/移动端主页」URL 复制并粘贴到飞书应用“桌面端主页”，“移动端主页”中

④-2 安全设置。通过复制粘贴将ONES 系统提供的3个重定向URL添加到飞书自建应用“安全设置-重定向 URL”中。

④-3 请求网址设置。通过复制粘贴将ONES 系统提供的请求网址 URL 添加到飞书自建应用“请求网址”中。

确认将「接收消息」、「用户和机器人的会话首次被创建」2个事件添加到订阅事件中。

④-4 权限配置。根据界面中的引导将列出的权限添加到飞书自建应用权限配置中。

完成以上配置后，点击「提交配置」按钮。

⑤ 发布自建应用。在ONES 系统完成配置后，你需要发布飞书自建应用。 发布自建应用指南：https://open.feishu.cn/document/uQjL04CN/ugTO5UjL4kTO14CO5kTN

⑥ 绑定用户。为实现 ONES 消息通知到飞书对应用户，需要团队成员各自完成 ONES 帐号与飞书帐号绑定。发布自建应用后，通知你的同事在飞书应用中搜索自建应用。

点击进入应用后，系统将自动发送帐号绑定通知，点击通知中「绑定帐号」按钮。如果没有收到绑定通知，可以在应用对话框中输入：「绑定账号」，机器人将回复绑定通知。

系统将自动打开浏览器展示扫码绑定页面。

扫码登录后即可确认帐号绑定。

⑦ 开启飞书通知方式。

单个手动开启：手动在系统中各需要通知到飞书的设置中勾选「飞书」渠道（下面以项目-工作项类-工作项通知 为例）。

批量开启开启：在「飞书」配置成功页面，点击「批量添加飞书通知」按钮。

在确认弹窗中点击「确定」，即可批量在全系统「工作项通知」、「工作项提醒」、「后置动作发送通知」设置中勾选「飞书」通知渠道。

⑧ 通知效果。当系统中有新消息时，将通过飞书同步通知到对应用户。

并且，在飞书通知中点击「详情」，可免登打开对应详情页面。