很多团队卡在这里：机器人能进群，但只能被动看消息，不能主动往群里发、不能拉人、不能管群。

个人微信场景里，群才是主战场。通知、欢迎语、关键词拉人、@ 提醒，都发生在群里。

先说结论

群机器人要能「看」也要能「动」。能主动发消息、拉人、管群，外部群能力才算接上。

完整接口列表在文档「群模块」里：API 文档

主动发群消息记住 3 点：

1. toWxid 填群 ID（形如 xxxx@chatroom）
2. 群内 @ 人：content 里写 @昵称，ats 填 wxid
3. @ 全员：管理员 / 群主把 ats 填 notify@all

最小闭环

GeWe API 支持主动调用外部群能力，群相关都走标准 API。先发一条群文本：

import requests

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。先打进一个测试群，再扩拉人和 @。