# 飞书消息发送配置

配置飞书企业自建应用并在 MOI 创建消息发送实例后，智能体可以通过该应用向飞书发送消息。

## 准备飞书应用

需要一个有权创建或管理企业自建应用的飞书账号。没有相应权限时，请由飞书管理员创建应用并提供凭据。

### 1. 创建应用并添加机器人

登录[飞书开放平台](https://open.feishu.cn/app)，点击 **创建企业自建应用**，填写名称、描述和图标。已有应用可直接打开。

```{figure} /assets/images/agents/guide-5-hd/feishu-create-app-reference.png
:alt: 飞书开放平台的创建企业自建应用入口。
:class: agent-guide-image
:figclass: agent-guide-shot

创建企业自建应用。
```

进入 **添加应用能力**，在 **机器人** 卡片中点击 **添加**。

```{figure} /assets/images/agents/guide-5-hd/feishu-add-bot-reference.png
:alt: 飞书应用的添加应用能力页面，机器人卡片中有添加按钮。
:class: agent-guide-image
:figclass: agent-guide-shot

为应用添加机器人能力。
```

### 2. 获取应用凭据

在 **凭证与基础信息** 中复制 **App ID** 和 **App Secret**。

```{figure} /assets/images/agents/guide-5-hd/feishu-app-credentials.png
:alt: 飞书开放平台的凭证与基础信息页面，显示 App ID 与 App Secret。
:class: agent-guide-image
:figclass: agent-guide-shot

复制同一个飞书应用的 App ID 和 App Secret。
```

在 **事件与回调 > 加密策略** 中复制 **Verification Token**。当前 MOI 消息发送表单要求填写该字段。

```{figure} /assets/images/agents/guide-5-hd/feishu-event-encryption.png
:alt: 飞书开放平台的事件与回调页面，显示 Verification Token 和 Encrypt Key。
:class: agent-guide-image
:figclass: agent-guide-shot

复制 Verification Token。
```

### 3. 配置权限并发布应用

在 **权限管理** 中申请发送消息所需权限。以[飞书发送消息接口说明](https://open.feishu.cn/document/server-docs/im-v1/message/create)列出的权限为准。

在 **版本管理与发布** 中创建并发布版本，确认测试用户在应用可用范围内。新增权限后，按飞书页面提示重新发布。

## 在 MOI 创建消息发送实例

1. 打开 **资源中心 > 工具库 > 飞书**。
2. 点击 **新增 > 消息发送**。
3. 填写来自同一个飞书应用的 App ID、App Secret 和 Verification Token。

```{figure} /assets/images/agents/guide-5-hd/feishu-moi-message-form.png
:alt: MOI 飞书消息发送实例表单，包含 App ID、App Secret 和 Verification Token。
:class: agent-guide-image
:figclass: agent-guide-shot

填写飞书消息发送实例。
```

| MOI 字段 | 填写内容 |
| --- | --- |
| 工具实例名称 | 自行命名，例如“团队飞书消息”。 |
| 描述 | 可不填；用于说明实例的发送范围。 |
| App ID | 飞书应用的 App ID。 |
| App Secret | 与 App ID 属于同一个应用的 App Secret。 |
| Verification Token | 同一个应用 **事件与回调 > 加密策略** 中的 Verification Token。 |
| 连接超时（秒） | 可留空，系统默认 30 秒。 |

4. 点击 **保存**，然后测试连接。
5. 将实例绑定到目标智能体，要求智能体向测试用户或测试群发送一条消息，并在飞书中确认收到消息。

## 常见问题

| 现象 | 检查方法 |
| --- | --- |
| 应用认证失败 | 确认 App ID、App Secret 和 Verification Token 来自同一个应用。 |
| 消息发送失败 | 检查应用权限、应用发布状态、可用范围，以及机器人是否已加入目标群。 |
| 保存后无法调用 | 确认智能体绑定的是刚创建并测试通过的消息发送实例。 |

- [返回飞书配置指南](../feishu.md)