# 企业微信接入

绑定企业微信智能机器人，检查长连接、成员与群配对。

## 使用智能机器人长连接

当前 Nexus 接入的是企业微信智能机器人，使用 Bot ID、Secret 和长连接收发成员或群消息。企业应用的 Corp ID、群 Webhook 地址属于其他接入方式，不能填进这套表单。

准备可管理智能机器人的企业微信账号，并先确认目标 Agent 在 Nexus 内能正常回答。

## 扫码绑定已有机器人

打开 **能力 → 频道 → 企业微信**，通过扫码入口完成绑定。手机端确认后返回 Nexus，检查绑定的机器人与连接状态。

有权登录企业微信不等于有权配置所有机器人。授权页面不提供目标机器人时，先确认账号所属企业与管理范围，不要通过更换 Nexus 模型尝试解决。

## 手工填写凭据

使用已有机器人时，将同一机器人的两项凭据填入表单。

| 字段 | 内容 |
| --- | --- |
| Bot ID | 智能机器人标识 |
| Secret | 对应机器人的密钥 |
| Long Connection URL | 默认 `wss://openws.work.weixin.qq.com` |

保留默认长连接地址。它是 WebSocket 地址，不能替换成普通群机器人的 HTTP Webhook。平台配置入口以[企业微信开发者文档](https://developer.work.weixin.qq.com/)为准。

保存后查看连接结果，核对机器人是否对测试成员可用。长连接由 Nexus 维持，宿主退出会影响收发。

## 配对成员并测试

从企业微信向机器人发送一条文本，在 Nexus **能力 → 配对** 中找到对应成员，绑定到测试 Agent 和会话。

```text
这是企业微信机器人测试，请只回复“已收到企业微信测试”。
```

配对完成后重新发送，检查 Nexus 会话收到请求，企业微信原会话收到结果。回复使用平台原生流式能力，最终结果仍应以实际收到的消息为准。

## 扩展到群聊

将机器人用于目标测试群，确认群成员可使用该机器人。检查该群在 Nexus 中的配对及接收 Agent，随后在群里完成同样的文本测试。

成员私聊成功只证明那条私聊链路可用。群聊的可用范围、配对和发送目标需要分别核对。

## 连接失败与回复失败

| 情况 | 处理 |
| --- | --- |
| 长连接无法建立 | 核对 Bot ID 与 Secret 是否匹配、端点及出站网络 |
| 扫码后仍待确认 | 刷新机器人连接状态，不重复提交旧二维码 |
| 机器人可见但无请求 | 检查当前成员或群的可用范围与配对 |
| Nexus 中已出现请求 | 转到目标会话处理模型或审批问题 |
| 结果已完成但未送达 | 检查原聊天与平台发送错误，再决定重试 |

Secret 轮换后同步更新 Nexus，并用新消息重新验证。更换机器人时重新核对成员和群关系，避免把任务送给旧的绑定目标。