企业微信消息渠道配置¶
企业微信消息渠道用于将 Agent 接入企业微信智能机器人。配置完成后，团队可以在企业微信私聊或群聊中与 Agent 协作，也可以将自动化或任务接入结果投递到已建立的会话。
接入方式¶
Agent Teams 通过企业微信智能机器人的 API 模式接入，并使用长连接接收和发送消息。长连接通过 WebSocket 建立，配置时需要以下凭证：
| 凭证 | 说明 |
|---|---|
Bot ID |
企业微信智能机器人的唯一标识。 |
Secret |
长连接专用密钥，用于连接鉴权。获取后请立即妥善保存。 |
配置企业微信智能机器人¶
打开需要接入的智能机器人配置页面，完成以下设置：
- 确认机器人使用 API 模式；
- 在 API 配置区域选择使用长连接；
- 复制
Bot ID，点击点击获取生成Secret，并妥善保存这两个凭证； - 展开可使用权限，为消息分类完成授权，并确认机器人具备下表中的权限；
- 保存机器人配置。
| 权限分类 | 必备权限 | 用途 |
|---|---|---|
| 用户信息 | 获取对话用户 userid |
识别消息发送者。该权限通常为默认授权。 |
| 消息 | 获取会话列表、获取会话消息、发送消息 | 读取会话及消息，并将 Agent 的回复发送回企业微信。 |
请确认上述权限均已授权。
配置 Agent 消息渠道¶
- 进入目标 Agent 的消息渠道页面；
- 点击新建消息渠道，选择企业微信；
- 填写企业微信侧获取的
Bot ID和Secret，然后保存； - 启用消息渠道，返回 Agent 工作台确认连接状态；
- 在需要使用 Agent 或接收任务结果的企业微信会话中向机器人发送一条消息，验证机器人能够正常回复；
- 如需投递自动化或任务接入结果，在对应配置中选择已经建立的消息渠道会话。
保存前检查凭证
Bot ID 和 Secret 保存后不能直接编辑。如需修改同一机器人的凭证，请重新接入企业微信。系统识别到该企业微信机器人账号已接入当前 Agent 时，会提示更新当前连接；确认后将覆盖这条连接的配置，不会新增重复连接，也不会影响其他 Agent。
如果会话没有出现在投递目标中，请先确认消息渠道已经启用，并在目标群聊中向机器人发送过消息，然后刷新配置页面。更多说明请参考准备用于结果投递的消息渠道会话。
常见问题¶
长连接失败¶
请依次检查：
- 企业微信侧是否已选择使用长连接；
Bot ID和Secret是否填写正确，复制时是否带入多余空格；Secret是否仍然有效；如已重新获取Secret，需使用新凭证重新接入企业微信消息渠道；- Agent 消息渠道是否已经启用，运行环境能否正常访问企业微信服务。
机器人收到消息但没有回复¶
请确认机器人已获得获取会话消息和发送消息权限，并检查 Agent 工作台中的渠道连接状态。如在群聊中使用，请按照企业微信客户端的提示 @ 机器人后发送消息。