# 集成飞书

## 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)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET 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?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.