飞书消息渠道配置¶
飞书消息渠道用于将 Agent 接入飞书群聊或私聊会话。配置完成后，团队可以在飞书中直接与 Agent 协作，也可以将自动化任务结果推送到指定群聊。
接入方式¶
Agent Teams 使用飞书开放平台的长连接接收消息事件，并通过应用机器人发送回复。配置时需要以下凭证：
| 凭证 | 说明 |
|---|---|
App ID |
飞书应用的唯一标识。 |
App Secret |
飞书应用的密钥，用于连接鉴权。 |
配置飞书应用¶
进入 飞书开放平台中需要接入的企业自建应用，完成以下设置：
- 在应用能力中确认已添加机器人能力；
- 进入权限管理，开通下表中的消息相关权限；
- 在凭证与基础信息中复制
App ID和App Secret； - 进入目标 Agent 的消息渠道页面，点击新建消息渠道并选择飞书，填写
App ID和App Secret后保存并启用； - 返回飞书开放平台的事件与回调页面，选择使用长连接接收事件；
- 在事件配置中添加接收消息事件
im.message.receive_v1； - 创建并发布应用版本。
| 权限 | 用途 |
|---|---|
contact:contact.base:readonly |
获取消息发送者的基础信息。 |
im:chat:read |
获取群聊信息。 |
im:message.group_at_msg:readonly |
接收群聊中 @ 机器人的消息。 |
im:message.p2p_msg:readonly |
接收用户发送给机器人的私聊消息。 |
im:message:readonly |
读取消息内容。 |
im:message:send_as_bot |
以机器人身份回复消息。 |
im:resource |
获取消息中的图片、文件等资源。 |
验证连接¶
- 返回 Agent 工作台确认飞书消息渠道的连接状态；
- 在飞书群中
@机器人发送一条消息，或在私聊中直接向机器人发送消息； - 确认 Agent 能够接收消息并返回回复。
完成连接后，还需要在希望接收推送的群聊中 @ 机器人发送一条消息，或向机器人发送一条私聊消息，系统才会建立该对话对应的消息渠道会话。只有已建立的会话，才会出现在自动化或任务接入的消息渠道投递选择列表中。更多说明请参考准备用于结果投递的消息渠道会话。
保存前检查凭证
App ID 和 App Secret 保存后不能直接编辑。如需更换，请在 Agent 的消息渠道页面重新接入飞书；系统识别为同一账号时，按提示确认更新当前连接。
常见问题¶
长连接未建立¶
请确认消息渠道已启用，并检查 App ID 和 App Secret 是否填写正确。飞书开放平台的事件订阅页面应选择使用长连接接收事件，且连接状态正常。
机器人未收到消息¶
请确认应用已发布、机器人能力已启用、消息相关权限均已开通，并已订阅接收消息事件 im.message.receive_v1。群聊中需要 @ 机器人后再发送消息。