> For the complete documentation index, see [llms.txt](https://guides-ones.gitbook.io/guides/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guides-ones.gitbook.io/guides/usage-guide/tuan-dui-pei-zhi-guan-li/dan-tuan-dui/zhang-hao-yu-cheng-yuan/integration-feishu.md).

# 集成飞书

## 1. 集成能力

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

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

1. ONES 系统用户与飞书用户绑定；
2. ONES 系统消息通知到飞书效果；
3. 飞书通知打开 ONES 对应详情页面。

## 2. 使用说明

### 2.1 公有云版系统

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

![](/files/-MGDCoKjgk7CSn6nMsV3)

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

![](/files/-MGDGjGhtdf18GR2ylU1)

{% content-ref url="/pages/-MGDGqZyh9KaiDE9X5jR" %}
[飞书「ONES 助手」启用与配置说明](/guides/usage-guide/tuan-dui-pei-zhi-guan-li/dan-tuan-dui/zhang-hao-yu-cheng-yuan/integration-feishu/ones-connector.md)
{% endcontent-ref %}

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

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

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

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

![](/files/-MGHgWPp88WdUQhBealI)

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

![](/files/-MGHhF15dNxdTuHe_u0a)

![](/files/-MGHjmJUAnelKjOVo18i)

![](/files/-MGHk7P6RtS-hwEfdQfS)

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

![](/files/-MGHhzDjsC5x9pOWzNrd)

![](/files/-MGHkITwL4biU1UjDdNS)

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

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

![](/files/-MGHlG9-UbYz-rdobfDx)

![](/files/-MGHlWBiNt80MeMhYIJa)

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

![](/files/-MGHnIjdxdzg7LkrbHgM)

![](/files/-MGHnP8JoHAAuqSGCOA5)

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

![](/files/-MGHoH9HsFSVfpsyOYca)

![](/files/-MGHpM6GDbU3ueouhcxw)

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

![](/files/-MGHr5nzCxehdQIZiOSc)

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

![](/files/-MGHrTHWB63f6H3AhT38)

![](/files/-MGHs40smcXcIX7W2DwB)

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

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

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

![](/files/-MGHvSMd66C0grDhK2QS)

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

![](/files/-MGHxzeniTaeGTXXPQpP)

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

![](/files/-MGHyOFS2cjKl0MAWP3q)

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

![](/files/-MGHyfRWJ2Fx-vVaoZo2)

⑦ 开启飞书通知方式。

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

![](/files/-MGHzauf3jqtrmSt3YFq)

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

![](/files/-MGHztYIz9ebW8dMTs5f)

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

![](/files/-MGI-84lFmikP-GSK3uZ)

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

![](/files/-MGI1rIiXracTYyaPf35)

![](/files/-MGI1w2fSWs6vZSY6J6n)

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

![](/files/-MGI2tT4Ha2F0dV3JPSr)