# 微信私聊接入

通过 iLink 扫码连接微信私聊，验证用户配对与文本回复。

## 本页只接入微信私聊

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

先准备能在 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 和会话。

配对后重新发送测试。

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

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

## 换账号或重新登录

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

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

## 区分三种没有回复

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

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