微信助理集成

开始之前

本方式接入个人微信号，无需企业主体、开发者后台或手动填写凭证。请准备已登录该微信号的手机。

在桌面端接入

1. 打开「设置 → 助理设置 → 集成（Beta）」，在「微信助理集成」卡片中选择「配置」。
2. 选择「扫码接入」，在弹窗中查看二维码。二维码由桌面端根据云端返回的扫码信息生成。
3. 使用对应的手机微信扫码，并在手机上确认授权。
4. 出现「绑定成功」提示后，弹窗自动关闭，卡片状态变为「已连接」。

在网页端接入

1. 进入「频道」页，选择「新建」，并将平台设为「个人微信」。
2. 接入方式固定为长连接，无需填写凭证，直接创建。
3. 在新建的卡片上选择「扫码登录」，使用手机微信扫码并确认。

接入后使用

通过已接入的微信号发送消息，即可在同一对话中接收助理回复。二维码有效期为 5 分钟，过期后须重新获取。

关联渠道身份

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

停用与解绑

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

常见失败与处置

• 「二维码已过期」：扫码会话有效期为 5 分钟。请选择「重新获取二维码」并再次扫码。
• 「授权失败，请重新获取二维码」/ 一直停在「已扫码，请在手机上确认」：手机端未确认授权，或确认回执缺少账号凭证。请重新获取二维码并扫码。
• 卡片显示「失败」，错误写着「微信会话已过期，请重新扫码登录」：手机端退出登录或长期离线导致微信会话失效。请重新扫码；系统也会在暂停约 10 分钟后重试。
• 卡片持续显示「未连接」：扫码流程尚未完成，或应用已停用。请在网页端「频道」页检查对应应用的状态。

进一步排查

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