搜「个人微信API」，要的通常不是官方开放平台，而是：个人号能收消息、能回消息、业务系统只调 HTTP。 个人微信没有完整官方机器人接口，常见是二次开发封装。这篇按对接顺序写。

先确认你要的能力

个人微信API 最小闭环只有三块：

• 扫码登录 / 在线查询

• 消息回调（私聊优先）

• 发送文本（再扩图片、文件）

没有回调只有发送，那是通知通道，不是客服机器人。没有在线检查，掉线还会显示“已回复”。

推荐架构

业务系统（规则 / CRM / 工单）
  → 网关（鉴权、队列、频控）
  → 个人微信API
  → 微信实例（RPA 保活）

业务代码不要点窗口。窗口坐标、控件名不属于业务仓库。

对接顺序

1. 测试号登录，状态机：未登录 / 扫码中 / 在线 / 离线

2. 配 HTTPS 回调，msgid 去重后入库

3. 发私聊文本，带实例 ID、对方稳定 ID、requestId

4. 失败分类：离线、不是好友、参数错误、超时

离线必须停出站。同一 requestId 只许成功一次。

现成通道

自己养协议或 Hook 成本高。多数团队用 RPA 封装成 HTTP。GeWe API 把个人号登录、回调、发送做成可调接口，业务按模块对接即可。

字段、错误码以文档为准：API文档

验收

• 掉线后发送被拦截

• 同一 msgid 不双回

• 测试号和生产号不串数据

• 群消息默认不进自动回复

小结

个人微信API 对接的关键是登录稳定、回调可去重、发送可对账。用 GeWe API 承接通道，你们把精力放在规则和转人工。先跑通私聊文本，再谈群和营销。