很多团队卡在这里:机器人能进群,但只能被动看消息,不能主动往群里发、不能拉人、不能管群。
个人微信场景里,群才是主战场。通知、欢迎语、关键词拉人、@ 提醒,都发生在群里。
先说结论
群机器人要能「看」也要能「动」。能主动发消息、拉人、管群,外部群能力才算接上。
| 需求 | 对应能力 |
|---|---|
| 往群里发通知 | 发送文字 / 图片 / 文件 |
| @ 某人或 @ 所有人 | 发送时带ats |
| 建群、拉人、踢人 | 群管理接口 |
| 改群名、群公告 | 群信息接口 |
| 关键词触发进群 | 收消息 + 邀请入群 |
完整接口列表在文档「群模块」里:API 文档
主动发群消息记住 3 点:
toWxid填群 ID(形如xxxx@chatroom)- 群内 @ 人:
content里写@昵称,ats填 wxid - @ 全员:管理员 / 群主把
ats填notify@all
最小闭环
GeWe API 支持主动调用外部群能力,群相关都走标准 API。先发一条群文本:
importrequests API="http://api.geweapi.com/gewe/v2/api/message/postText"HEADERS={"X-GEWE-TOKEN":"YOUR_TOKEN","Content-Type":"application/json",}result=requests.post(API,headers=HEADERS,json={"appId":"你的appId","toWxid":"xxxx@chatroom","content":"今晚 8 点对账,请群内核对单据。",},timeout=30,).json()print(result)关键词入群的典型流程:
用户私聊发送「加入社群」 ↓ Webhook 收到这条消息 ↓ 调用邀请入群接口 ↓ 再发一条欢迎语建群至少要带 2 个好友 wxid,否则建不起来。这不是人在群里点,而是业务系统决定什么时候拉人、什么时候发言。
联调验收
ret == 200且目标群里能看到消息toWxid填成好友 wxid 时,消息会进私聊,群里是空的- @ 人时气泡里要出现可点的名字,只写
@张三字符串不够 - 先小流量验证,不要对全部群群发
再扩一步
群通知通了,再接邀请入群、改公告。平台能力总览见 GeWe API 官网
总结
微信群机器人要主动发,关键是toWxid填对群 ID。先打进一个测试群,再扩拉人和 @。