很多同事配群机器人时会发现：内部群一切正常，客户群里根本找不到「添加机器人」。

这不是权限勾漏了。官方能力范围就是这样：群机器人不能用于外部群。

按模块对照字段，可以从这里开始翻：开放文档

先说结论

只要需求是「客户群 + 系统主动发」，群机器人这条路走不通。典型卡点：

• 内部群通知没问题，客户群发不了
• 售后群要自动提醒，界面没有机器人入口
• ERP / 工单要立刻推，官方群发还要人工确认

客户群里能发言的是群成员。要主动推送，就让一个企业微信账号待在群里，由程序驱动它发消息。看起来像群机器人，实际是可编程的企微节点。

最小闭环

准备：

• 控制台创建 Token
• 实例管理扫码登录企业微信
• 确认该账号已经在目标客户群里

QiWe API 把这个账号收成统一 POST，发文本时 toId 填客户群 roomId。

import requests

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

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

result = send_group_text(
    "你的guid",
    "客户群roomId",
    "仓库已出库，今晚 6 点前请群内确认收货。",
)
print(result)

Header 必须带 X-QIWEI-TOKEN。code == 0 且 isSendSuccess == 1，打开该客户群应能看到这条。

和官方群发可以一起用：活动宣传走官方、接受员工点确认；订单和客服走接口、要实时按群推。

联调验收

1. 每个客户群单独映射，禁止一次打全部群
2. 同类通知合并，避免刷屏
3. 失败记日志，方便查「为什么这群没收到」
4. toId 填成 userId 时，消息会进私聊，群里是空的

再扩一步

同一登录态还可以接自动回复：Webhook 收到群消息后，仍用上面的发送函数回该 roomId。人工接入后让机器人停手，避免双回。

产品能力见 QiWe API 官网。

总结

群机器人不能发外部群，不用反复找后台开关。账号已在客户群里时，用接口按 roomId 发一条测试文本，主动推送就算接通。