whatsapp 的官方 click-to-chat 功能（wa.me 链接）仅支持预填充文本消息，不支持通过 url 参数附加 pdf、图片、音频等任意媒体或文档文件。
whatsapp 的官方 click-to-chat 功能（wa.me 链接）仅支持预填充文本消息，不支持通过 url 参数附加 pdf、图片、音频等任意媒体或文档文件。
WhatsApp Click-to-Chat 是一种轻量级、无需 API 密钥的客户端跳转方案，其设计初衷是快速启动与指定号码的聊天并自动填入一段文本。标准用法如下：
<a href="https://wa.me/441234567890?text=Hello%20World">Chat on WhatsApp</a>
该链接会打开 WhatsApp（Web 或移动 App），跳转至目标联系人对话框，并在输入框中显示已编码的文本内容。但需明确：URL 中的 text 参数是唯一被 WhatsApp 官方识别和处理的查询参数。所有形如 ?data=...、?image=...、?file= 等自定义参数均会被完全忽略——它们既不会触发文件选择界面，也不会触发任何上传行为。
? 为什么有些 App 似乎“发了 PDF”？
你观察到的 App 行为（生成 PDF 后跳转至 WhatsApp 并附带文件）并非通过 wa.me 链接实现，而是依赖以下任一方式：
- ✅ Android Intent / iOS Share Sheet：App 在本地生成 PDF 后，调用系统原生分享能力，将文件传递给 WhatsApp 的分享目标（com.whatsapp 或 whatsapp://send 深度链接 + 文件 URI），此过程绕过 wa.me，需 App 内集成平台特定逻辑；
- ✅ WhatsApp Business Platform API（官方企业 API）：通过服务器端调用 /messages 接口，配合媒体上传流程（先上传二进制文件获取 media_id，再在消息体中引用），支持发送图片、文档、音频等——但这需要认证、审核及后端服务支撑，不属于前端点击跳转范畴；
- ❌ 纯前端 wa.me + URL 参数伪造：无效。例如 <https://wa.me/...?text=Hi&file=report.pdf> 中的 file 参数无任何作用，WhatsApp 客户端不解析也不响应。
⚠️ 注意事项：
- WhatsApp 官方 FAQ 明确指出：“Click to Chat links only support the text parameter.”（来源）
- 尝试添加非法参数不仅无效，还可能导致链接解析失败或被浏览器/WhatsApp 拒绝；
- 若需发送文件，推荐路径为：前端生成文件 → 触发系统分享 → 用户手动选择 WhatsApp 并确认发送（兼容性好，无需权限）；或对接 WhatsApp Business Platform（适合企业级自动化场景）。
✅ 总结：
wa.me 是一个文本导向的快捷入口，不是文件传输协议。它简洁、开放、零依赖，但也因此有明确边界——只传文，不传图，更不传 PDF/DOCX/XLSX 等任意文档。合理管理预期，结合平台能力分层实现，才是可靠落地的关键。
