私域和售后最常见的想法是：群里加个机器人，系统有通知就往外推。

企业微信官方卡在两处：

1. 「群机器人 / 消息推送」只给内部群，客户群加不了。
2. 就算内部群能推，也只是往固定地址丢一条消息，做不了按群推送、拉人、踢人。

对照字段时可以看这份说明：API文档

先说结论

• 官方机器人：内部群通知够用，客户群运营不够用。
• 官方群发：能触达客户群，但要员工确认，还有接收上限，做不到实时推。
• 要「系统立刻给某一个外部群发消息」，得让已在该群里的企业微信账号发，而不是再加工具人。

订单出库、售后提醒、按店铺分别推，都属于第三种。

最小闭环

账号扫码登录成执行节点 → 业务侧保存目标群 roomId → 调用发文本接口，toId 填群 ID。

这不是往群里加官方机器人，是程序驱动这个账号自己说话，所以内部群、客户群写法一样。

QiWe API 统一入口是一个 POST，用 method 区分动作，请求头带 X-QIWEI-TOKEN。

import requests

API = "http://manager.qiweapi.com/qiwe/api/qw/doApi"
HEADERS = {
    "X-QIWEI-TOKEN": "YOUR_API_KEY",
    "Content-Type": "application/json",
}

def send_text(guid, to_id, content):
    r = requests.post(
        API,
        headers=HEADERS,
        json={
            "method": "/msg/sendText",
            "params": {
                "guid": guid,
                "toId": to_id,
                "content": content,
                "isNoNeedRead": True,
            },
        },
        timeout=30,
    )
    return r.json()

result = send_text("你的guid", "群的roomId", "订单已发货，请群内核对物流信息")
print(result)

• guid：登录后的设备 ID
• toId：私聊填 userId，群聊填 roomId
• code == 0 且 data.isSendSuccess == 1，手机/电脑上的企业微信里能看到这条，才算发出去

联调验收

1. 先发给自己的 userId，确认 Token 和登录态
2. 再发给一个测试客户群的 roomId，看气泡是否出现在该群
3. 故意填错 toId，确认消息不会落到别的群
4. 创建设备时登录省份和账号常用地一致，避免异地登录拦掉扫码

不要一上来对全部客户群群发。频率和文案按运营规则收着写，发错群比接口报错更难收场。

再扩一步

只发送，只能做通知。要自动回群里的问题，再配 Webhook：收到消息 → 判断意图 → 仍用上面这条发送接口回出去。

控制台、Token 和实例登录可以从 QiWe API 官网 进。

总结

外部群加不了官方机器人，核心不是 Webhook 地址配没配好，而是：系统能不能让企微账号往指定 roomId 发消息。先把一条测试文本打进测试群，这条链路才算通。