企业微信集成

企业微信集成通过 WebSocket 长连接将企业微信智能机器人（aibot）接入 Mopheus。配置完成后，智能体实时响应企微消息，工单状态变更和评论将推回企微对话。

配置

1. 扫码接入机器人（推荐）

1. 在 Mopheus 中，进入智能体或团队详情页 → 集成 标签 → 连接企业微信机器人。
2. 选择 扫码接入，使用企业微信扫描显示的二维码，并在企业微信中完成创建与授权。
3. 扫码成功后，Mopheus 会在服务端获取 Bot ID 和 Secret，并加密保存到所选的智能体或团队。凭据不会返回到浏览器。

安装入口要求当前成员拥有 channel:bind 权限；将机器人安装到自己以外的智能体或团队时，也会按工作区的归属规则校验。

2. 手动填写凭据

1. 进入企业微信管理后台 → 应用管理 → 智能机器人。
2. 创建一个新的智能机器人。记录创建时显示的 Bot ID 和 Secret。
3. 在 Mopheus 中，进入智能体或团队详情页 → 集成 标签 → 连接企业微信机器人，选择 手动填写。
4. 填写 Bot ID 和 Secret。可选设置自定义 WebSocket 地址（默认 wss://openws.work.weixin.qq.com）。

3. 配置 Mopheus

在 管理后台 → 系统配置 中设置：

配置机器人凭据后，不要通过通用配置编辑器修改企业微信密钥。系统配置中的 生成 会在一个事务中轮换密钥并重加密全部已有企业微信绑定。

验证集成前，请在企业微信管理后台配置机器人的可见范围或可用成员、部门。连接机器人不会自动授权所有企业微信用户。超出机器人可用范围的发送者可能会被企业微信直接拒绝，消息不会到达 Mopheus。

4. 验证

向企微中的机器人发送任意消息。每位企业微信发送者首次发送消息时，机器人会返回一次性 Mopheus 账号绑定链接。登录并确认绑定后，再次发送消息即可路由到关联的智能体，智能体的回复会自动推回企业微信对话。

绑定粒度为“企业微信发送者 + 机器人安装记录”。连接机器人的人首次使用该机器人时也需要完成绑定；企业微信在安装时不会向 Mopheus 提供安装者的企业微信用户标识。

企业微信机器人的可用范围和 Mopheus 账号绑定是两个独立条件：发送者既要位于机器人的可用范围内，也要完成一次性 Mopheus 账号绑定。

集成区域会显示每个机器人绑定对应的 Mopheus 工作区安装人。

工作原理

入站：企业微信 → Mopheus

企微用户向智能机器人发消息
        │
        ▼
WebSocket aibot_msg_callback 事件
        │
        ▼
Mopheus channel engine 接收并路由
        │
        ▼
创建会话 → 智能体任务入队
        │
        ▼
智能体运行，产生回复
        │
        ▼
Patcher 通过 aibot_send_msg 推回企微

出站：Mopheus → 企业微信

Patcher 组件通过共享的 WebSocket 连接处理所有出站消息。

所有出站消息以 msgtype: markdown 发送，纯文本通过 markdown 路径正常渲染。消息按 rune 安全截断到 4000 字节。

单副本约束

企业微信每个机器人仅允许一个活跃的 WebSocket 连接。Mopheus 通过 channel supervisor lease 机制强制单副本。若需水平扩展，请先配置 Redis Streams 中继（独立功能）。

消息历史

智能机器人长连接只接收机器人收到后的实时事件。当前集成不拉取普通群聊的历史消息；企业微信会话内容存档属于独立的合规能力，未包含在智能机器人连接配置中。

故障排除