企业微信API如何发送消息到客户群？群机器人限制说明

搜「企业微信API 发送消息」，很容易把两件事混在一起：

往内部群推通知
往客户群发运营消息、客服回复

前者官方群机器人就能做。后者才是大多数销售、客服、SCRM 真正要的。

群机器人到底限制在哪

官方群机器人（现在也叫消息推送）常见限制就这几条：

只支持内部群，客户群没有添加入口
只能推消息，不能当「人」去回客户
不能按客户群做拉人、踢人、改群公告
全员禁言时，机器人消息可能发不出去

所以：群机器人 ≠ 客户群发消息 API。

客户群发消息，常见 3 条路

需求	官方群发	官方机器人	QiWe API
发到客户群	可以	不可以	可以
系统立刻发出	不行，要员工点确认	内部群可以	可以
指定某一个群	能选群，但流程重	做不到外部群	`toId` 填 roomId
顺带做群管理	基本没有	没有	有群模块

参数和返回值以这份文档为准：QiWe API 文档

用 QiWe API 发给指定客户群

QiWe API 把企业微信账号变成可调用的执行节点。发消息时不区分「这是内部群还是外部群」，关键是把对的 roomId 传进去。

Python 示例：

python 复制代码

import requests

url = "http://manager.qiweapi.com/qiwe/api/qw/doApi"
headers = {
    "X-QIWEI-TOKEN": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "method": "/msg/sendText",
    "params": {
        "guid": "你的设备ID",
        "toId": "客户群的roomId",
        "content": "今天下午 3 点对账，请群内同事提前准备单据。",
        "isNoNeedRead": True
    }
}

resp = requests.post(url, json=payload, headers=headers, timeout=30)
print(resp.json())

成功时大致是：

json 复制代码

{
  "code": 0,
  "msg": "成功",
  "data": {
    "isSendSuccess": 1
  }
}

实际对接时怎么找群 ID

按这个顺序最不容易乱：

账号先在控制台扫码登录，拿到 guid
调用群模块，列出该账号所在的群
用群名核对，保存 roomId
业务系统里把「客户 / 项目 / 店铺」和 roomId 做成映射
事件触发时，只给对应群发，不要广播

这样比每次靠群名模糊匹配更稳。群名会改，roomId 相对稳定。

客服场景怎么用

工单状态变更 → 推到对应客户群
客户在群里提问 → Webhook 收到后自动回复
需要人工时 → 再转给坐席，由同一账号继续发

QiWe API 覆盖登录、联系人、群管理、消息收发、会话等模块，客服系统和 SCRM 可以共用同一套接口。产品介绍也可以看 QiWe API 官网。

总结

企业微信API要发到客户群，先分清你接的是不是官方群机器人。

官方机器人解决不了外部群；要主动发、指定群、还能做群管理，用账号级 API 更直接。