只往外部群推通知只能做广播。自动回复、关键词、AI 客服要先收到群消息。官方外部群没有机器人回调。企业微信API二次开发用 /client/setCallback 登记公网 URL，事件进来后 3 秒内返回，再异步调 /msg/sendText。

回调行为

• POST JSON 到你的地址

• 3 秒内返回 HTTP 200（可空），超时丢弃

• 接口主动发出的消息 不 再回调

• 手机端发出的会回调

• 一个 Token 下多设备都打到同一 URL，用 guid 区分

企业微信API二次开发如何配回调

curl -X POST https://new.qiweapi.com/qiwe/api/qw/doApi \
  -H "X-QIWEI-TOKEN: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "/client/setCallback",
    "params": {
      "callbackUrl": "https://your-domain.com/wecom/webhook",
      "authType": "Authorization",
      "authSecret": "你的密钥"
    }
  }'

也可在控制台「应用凭证 → 配置」。配置成功会推校验请求。事件里 cmd / msgType 以文档为准。

POST /webhook → 读 Body、验签 → 入队 → 立刻 200
Worker → 业务处理 → /msg/sendText（同一 guid + roomId）

curl -X POST https://new.qiweapi.com/qiwe/api/qw/doApi \
  -H "X-QIWEI-TOKEN: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "/msg/sendText",
    "params": {
      "guid": "回调里的设备ID",
      "toId": "回调里的外部群roomId",
      "content": "收到，正在查询",
      "isNoNeedRead": true
    }
  }'

企业微信API二次开发上线前要注意

1. 回调里禁止同步跑大模型。

2. 入站去重 + 出站幂等，避免双回复。

3. 多 guid 禁止写死一台设备。

4. URL 必须公网可达。

5. 人工接管时要停掉自动回复。

平台介绍 - QiWe API｜企微 API 开发文档