群自动化往往不止「往群里发一句」。通知、自动回、@ 某人、建群拉人,都会碰到。个人微信没有官方群机器人可挂进客户群;个人微信API二次开发里,能在群里说话的,只能是已经在群里的那个个人微信号。
群会话的toWxid是xxx@chatroom,和私聊 wxid 不是一类 ID。混用是联调时最常见的事故:接口成功了,人却在群里看不到,或者发到了错误会话。
群里发通知
和私聊同一发送接口,换目标即可:
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": "34757816141@chatroom", "content": "群通知:今晚 22:00 开始维护,请相关同事关注进度。" }'要 @ 人:content里写@昵称,ats填 wxid(多人逗号分隔;管理员 @ 全部用notify@all)。昵称要和群内当前显示名一致,改过备注或群昵称却还用旧名,常常点不成。
群内自动回:先 Webhook,再发送。多人会话建议触发词再回,全量接管很容易刷屏。接口自己发出去的内容一般不会再回调;手机端发出的会,人工接管后要停自动路径。
群从哪来、人怎么进
常见能力都在文档的群模块、消息模块里,不是概念名词:
建群:
createChatroom,至少 2 个已是好友的 wxid拉人:
inviteMember移出:
removeMember(先对账,别按昵称瞎踢)改群名 / 群备注:备注往往仅自己可见,别当成「全员都能看到的群公告」
查群:
fetchContactsList只返回已保存到通讯录的群;会话里有、通讯录没存的,常常要等群消息回调再补入库
执行appId必须还在该群。掉线优先恢复原设备;换新appId等于换节点,映射全废。
自动化时最容易翻的车
把群当成广播站。客户群里的自动化按真人发言控频,单号驱动、可停、可审计。
回调里同步跑大模型。超时直接丢事件,后面的自动回再漂亮也没有触发源。正确顺序是:收包 → 入队 → 马上 200 → Worker 再干。
列表没有的群硬发。通讯录没存的群,拉列表可能给不了;要靠回调补映射,或先确认号还在群里。
主动推和自动回搅在一起。接口发出的不回调,主动通知成败看当次响应;自动回才依赖 Webhook。两套幂等键别混用。
先只打通「指定测试群发一条文本」,再接 @ 和关键词自动回,再建群拉人放到映射表稳定之后。群自动化拼的是会话 ID 和纪律,不是接口清单有多长。
API 文档:GeWe API - GeWe API|微信 API 开发文档