很多人找「个人微信机器人接口」，其实不是想做营销群发，而是官方公众号、企微满足不了场景：个人号在加、客户只认这个微信、售前售后都在同一个对话框里。这篇文章把个人号接口怎么接讲清楚，重点只有三块：登录、发消息、回调。

个人号接口和公众号、企微有什么区别

先不要被“机器人”三个字带偏。三类微信能力完全不是一个东西：

• 公众号 / 服务号：官方 API，能模板消息，但不能像好友一样自然聊天

• 企业微信：官方接口完善，适合内部协同和企微客服

• 个人微信：没有官方完整机器人接口，需要二次开发，常见做法是 RPA 封装成 HTTP 接口

所以你要接的「个人微信机器人接口」，本质上是：把个人号的收发能力，变成你业务系统可以调用的 API。

适用场景通常是：

• 个人号客服接待

• 预约/到店提醒

• 订单状态私聊通知

• 售后进度同步

不适合的场景也很明确：无差别群发、批量加好友、诱导分享。即使用了接口，这类行为一样会触发限制。

接入前只需要准备 4 样东西

1. 一个专门做机器人的微信号（不要用老板本人号）

2. 一台能长期在线的运行环境（云主机 / 本地常开设备）

3. 你的业务服务，能提供 HTTPS 回调地址

4. 一套账号-客户-消息的数据表，至少能去重和追日志

个人号接口不是“申请 AppID 就能调”。它依赖一个在线的微信实例。实例掉了，所有接口都会失败。这点和公众号完全不同。

三块核心接口，按这个顺序接

一、登录接口：先解决“号在不在线”

登录接口一般提供：

• 获取二维码

• 查询登录状态

• 退出 / 重登

你要在自己的后台做两个页面就够了：

• 扫码页：展示二维码，显示“未登录 / 已登录”

• 状态页：实例在线时长、最后心跳、最近一次掉线原因

客服主管最关心的不是发没发成功，而是 现在还能不能回客户。登录状态必须可视化。

二、发消息接口：按消息类型拆，不要只用一个 send

个人微信机器人接口里，发送至少要分开：

• 文本

• 图片

• 文件 / 视频

• 名片、链接（如果业务需要）

• 群 @（群场景才需要）

调用时带齐这几个字段：

• 实例 ID（哪个微信号发）

• 接收方（好友 wxid 或群 ID）

• 消息体

• 业务侧自己的 requestId（用于对账）

requestId 很关键。接口超时并不等于没发出去。没有对账 ID，客服会重复点“重发”，客户就会收到两条一样的回复。

三、回调接口：这才是机器人的“耳朵”

没有回调，就不是机器人，只是群发工具。

回调要能覆盖：

• 私聊文本

• 群聊文本

• 图片/语音（至少能拿到资源标识）

• 好友申请（如果你做自动通过）

• 掉线事件（强烈建议当回调处理）

你的回调服务要快速返回成功，业务处理放队列。个人号高峰时，一个号短时间进几十条消息很常见，同步处理会把回调拖死。

一套能上线的最小字段设计

建议业务库至少有三张表：

account：微信号实例、在线状态、绑定客服组
contact：好友/群与客户 ID 的映射
message：方向（in/out）、msgid、内容、处理状态、发送回执

映射表一定要做。微信侧 ID 和你们 CRM 的客户 ID 不是一回事。接接口的第一周，90% 的“发错人”都出在映射上。

个人号接口怎么选

选型时别只看“能不能发文本”。按客服场景，优先看这 5 项：

1. 回调是否稳定，会不会漏消息

2. 掉线能否及时通知

3. 多开是否隔离干净

4. 图片/文件能不能闭环（能收也能发）

5. 文档是否按模块写清楚，字段有没有示例

个人号二次开发里，RPA 路线比较常见，业务侧只调 HTTP。如果走这条路，可以用 GeWe API 把个人微信能力封装成接口，登录、消息、回调分开对接，业务代码会干净很多。具体参数和回调格式以文档为准：GeWe API - GeWe API｜微信 API 开发文档

常见误区

• 把个人号接口当成公众号模板消息来用：个人号是会话，不是通知通道，话术要像人

• 一个接口包打天下：登录失败、不是好友、被限制，错误要分开处理

• 群和私聊共用自动回复：群里回错一句，整个群都会觉得机器人很吵

• 不做人机接力：客户连续追问 3 次还在套模板，就该转人工

小结

个人微信机器人接口并不复杂，真正要接的就是登录、发送、回调三件事。先把实例在线状态和消息去重做稳，再接业务规则。个人号没有官方完整开放接口，二次开发更适合走 API 封装；需要对照字段时，直接看 GeWe API 文档即可。把三块接口接完，客服机器人的骨架就有了。