工单从「处理中」变成「已完成」，报价 PDF 也生成了，客户却还在企业微信外部群里追问。人肉复制进群又慢又漏。官方机器人进不了外部群；要把业务结果自动写进客户群，走企业微信API二次开发的主动发送。

文本、文件发送与 CDN 上传字段以 QiWe API 开放文档 为准。先分清：这是业务事件驱动的主动推，不是对方先说话再自动回——两套触发可共用 /msg/sendText，幂等和监控建议拆开。

文本进度：事件到群

工单状态变更 → 查 roomId + 主责 guid →「工单ID+状态」占坑 → /msg/sendText

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": "工单 #1024 已处理完成，报价见后续文件消息。",
      "isNoNeedRead": true
    }
  }'

toId 填外部群 roomId；账号必须已在该群。群 ID 不确定时，用同一 guid 调 /room/getRoomList（游标从 0 翻页）校准后再发。

报价文件：先上传再发

sendText 发不了 PDF。先走 CDN 上传类接口拿到 fileId、fileAesKey 等，再调 /msg/sendFile。两步不要并成一步硬塞 URL。超时先查本地是否已记成功，再决定补发，避免客户连收三条「已完成」。

短时间状态连跳，合并成一条体验更好。guid 掉线应熔断推送队列，恢复原设备再放行；areaCode 对齐登录省份。多顾问必须用该群主责设备，禁止写死默认 guid。

上线前验收

测试外部群绑假工单，改状态应只出现一条带单号播报；同一状态连推三次仍一条。文件链路：上传成功后再发，群内能打开。工单进外部群拼的是映射和幂等，不是群发按钮；细节对照开放文档。