报价在系统，客户在外部群等附件。文本丢链接 ≠ 文件消息；官方机器人也进不了外部群。企业微信API二次开发可以走文件投递。见 QiWe API 开放文档。

难的是一份有效报价、可追溯、不连发、不发错群。

业务目标

单据到「可发」才触发；客户只收到一份；主责号发出；失败可续但不双份；CRM 知道成败。

设计要点

单据驱动；先占坑再投递；文案提醒与文件分键；发送前确认仍在群；存储链接过期要当一等公民处理；掉线熔断文件队列。

状态抖动时合并投递，避免客户连收三版报价。上传拿到文件凭证后，发送示意（字段以文档为准）：

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/sendFile",
    "params": {
      "guid": "主责设备ID",
      "toId": "外部群roomId",
      "filename": "报价单-2026Q1.pdf",
      "fileId": "上传返回的fileId",
      "fileAesKey": "上传返回的key",
      "fileSize": 102400,
      "fileType": 5
    }
  }'

验收

测试群能打开且一份；同单重试仍一份；主责变更不误发。干货在单据幂等与关系校验。