业务系统要给客户发通知、也要听客户回什么一查开放平台就明白个人微信会话没有给你用的官方收发 API。个人微信API二次开发走的是另一条路——账号扫码登录成执行节点发信用 HTTP收走 Webhook两边都进你自己的服务。设备字段叫appId不是企微那套guid接收方叫toWxid好友填 wxid群填xxxchatroom。混用字段是联调时最常见的低级事故。和企微封装不要共用一套字段名否则迟早有人把群 ID 当私聊发出去。先发通再谈闭环登录好节点、Token 放进X-GEWE-TOKEN之后先发一条文本验证通道是否真通再去折腾回调和业务逻辑。很多人反过来回调配了一下午结果发送本身就失败。curl -X POST http://api.geweapi.com/gewe/v2/api/message/postText \ -H X-GEWE-TOKEN: YOUR_TOKEN \ -H Content-Type: application/json \ -d { appId: 你的设备ID, toWxid: 好友wxid或群IDchatroom, content: 自动发送测试通道已接通 }ret 200只说明接口层接受了不代表业务上「对方一定读到了」。群里要 人时content必须带昵称同时ats填对方 wxid只做一边常常点不成。图片、文件、链接、视频分别走postImage/postFile/postLink等接口别往文本content里硬塞 URL 当富媒体。收回调才是入站控制台「访问控制」配一个公网可访问地址。消息以 POST JSON 推过来文档要求大致3 秒内返回超时可能直接丢。接口自己发出去的内容一般不会再回调手机端发出的会——多端同步如此上线后要按这个特性做人工接管标记。正确姿势永远是读完 Body → 验身份 → 入队 → 马上 200 → Worker 里再查库、调模型、再 postText把查 CRM、调大模型放在回调线程里表现就是「偶发收不到」「自动回复不稳定」。配置成功后平台常会推一条「验证回调是否可用」这条不要当客户消息入库更不要跑关键词回给「客户」。一个 Token 挂多个appId时所有号可能打到同一 URL务必用回调里的设备字段路由发送时带回去不要写死「默认号」。同一会话进了两个托管号可能收到两路回调主责表没做好就会双回。收发稳定的几条底线appId登录成功后固定用频繁换号等于换节点业务侧客户映射、会话映射全废掉线优先恢复原设备而不是新建碰运气二维码大约 150 秒过期要重新取码别死等一张废码入站去重、出站幂等否则客户一句「好的」你会回两遍主动推和自动回建议分两套幂等键实名个人号在干活按客服节奏控频别当群发器频率和话术都按真人客服标准管先打通「指定好友发一条 回调能入队」再接自动回、AI、加好友。通道不稳上面叠什么都会像玄学。API 文档GeWe API - GeWe API微信 API 开发文档