企微助理集成

两种接入方式

长连接（智能机器人）：扫码后由平台创建机器人并回填凭证；桌面端仅支持此方式。HTTP 回调（自建应用）：须在企业微信管理后台创建应用，并在网页端「频道」页填写五项凭证。

扫码接入（推荐）

1. 确认手机端登录的是企业微信管理员账号；普通成员无法完成扫码接入。
2. 桌面端「设置 → 助理设置 → 集成（Beta）」→「企微助理集成」→「配置」→「扫码接入」；网页端则是「频道 → 新建 → 企业微信 → 长连接 → 扫码接入」。
3. 使用企业微信扫码授权。企业微信将创建智能机器人，Bot ID 和 Secret 由云端加密保存，无需手动填写。
4. 卡片状态变为「已连接」后，即可在企业微信中私聊该机器人。

手填凭证 / 回调模式（仅网页端）

1. 长连接手动配置：在「频道 → 新建」中选择手动填写凭证，输入 Bot ID 和 Bot Secret。
2. 回调模式：在企业微信管理后台创建应用，获取 corp_id、corp_secret、AgentId、Token 和 EncodingAESKey（须为 43 位）。
3. 创建后，复制卡片上的「回调 URL」，并在企业微信后台「接收消息」配置中保存。企业微信会在保存时验证该地址。

关联渠道身份

启用「严格身份模式」后，未关联身份的私聊不会创建会话，仅返回关联提示。在网页端选择「频道 → 我的渠道身份 → 生成关联口令」，获取形如 LK-XXXXXX 的口令。在 10 分钟内私聊机器人并发送口令，或发送「link LK-XXXXXX」，即可完成关联。每个账号最多同时持有 3 个未使用口令；群聊发送口令无效。

停用与解绑

1. 临时停用：在网页端「频道」页停用对应应用。卡片显示「已停用」后，可随时重新启用。
2. 永久解绑：在桌面端卡片选择「配置 → 解绑」，或在网页端删除该应用。云端保存的凭证将一并删除，本机不保留副本。
3. 解绑后须重新扫码接入。渠道凭证不会回传至本机。

常见失败与处置

• 扫码无响应或扫码页无法打开：企业微信用于扫码创建机器人的管理后台接口偶尔不可用。可改在网页端手动填写 Bot ID 和 Secret；已接入的渠道不受影响。
• 提示「EncodingAESKey 必须为 43 位字符」：复制的 EncodingAESKey 可能包含多余空格或缺少字符。请从企业微信后台重新复制完整的 43 位密钥。
• 企业微信后台保存回调 URL 时验证失败：企业微信后台的 Token 或 EncodingAESKey 与「频道」页填写的值不一致，导致签名验证失败并返回 403。请核对两端配置后重试。
• 回调模式的卡片未显示「已连接」：回调模式不建立长连接，因此卡片不会显示「已连接」。该模式依赖企业微信主动推送消息，可使用卡片上的「连通性测试」验证。
• 卡片显示「失败」，错误是 connect failed：企业微信侧的机器人凭证已被删除或重置。请重新扫码接入。

进一步排查

可在「频道」页使用渠道卡片的「连通性测试」检查连接状态。 如仍无法解决，请联系支持并提供卡片显示的错误原文。