「企业微信群机器人」官方有现成能力，但只覆盖一部分群。很多人按文档配好 webhook，发现客户群里发不出去，才意识到接错了对象。这篇把内部群机器人和外部群机器人分开配。

先回答：你的群机器人要进哪种群

群类型	常见需求	更合适的方案
内部群	告警、部署、审批结果、报表	官方 webhook 群机器人
外部群 / 客户群	课程提醒、订单节点、活动预告	二次开发通道（账号进群发言）

官方群机器人适合「系统对内部同事说话」。
外部群需要的是「某个企业微信账号，在客户群里发一条人话」。

两者都叫群机器人，接口、权限、风控完全不同。配错了，不是改几个参数能修好的。

内部群机器人怎么配

内部群这条路短，按官方能力即可：在内部群添加群机器人，拿到 webhook；业务系统 POST 文本；控制频率，避免告警风暴。

注意：webhook 相当于密钥，不能进前端、不能进公开仓库；同一机器人不要同时承担全公司广播和某项目调试日志；失败要看 HTTP 状态，不要默认当成功。这条路径解决不了外部群。

外部群机器人为什么不能套 webhook

外部客户群通常无法像内部群那样挂一个官方机器人，让你的服务器随便 POST。即便有部分官方群发能力，也往往有模板和频次限制，不像群会话里的普通消息，难以按单个群、按实时业务事件灵活发图片文件，也难以绑定「必须由哪个坐席号发出」。

所以外部群机器人的配置，本质是：选号、进群、映射群 ID、设发送策略、接回执。

外部群机器人最小配置清单

上线前这 8 项要配齐：

1. 推送账号：测试号和生产号分开

2. 在线检查：离线停发

3. 群映射：业务群 → 外部群 ID → 账号实例

4. 消息类型：先文本，后图片文件

5. 频次预算：按号、按群

6. 发送窗口：工作时段，夜间关闭

7. requestId：防止重复

8. 失败分类：离线 / 不在群 / 限制 / 参数错误

配的是策略，不是文案库。文案可以后加，策略从第一天就要硬。

推荐配置结构

群机器人任务
  ├── 适用范围：哪些外部群标签
  ├── 触发器：事件 或 审核后的人工发送
  ├── 通道：企微账号实例
  ├── 内容：单条文案 + 可选图片
  ├── 限制：时段、间隔、勿扰、客诉暂停
  └── 结果：回执回写运营后台

不要做成「一个开关，对全部群生效」。企业微信群机器人一旦配成全局广播，撤回成本极高。

接待型和推送型要拆开

有的团队还希望群里有人 @ 机器人就自动答。外部群里默认建议少回、甚至不回。

• 推送型：只主动发节点，不抢群里对话

• 问答型：仅对 @ 或指定关键词，且范围极小

• 投诉词：不要自动解释，转人工私聊

群是公共空间。自动回错一句，所有成员都看见。

通道怎么接

内部群继续用官方 webhook。
外部群走 RPA 封装的企业微信接口：业务配置任务，通道负责发出去。

QiWe API 面向的就是后一种：企业微信外部群主动推送，按账号实例调用，而不是往 webhook 里丢一段 markdown。配置阶段先用一个测试外部群把文本和回执跑通，再复制到生产群。

登录、群 ID、发送和错误码，以 QiWe API 文档为字段来源。文档地址：平台介绍 - QiWe API｜企微 API 开发文档

配置验收

• 内部群 webhook 不影响外部群任务

• 改群名后，生产任务仍打到正确的群

• 账号退群后，任务显示失败原因，不会假成功

• 重复点击「发送」，群里只有一条

• 夜间窗口关闭时，任务排队而不是发出

小结

企业微信群机器人怎么配，第一步是分群：内部走官方 webhook，外部走账号通道。外部群把映射、在线、频次、回执配齐，再上内容。需要客户群主动推送时，用 QiWe API 接二次开发接口，把机器人做成可配置的任务，而不是一个永远在线的喇叭。配得越克制，群越能留下来。