操作导引
-
1
下载 WxTool Android 应用
下载并安装微信接入 App 的 Android 版本。
下载 Android 应用 -
2
获取接待账号 / bot_id
前往接待配置，创建或选择接待账号，复制页面展示的 bot_id。
前往接待配置 -
3
配置连接并核验微信号
按手册配置 WxTool，完成手机授权及本人微信号核验，再绑定 AI成员并测试收发。
App 配置参考视频（微信AI助手配置）
以下视频演示 App 端的配置操作；也可以下载后观看。
微信AI助手 接入手册
使用 Android WxTool App 将手机上的个人微信接入平台，由绑定的 AI成员接待客户，也可以在工作台人工回复、添加好友、同步通讯录和查看历史对话。
本手册按当前 WxTool App 与平台已实现的能力编写。不同安装包、微信版本和手机页面可能影响可用功能；图片、语音转文字、历史采集等功能还需要 App 与服务端完成对应能力确认。页面提示需要升级时，请安装匹配的新版本并重新连接。
下载与操作入口
- 下载 WxTool Android App
- 接待账号：获取机器人 ID，绑定 AI成员。
- 微信 App 配置：查看微信绑定、在线状态和连接配置。
- AI成员：配置岗位、资源和运行策略。
- 接待工作台：选择“微信 App 接待”，进入客户对话。
- 微信资料库：查看好友、群成员与累计对话。
一、WxTool 能做什么
| 能力 | 使用方式与范围 |
|---|---|
| 接收微信消息 | 读取可访问的好友和群聊消息，上报到工作台；群消息是否触发 AI，由接待策略决定。 |
| 发送文字 | AI 回复或人工输入后，由手机向已核验的好友、群聊发送。发送前核对目标，已有输入框草稿不会被直接覆盖。 |
| 接收与发送图片 | 新消息图片可尝试读取微信允许保存的文件；人工发送支持单目标、单张 JPG、PNG、WebP、GIF，文件不超过 20 MB。需匹配版本与图片权限。 |
| 语音转文字 | 调用手机微信的原生“转文字”，将可取得的正文交给工作台和 AI；未完成时显示待补全，失败时明确提示。此能力不上传原始音频。 |
| 添加微信好友 | 在工作台按手机号或微信号发起申请，可填写招呼内容和备注；“申请已发送”不等于对方已接受。 |
| 同步通讯录 | 扫描手机可访问的联系人资料，读取可核验的微信号、昵称等信息；同步结果区分完整与部分完成。 |
| 同步群资料 | 读取本次可访问的群及成员资料，保留已核验的成员微信号；不承诺覆盖该微信号加入的全部群。 |
| 采集历史对话 | 按指定会话、会话列表顶部范围，或近半年、近一年、近三年的时间范围采集；支持暂停、继续与取消。历史采集不触发 AI 自动回复。 |
| 暂停与恢复 | 手机端可手动暂停、继续运行；锁屏或离开微信时等待，恢复条件满足并重新核验后继续。手动暂停不会被自动解除。 |
| 诊断与排查 | 手机端可导出微信页面结构、选择采集失败记录，辅助定位权限、页面识别和上报问题。 |
当前不支持真实群 @ 发送、任意文件或视频发送、建群、踢人、引用和转发等操作。历史对话采集也不等于完整微信备份，不保证取得全部历史附件或原图。工作台中普通文字“@某人”不等于微信原生提醒。
二、接入前准备
准备一台已安装微信并登录目标微信号的 Android 手机，以及平台接待账号。WxTool 通过 Android 辅助功能读取和操作微信界面，需要在手机上完成授权。
运行时保持网络可用、屏幕解锁且微信在前台。按系统设置允许 WxTool 持续运行，避免被后台限制中断。不要仅凭 WebSocket“连接成功”判断已能收发：还需要辅助功能可用、微信身份核验通过和运行状态正常。
WxTool 的安装包标识为 com.wiseaio.wxtool，可以与企微 WorkTool 同时安装。请确认打开的是 WxTool，操作目标是个人微信。
三、首次接入
1. 获取接待账号 ID
进入接待账号，创建或选择需要接入的账号，复制机器人 ID（部分页面显示为 bot_id）。可以使用已有接待账号，不必为微信重新创建一套账号。
机器人 ID 是平台连接标识；手机上的微信号是实际接待身份，两者不同，需要分别核对。
2. 安装 WxTool 并授权
在手机打开 WxTool 下载页，下载安装。进入 App，按引导开启辅助功能及触摸探索兼容相关设置。需要采集图片时，使用“授权图片读取（用于图片采集）”入口完成照片读取授权。
不同手机的授权入口可能不同，以当前 App 的就绪提示为准。完成授权后返回 WxTool，再进入微信；若此前手动暂停或导出了诊断，点击“继续运行”。
3. 配置连接
在 WxTool 填入刚复制的机器人 ID 和平台提供的服务地址。进入平台微信 App 配置的“连接配置”，核对 WebSocket 路径。
本平台微信连接使用 /webserver/wxwork/{robot_id}。请按 App 字段要求填写主机地址或完整连接地址，不要将路径重复拼接，也不要使用企微的 /webserver/wework/ 路径。
连接鉴权、加密和上传配置沿用接待账号现有设置，优先使用平台展示的配置，不另建上传地址。需要填写连接密钥时从账号设置获取，不要把密钥放在公开截图中。
下图为 WxTool 的机器人 ID 配置页面，请填写你自己的接待账号 ID。
4. 完成本人微信号核验
保持手机解锁并打开目标微信。等待 WxTool 读取当前账号资料并完成服务端确认，核对平台显示的微信号与手机实际登录账号一致。
“等待打开微信”“正在核验账号”“等待服务器核验”都还不是正常采集状态。切换微信账号后需要重新核验；系统不会将新账号消息继续写入旧微信号的资料。
5. 绑定 AI成员
进入AI成员，从已发布岗位创建或选择 AI成员，配置所需资源和运行策略。回到接待账号，绑定该 AI成员，并核对微信 App 渠道。
WxTool 负责微信界面的读取与执行；回复什么、何时自动回复、群消息如何接待，由平台 AI成员和渠道策略决定。仅安装 App 不会自动获得完整的业务接待配置。
6. 用新消息验收
进入接待工作台，点击对应账号的“微信 App 接待”。用另一个微信号发送一条新的测试文字，依次确认：
- 手机 WxTool 正在采集，平台显示正确的微信身份。
- 工作台收到消息，客户、发送者和正文正确。
- AI 接待开启时，运行记录能看到触发与回复；人工接管时由人工操作。
- 手机微信中出现对应回复，工作台发送状态更新。
再根据实际需要分别测试图片、语音、群聊和好友申请。某一项通过不代表其他能力已在这台手机验证通过。
四、日常使用
启动、停止与状态检查
配置完成后，在 WxTool 的状态控制页面启动运行，并检查连接、账号核验和采集状态。需要停止手机自动操作时，在此页面停止或暂停；恢复时按页面提示继续运行，再确认微信处于前台且屏幕已解锁。
首次连接、重连和恢复运行会核验当前微信账号并启动实时收消息。通讯录、会话目录、群资料及历史对话由操作人员手动发起采集；工作台的“同步微信通讯录”只采集通讯录。
人工回复与接管
在工作台选择客户或群，点击“人工接管”后回复。文字与图片分别发送；选图后先检查预览和当前会话，再提交。需要恢复 AI 接待时，使用工作台对应的恢复操作。
平台的“人工接管”管理会话接待权限；手机的“暂停运行”暂停 App 自动操作，两者不是同一个开关。
添加好友
点击“添加微信好友”，输入手机号或微信号，按需要填写招呼内容和备注，提交后等待执行结果。遇到找不到账号、隐私限制、需要验证或操作频繁时，按结果处理。结果未知时先检查手机，不要连续重复提交。
同步通讯录、群成员和对话
在工作台同步通讯录，或进入微信资料库选择微信号后启动资料、对话采集。同步资料与同步聊天正文是不同任务。
历史对话每会话默认最多 300 条文字消息，上限 1000 条；这是单次采集预算，不是累计保存上限。按时间范围采集达到本轮预算后可能暂停，可继续同一任务。采集期间自动收发暂缓，打开聊天也可能改变手机未读状态。
资料按核验后的微信号累计保存，同一微信号切换执行接待账号不会新建一份资料。好友、群成员不会因为同步自动变成 CRM 客户。完整操作与覆盖范围说明见微信资料库：绑定、查看与同步。
看懂运行与发送状态
| 状态 | 含义与下一步 |
|---|---|
| 已连接 / 在线 | 通信连接已建立；仍需确认账号核验和手机采集状态。 |
| 等待解锁 / 等待打开微信 | 解锁手机并回到微信，等待重新核验。 |
| 手动暂停 | 回到 WxTool 点击“继续运行”，不会因重连自动恢复。 |
| 已提交 / 排队 / 已下发 | 平台已接收或下发任务，不代表微信已发送。 |
| 已发送 / 已确认 | 设备确认本机微信出现匹配的发送消息，不代表对方已读。 |
| 结果未知 | 可能已经点击发送，但证据不足；先检查手机再决定是否重发。 |
| 部分完成 | 已保存部分采集结果，但尚未确认设定范围完整覆盖。 |
五、常见问题
在线但不收消息，先查什么？
检查手机是否解锁、微信是否在前台、辅助功能与触摸探索是否就绪、账号是否核验通过、是否手动暂停或正在历史采集。再看 App 的采集、网络发送队列和服务端确认摘要，区分“没读到”“待上报”“待确认”。
提示当前不在微信，或显示系统安全中心包名？
表示当前观察到的前台不是目标微信界面。关闭系统权限或安全中心页面，回到微信并等待核验。若日志明确写“当前不在企业微信”，还应核对日志中的机器人 ID 和渠道，避免把企微 App 的日志当成 WxTool 的错误。
工作台收到消息，AI 却没有回复？
检查接待账号绑定的 AI成员、运行策略、人工接管状态及群接待条件。历史消息、自发消息和未取得正文的语音占位不会仅因展示在工作台就触发回复。查看该次 AI 运行记录确认具体原因。
图片只显示占位，语音一直待补全？
图片可能没有读取权限，或微信文件已过期、清理、无法保存，也可能上传失败。语音需要微信提供可读取的原生转写结果。保持当前账号与页面可核验，查看具体失败提示；界面占位不代表已取得图片文件或语音正文。
发了两条，工作台为什么曾显示四条？
工作台同时接收平台发送记录和 App 对已发送气泡的监控回传。匹配版本会根据发送回执、账号、会话与消息顺序关联为一条展示。若仍重复，请提供接待账号 ID、发生时间和两端截图排查，不要为了消除重复再次发送。
通讯录或历史采集为什么只有部分结果？
手机本次可访问范围、未读跳过设置、条数与时间预算、身份核验以及页面读取失败都会影响覆盖。查看任务的未完成原因，按需要继续采集；不要把“已归档若干条”理解为全部历史已完成。
如何提交诊断？
记录 App 构建版本、手机系统、微信版本、接待账号 ID 和发生时间。通过 WxTool 首页导出微信页面结构或选择采集失败记录，交给支持人员。诊断导出后检查是否处于暂停状态，处理结束后再继续运行。公开分享前遮挡客户聊天、微信号和连接密钥。