# 集成飞书 ## 1. 集成能力 | No. | 能力类型 | 描述 | 是否支持 | | --- | --------------- | -------------------------------------------------------- | ---- | | 1 | ONES 消息通知到飞书 | ONES 中产生的消息将通知到飞书，并且支持点击查看详情页面。 | 支持 | | 2 | 同步成员与组织架构到 ONES | 以飞书企业成员与组织架构作为数据源（User Provider），同步到 ONES 实现快速启用与统一帐号管理。 | 支持 | | 3 | 通过飞书登录到 ONES | 通过飞书的帐号验证服务，登录到已绑定的 ONES 中，实现安全快捷单点登录。 | 支持 | ONES 支持与飞书集成，实现 ： 1. ONES 系统用户与飞书用户绑定； 2. ONES 系统消息通知到飞书效果； 3. 飞书通知打开 ONES 对应详情页面。 ## 2. 使用说明 ### 2.1 公有云版系统 ① 在系统【团队配置中心】（多团队下【组织管理】）> 【第三方帐号】> 点击【飞书】。 ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-MGDCVJjPUNwAl1LTSTC%2F-MGDCoKjgk7CSn6nMsV3%2Fimage.png?alt=media\&token=3188139f-3444-4a5c-a5f4-dddddc73ca33) ② 在【绑定飞书】页面，按照引导在飞书管理后台获取、安装「ONES 助手」应用，并完成配置后即可。 ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-MGDFYI_TgJVPSkP6Gre%2F-MGDGjGhtdf18GR2ylU1%2Fimage.png?alt=media\&token=768b8b84-9628-4455-9a2f-60f52f4c6930) {% content-ref url="integration-feishu/ones-connector" %} [ones-connector](https://guides-ones.gitbook.io/guides/usage-guide/tuan-dui-pei-zhi-guan-li/dan-tuan-dui/zhang-hao-yu-cheng-yuan/integration-feishu/ones-connector) {% endcontent-ref %} ### 2.2 私有部署/高可用部署版系统 ① 私有部署或高可用部署版本系统用户，需要通过创建飞书自建应用的方式实现 ONES 与飞书的集成。 飞书自建应用创建指南： ② 在系统【团队配置中心】（多团队下【组织管理】）> 【第三方帐号】> 点击【飞书】。 ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-MGHeAPXg25N6zTChrFd%2F-MGHgWPp88WdUQhBealI%2Fimage.png?alt=media\&token=38032331-c187-4da1-8ea1-67776eba406e) ③ 在新打开的配置页面，将你创建的飞书自建应用信息：App ID、App Secret；以及订阅时间配置信息：Encrypt Key、Verification Token，填写到对应输入框中。 ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-MGHeAPXg25N6zTChrFd%2F-MGHhF15dNxdTuHe_u0a%2Fimage.png?alt=media\&token=5cd34c48-de9a-44d8-8bc5-16a1827d9d9e) ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-MGHiZpmMq1upwmnqd74%2F-MGHjmJUAnelKjOVo18i%2Fimage.png?alt=media\&token=70384226-11f0-4597-87ce-48ddcd0e156f) ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-MGHiZpmMq1upwmnqd74%2F-MGHk7P6RtS-hwEfdQfS%2Fimage.png?alt=media\&token=62c2b6c3-1093-4ee2-b1ec-0bc5e4a5f029) 并且确认已经在你的飞书自建应用中开启「机器人」能力。 ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-MGHeAPXg25N6zTChrFd%2F-MGHhzDjsC5x9pOWzNrd%2Fimage.png?alt=media\&token=2b15e6d6-4d2c-4fed-9e3f-a431c9cfb1d9) ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-MGHiZpmMq1upwmnqd74%2F-MGHkITwL4biU1UjDdNS%2Fimage.png?alt=media\&token=b5b95abe-eb18-41fa-8978-35d7efdecba6) 确认完成以上设置后，即可点击「下一步」。系统将检查设置内容，如出现报错请检查你填写信息是否有误或未打开「机器人」能力。 ④-1 网页配置。在你的飞书自建应用中「启用网页」，并且把 ONES 系统提供的「桌面端/移动端主页」URL 复制并粘贴到飞书应用“桌面端主页”，“移动端主页”中 ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-MGHiZpmMq1upwmnqd74%2F-MGHlG9-UbYz-rdobfDx%2Fimage.png?alt=media\&token=2eb0e5df-c24f-4e1c-8573-82109ecc7de5) ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-MGHiZpmMq1upwmnqd74%2F-MGHlWBiNt80MeMhYIJa%2Fimage.png?alt=media\&token=abb85369-cec6-4be2-b137-21ee6ca5b6f0) ④-2 安全设置。通过复制粘贴将ONES 系统提供的3个重定向URL添加到飞书自建应用“安全设置-重定向 URL”中。 ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-MGHiZpmMq1upwmnqd74%2F-MGHnIjdxdzg7LkrbHgM%2Fimage.png?alt=media\&token=a010badd-4b5c-4a21-80d3-acdd39ac78d2) ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-MGHiZpmMq1upwmnqd74%2F-MGHnP8JoHAAuqSGCOA5%2Fimage.png?alt=media\&token=5d850ad2-5615-4a6c-9b47-4e7ca00f2d5c) ④-3 请求网址设置。通过复制粘贴将ONES 系统提供的请求网址 URL 添加到飞书自建应用“请求网址”中。 ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-MGHiZpmMq1upwmnqd74%2F-MGHoH9HsFSVfpsyOYca%2Fimage.png?alt=media\&token=d9cf7612-8902-4d10-a837-b0ea5a91a3da) ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-MGHiZpmMq1upwmnqd74%2F-MGHpM6GDbU3ueouhcxw%2Fimage.png?alt=media\&token=aaa2e490-1fc6-4695-99bf-f3cfd0757858) 确认将「接收消息」、「用户和机器人的会话首次被创建」2个事件添加到订阅事件中。 ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-MGHqmxtNHCZROUWYRjH%2F-MGHr5nzCxehdQIZiOSc%2Fimage.png?alt=media\&token=cfc5320e-c9d3-415a-af34-76128cbbaf80) ④-4 权限配置。根据界面中的引导将列出的权限添加到飞书自建应用权限配置中。 ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-MGHqmxtNHCZROUWYRjH%2F-MGHrTHWB63f6H3AhT38%2Fimage.png?alt=media\&token=a5fdcc51-cad6-4949-8aba-6737998e3eaf) ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-MGHqmxtNHCZROUWYRjH%2F-MGHs40smcXcIX7W2DwB%2Fimage.png?alt=media\&token=cd9ec782-cfa1-4a5c-8210-269137cdd34e) 完成以上配置后，点击「提交配置」按钮。 ⑤ 发布自建应用。在ONES 系统完成配置后，你需要发布飞书自建应用。\ 发布自建应用指南： ⑥ 绑定用户。为实现 ONES 消息通知到飞书对应用户，需要团队成员各自完成 ONES 帐号与飞书帐号绑定。发布自建应用后，通知你的同事在飞书应用中搜索自建应用。 ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-MGHuTEbhtLNzMuYnJ-P%2F-MGHvSMd66C0grDhK2QS%2Fimage.png?alt=media\&token=e46efdc3-27eb-444a-8dc4-252eb0cb91af) 点击进入应用后，系统将自动发送帐号绑定通知，点击通知中「绑定帐号」按钮。如果没有收到绑定通知，可以在应用对话框中输入：「绑定账号」，机器人将回复绑定通知。 ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-MGHuTEbhtLNzMuYnJ-P%2F-MGHxzeniTaeGTXXPQpP%2Fimage.png?alt=media\&token=56b8e76c-7bff-4622-91ed-bbe892c215a6) 系统将自动打开浏览器展示扫码绑定页面。 ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-MGHuTEbhtLNzMuYnJ-P%2F-MGHyOFS2cjKl0MAWP3q%2Fimage.png?alt=media\&token=08b65e85-f56d-4ba0-b455-4833f70b91e8) 扫码登录后即可确认帐号绑定。 ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-MGHuTEbhtLNzMuYnJ-P%2F-MGHyfRWJ2Fx-vVaoZo2%2Fimage.png?alt=media\&token=bc714992-3063-4f58-b603-5fcbb7e84407) ⑦ 开启飞书通知方式。 单个手动开启：手动在系统中各需要通知到飞书的设置中勾选「飞书」渠道（下面以项目-工作项类-工作项通知 为例）。 ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-MGHuTEbhtLNzMuYnJ-P%2F-MGHzauf3jqtrmSt3YFq%2Fimage.png?alt=media\&token=77cb7f1c-2f57-48fb-9413-94d6d831c4cd) 批量开启开启：在「飞书」配置成功页面，点击「批量添加飞书通知」按钮。 ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-MGHuTEbhtLNzMuYnJ-P%2F-MGHztYIz9ebW8dMTs5f%2Fimage.png?alt=media\&token=2d713f6a-3d63-4826-a10b-74886621a0d0) 在确认弹窗中点击「确定」，即可批量在全系统「工作项通知」、「工作项提醒」、「后置动作发送通知」设置中勾选「飞书」通知渠道。 ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-MGHuTEbhtLNzMuYnJ-P%2F-MGI-84lFmikP-GSK3uZ%2Fimage.png?alt=media\&token=c3eaf500-fb38-4982-bf0f-7150db92c3a9) ⑧ 通知效果。当系统中有新消息时，将通过飞书同步通知到对应用户。 ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-MGI0tJWc9B6_ZhI9ZzD%2F-MGI1rIiXracTYyaPf35%2Fimage.png?alt=media\&token=ed25944f-5118-4834-ba4c-602201675ad9) ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-MGI0tJWc9B6_ZhI9ZzD%2F-MGI1w2fSWs6vZSY6J6n%2Fimage.png?alt=media\&token=0df08700-f744-4696-91bd-54265bac087d) 并且，在飞书通知中点击「详情」，可免登打开对应详情页面。 ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-MGI0tJWc9B6_ZhI9ZzD%2F-MGI2tT4Ha2F0dV3JPSr%2Fimage.png?alt=media\&token=51626d1b-0a45-47ec-b2a8-7f0b0cd28c7f)