消息渠道¶
消息渠道用于将 Agent 接入微信、企业微信、钉钉、飞书等外部消息平台。接入后，团队可以在已有群聊或私聊中向 Agent 提问、发起协作，也可以把自动化和任务接入的结果投递到指定会话。
适用场景¶
- 在研发、运维、值班或项目群中直接向 Agent 提问；
- 在告警、故障排查或变更跟进时，让 Agent 补充分析和建议；
- 将日报、巡检结果、风险清单或分析报告投递到固定会话；
- 为不同 Agent 使用不同账号或群聊，明确职责和协作范围。
支持的平台¶
可接入的平台取决于当前产品版本：
| 产品 | 支持的消息渠道 |
|---|---|
| Obsy | 微信、企业微信、钉钉、飞书 |
| TrueWatch | Lark、Slack、Microsoft Teams、Telegram |
页面只会展示当前产品支持的平台。飞书与 Lark 是面向不同产品版本的独立入口，请按页面实际显示的平台进行配置。
推荐使用流程¶
flowchart LR
A[准备外部消息平台账号或应用] --> B[为 Agent 新建消息渠道]
B --> C[启用消息渠道]
C --> D[在目标群聊或私聊中<br/>向 Agent 发送消息]
D --> E[建立或复用消息渠道会话]
E --> F[在消息平台中继续协作]
E --> G[在自动化或任务接入中<br/>选择一个或多个会话]新建并启用消息渠道，只是完成 Agent 与外部账号的连接。在目标群聊或私聊中向 Agent 发送消息后，系统才会建立或复用可供自动化、任务接入选择的消息渠道会话。
新建消息渠道¶
- 进入目标 Agent 的工作台，打开消息渠道；
- 点击新建消息渠道；
- 选择页面提供的平台；
- 按页面要求填写平台凭证，或使用扫码登录完成授权；
- 保存后，在列表中确认连接状态；
- 如消息渠道尚未启用，点击启用消息渠道。
不同平台的准备方式请参考：
微信使用页面提供的扫码方式登录，扫码后页面会自动检查结果，无需再次手动确认。
设置微信消息渠道别名¶
微信接入返回的默认名称有时不便识别。接入完成后，可以为消息渠道设置展示别名：
- 在消息渠道列表中找到目标微信渠道；
- 打开该渠道的更多操作，选择编辑消息渠道别名；
- 输入便于团队识别的名称并保存。
别名最多 50 个字符，只用于页面展示和会话选择，不会改变微信账号、消息路由或原有连接配置。清空别名并保存，可以恢复系统默认名称。设置后，任务接入等选择消息渠道会话的位置会优先显示该别名。
准备用于结果投递的消息渠道会话¶
自动化和任务接入选择的是具体群聊或私聊对应的消息渠道会话，不是消息渠道配置本身。
如需将结果投递到某个会话，请先确认消息渠道已启用，然后在目标群聊中添加并 @ 机器人发送一条消息，或向机器人发送一条私聊消息。返回自动化或任务接入页面并刷新，即可选择该会话。
一个消息渠道可以对应多个会话。结果只会发送到您选中的一个或多个会话，不会自动广播到同一消息渠道下的其他群聊或私聊。
如果选择列表为空或找不到目标会话，请检查：
- 消息渠道是否已启用且状态正常；
- 目标群聊或私聊是否已经向 Agent 发送过消息；
- 当前配置是否属于同一个 Agent；
- 页面是否已刷新或重新打开。
管理凭证和账号¶
消息渠道凭证保存后不能直接编辑。如需更换凭证，请点击新建消息渠道重新填写；如果系统识别为当前 Agent 已接入的同一账号，确认更新后会替换当前连接配置，不会创建重复连接，也不会影响其他 Agent。也可以先删除旧连接，再重新接入。
同一个消息渠道账号同一时间只应由一个 Agent 使用。如果该账号已经接入其他 Agent，继续接入会让原 Agent 的连接失效，原 Agent 将无法再通过该账号收发消息。要恢复原 Agent，可以在原 Agent 中重新接入该账号；如果两个 Agent 都需要长期使用消息渠道，应分别准备不同账号。
确认账号覆盖影响
页面提示账号已被其他 Agent 使用时，请先确认原 Agent 是否仍需通过该账号工作。不要在未通知相关负责人的情况下直接覆盖生产或值班账号。
管理已接入消息渠道¶
列表会展示平台、账号和当前状态。根据状态和当前账号权限，可以执行以下操作：
- 启用消息渠道：让 Agent 开始通过该账号收发消息；
- 停用消息渠道：暂时停止该账号与 Agent 的消息交互，配置仍会保留；
- 编辑消息渠道别名：为微信渠道设置更容易识别的展示名称；
- 删除：移除当前 Agent 与该账号的连接；
- 重试：仅在页面加载或连接操作失败且页面提供该入口时使用。
被其他 Agent 覆盖而失效的连接不能再次启用，需要删除，或按前文方式重新接入账号。
只有具备 Agent 管理权限的成员可以新建、启用、停用、编辑别名或删除消息渠道；其他成员只能查看。
最佳实践¶
- 让消息渠道所连接的群聊、账号与 Agent 职责相匹配；
- 不同职责或不同环境的 Agent 尽量使用不同账号，避免相互覆盖；
- 先在测试群验证消息收发和结果投递，再用于生产值班群；
- 只向确有需要的群聊投递自动化结果，避免消息噪声；
- 不要在群聊、邮件、工单或未授权文档中发送密钥、Token 或应用凭证；
- 停用前确认是否仍有自动化或任务接入向相关会话投递结果。