Meta WhatsApp Cloud API模板消息单号码发送失败问题求助

以下是排查和解决该问题的具体步骤：

• 核对目标号码的有效性与格式
  确保号码是标准国际格式（如+[国家代码][手机号]，无空格、括号或特殊字符），同时确认该号码已正常注册WhatsApp、未注销或停用。部分虚拟号码/VOIP号码可能不支持接收商家模板消息，可换用实体手机号测试。

• 提取Webhook的具体错误信息
  不要只看"failed"状态，查看Webhook返回的error对象，里面的code和message是定位问题的核心：

  • 错误码1006：目标号码未注册WhatsApp
  • 错误码3001：用户已屏蔽你的商家账号
  • 错误码2008：模板内容违反该地区合规政策
  • 错误码4003：号码处于临时接收限制状态

• 验证模板消息的地区合规性
  即使模板在其他地区可用，部分地区可能有更严格的内容审核规则。尝试用最简单的通用模板（如纯文字问候）测试该号码，同时确认模板语言与目标号码所在地区匹配（比如西班牙号码用es_ES语言模板）。

• 恢复与目标号码的互动权限
  如果错误码显示用户已屏蔽账号，可让该号码主动给你的商家号码发送一条普通消息，之后再尝试发送模板消息。WhatsApp允许商家给主动发起对话的用户发送消息，即使之前存在屏蔽记录。

• 排查Meta平台的临时限制
  单个号码可能被系统临时标记，间隔1-2小时后重新测试；同时在Meta Business Manager中检查该号码是否被列入商家账号的黑名单，若有则移除后重试。

• 检查API请求参数细节
  再次核对请求中的to字段格式是否精准，template的name和language是否与审核通过的模板完全一致（大小写、拼写不能有误），避免因参数细微错误导致发送失败。

内容的提问来源于stack exchange，提问作者Awanish Mishra