飞书消息发送配置¶
配置飞书企业自建应用并在 MOI 创建消息发送实例后，智能体可以通过该应用向飞书发送消息。
准备飞书应用¶
需要一个有权创建或管理企业自建应用的飞书账号。没有相应权限时，请由飞书管理员创建应用并提供凭据。
1. 创建应用并添加机器人¶
登录飞书开放平台，点击 创建企业自建应用，填写名称、描述和图标。已有应用可直接打开。
创建企业自建应用。¶
进入 添加应用能力，在 机器人 卡片中点击 添加。
为应用添加机器人能力。¶
2. 获取应用凭据¶
在 凭证与基础信息 中复制 App ID 和 App Secret。
复制同一个飞书应用的 App ID 和 App Secret。¶
在 事件与回调 > 加密策略 中复制 Verification Token。当前 MOI 消息发送表单要求填写该字段。
复制 Verification Token。¶
3. 配置权限并发布应用¶
在 权限管理 中申请发送消息所需权限。以飞书发送消息接口说明列出的权限为准。
在 版本管理与发布 中创建并发布版本，确认测试用户在应用可用范围内。新增权限后，按飞书页面提示重新发布。
在 MOI 创建消息发送实例¶
打开 资源中心 > 工具库 > 飞书。
点击 新增 > 消息发送。
填写来自同一个飞书应用的 App ID、App Secret 和 Verification Token。
填写飞书消息发送实例。¶
MOI 字段 |
填写内容 |
|---|---|
工具实例名称 |
自行命名，例如“团队飞书消息”。 |
描述 |
可不填；用于说明实例的发送范围。 |
App ID |
飞书应用的 App ID。 |
App Secret |
与 App ID 属于同一个应用的 App Secret。 |
Verification Token |
同一个应用 事件与回调 > 加密策略 中的 Verification Token。 |
连接超时（秒） |
可留空，系统默认 30 秒。 |
点击 保存，然后测试连接。
将实例绑定到目标智能体，要求智能体向测试用户或测试群发送一条消息，并在飞书中确认收到消息。
常见问题¶
现象 |
检查方法 |
|---|---|
应用认证失败 |
确认 App ID、App Secret 和 Verification Token 来自同一个应用。 |
消息发送失败 |
检查应用权限、应用发布状态、可用范围，以及机器人是否已加入目标群。 |
保存后无法调用 |
确认智能体绑定的是刚创建并测试通过的消息发送实例。 |