# 外部消息配对

将外部用户或群绑定到指定 Agent 与会话。

## 配对决定消息交给谁

频道负责连接外部聊天平台；配对负责把具体外部用户或群绑定到 Nexus 的 Agent 与会话。只有频道在线，不足以保证消息进入正确工作上下文。

消息处理需要频道连接、配对关系、Agent 与会话均有效，并具备任务所需权限。

## 建立配对

1. 先完成[IM 通道](/docs/channels)的账号连接。
2. 从自己的测试私聊或测试群发送一条普通消息。
3. 打开 **能力 → 配对**，查看待处理关系；需要时使用页面提供的手动添加入口。
4. 核对外部平台、用户或群，再选择应负责的 Agent 与会话。
5. 确认后再发送一条测试消息，检查 Nexus 与外部聊天两边的记录。

绑定前先核对对象，避免把一个群的请求送进另一个客户或项目的会话。测试消息不应包含凭据或敏感材料。

## 变更已有关系

更换负责人或会话时，先明确新的消息应进入哪里，再修改配对并验证。修改绑定影响后续消息的去向；已有会话内容不会因此自动迁移。

相关 Agent 或会话被删除后，检查配对是否仍指向有效资源。重复创建 Agent 不能自动修复原有绑定。

## 外部审批与定时结果

来自外部聊天的权限确认只对准确配对的那段对话有效，不因为同一个平台账号下还有其他群聊就自动共享。

[定时任务](/docs/automations)向外部发送结果时，也需要可用频道与正确配对。运行成功但送达失败，应先检查接收位置并重试送达，避免重新执行整项工作造成重复写入。

## 频道在线但无人处理

依次检查是否存在待确认配对、外部用户或群是否匹配、Agent 和会话是否有效，以及任务是否等待审批。这些配置无误时，再查看通道日志。