使用WhatsApp Business API发送消息未送达至收件人问题求助

核心排查点 #

• 模板使用合规性
  确认发送时完全复用Facebook审核通过的模板内容，包括变量占位符的替换格式必须严格匹配。比如模板中的{{1}}需替换为实际内容，不能保留占位符，也不能修改模板固定文本（哪怕标点符号差异都可能导致消息被静默拦截）。
• 收件人号码格式
  必须使用国际标准纯数字格式，仅保留开头的+号（可选），不能包含空格、括号、短横线等符号。例如正确格式为+1234567890，而非(123)456-7890或1234567890。
• 消息类型触发规则
  首次给陌生用户发消息必须选择已审核模板消息入口，不能用普通文本消息发送。即使使用模板，也要确认发送时的类型选择正确，避免因触发WhatsApp的反垃圾规则被拦截。
• 账号状态与权限
  检查Facebook Business Manager中你的WhatsApp账号是否无违规限制，比如是否存在发送权限受限、账号异常等提示。
• API日志细节
  不要仅依赖界面的“发送成功”提示，查看API返回的完整响应日志。部分场景下界面显示成功，但实际status为queued而非delivered，日志中的错误码（如1006代表号码无效、2000代表模板问题）能直接定位原因。
• 收件人端限制
  确认收件人未拉黑你的发送号码，且WhatsApp未开启陌生消息屏蔽设置；同时验证收件人设备网络正常，能接收其他WhatsApp消息。

额外验证步骤 #

1. 用同一模板发送给已与你发送号码有过对话的联系人，测试是否能正常接收，排除模板本身的问题。
2. 在Facebook Business Manager的「消息报告」中查看消息实际送达状态，该数据比API界面提示更准确。
3. 确认发送号码已完成WhatsApp Business API绑定验证，且归属的Business Manager账号与模板审核账号为同一主体。

内容的提问来源于stack exchange，提问作者Sami Shammah