微信私聊接入

本页只接入微信私聊

当前 Nexus 使用 iLink Bot 扫码登录，通过长轮询接收微信私聊并回投文本，不支持微信群。需要团队群消息时，使用另行配置的企业微信通道。

先准备能在 Nexus 内正常回答的 Agent，再打开 能力 → 频道 → 微信。扫码账号、Nexus 登录账号和接收任务的 Agent 分别承担不同作用，开始前核对当前用户。

扫码登录

1. 在微信通道中生成登录二维码。
2. 使用准备连接的微信账号扫描，并在手机上完成确认。
3. 返回 Nexus 等待结果，核对连接账号和状态。
4. 确认完成后再进行私聊测试。

扫码页面显示成功但 Nexus 结果尚未确认时，先刷新连接状态。二维码过期则使用页面重新生成，不通过复制内部账号令牌恢复登录。

通常保留的连接字段

字段	用途
iLink API Base URL	默认 https://ilinkai.weixin.qq.com
Bot Agent	请求使用的客户端标识，保留页面值
iLink App ID	默认 bot
iLink Client Version	保留当前产品提供的版本值

普通扫码接入无需逐个猜测这些字段。Nexus 在登录后保存账号令牌；手动改版本号不会代替一次有效登录。

给私聊用户配对

从准备测试的外部用户向已连接账号发送一条文本。打开 能力 → 配对，找到该私聊用户，选择负责接收的 Agent 和会话。

配对后重新发送测试。

这是微信私聊测试。请只回复“私聊连接正常”。

在 Nexus 检查该请求进入的会话，并在微信原私聊查看回复。首次验证使用文本，不以语音、图片或文件传输推断尚未验证的能力。

换账号或重新登录

先确认旧账号是否还有需要保留的任务结果，再通过通道提供的登录流程连接目标账号。账号变更后重新核对私聊身份与配对，不把旧账号的关系当成新账号已经完成的授权。

重新登录解决账号连接问题，模型错误和任务审批仍要在 Nexus 对应会话处理。

区分三种没有回复

看到的情况	下一步
通道未登录或离线	检查宿主网络与登录状态，必要时重新扫码
通道在线，Nexus 没出现请求	确认是支持的私聊，并检查用户配对
请求已出现但没有结果	检查 Agent 模型、待答问题与审批

如果 Nexus 已经生成结果，再查看通道发送错误和微信原私聊。确认未送达后再处理重试，避免重复执行已有文件任务。长期收发需要保持运行 Nexus 的设备在线。