销售问：「报价单发了没？」你说发了。客户说群里没有文件。
两边同时崩溃——文本通知还好查，文件链路更容易「假成功」。
企业微信二次开发发文件到外部群，常见坑是：步骤并成一步，或超时连点三次，客户收获三份/零份说不清。QiWe API 的文件相关能力以文档为准，业务侧先把闭环做对。
建议闭环
准备文件（可访问、可校验） → 按文档完成必要的上传/取凭证步骤（如需） → 再发送到外部群 → 任务记成功/失败 → 业务钥匙占坑（同一报价单只成功一次）并成「直接丢个外链当文件发」，最容易群里看不到附件。
注意五点
目标必须是外部群会话，别发成私聊
设备还在群里
同一报价单号只能成功一次，防止连点双发
日志记下文件名、大小、任务状态、凭证
临时链接注意过期：能落到自有存储就落，业务以你校验过的副本为准
排障怎么问
任务状态是成功还是未知？有没有凭证？
发到的是群还是人？
客户搜文件名，是否在别的会话？
是否同一单号出现两次发送？
给销售侧的配合方式
别在聊天里连点三次「重新发送」。
系统应展示：排队中 / 发送中 / 已发送 / 失败原因。
失败时给出人话原因（不在群、文件准备失败），并支持单次重试，而不是静默再打三枪。
联调时固定用测试外部群 + 小体积 PDF，先做到「群里一定能打开」，再换真实报价模板。
小结
文件坑往往在准备步骤和幂等，不在 PDF 排版。
先跑通「群里真能打开」，再谈模板好看。
步骤说明见 QiWe API 文档
