Meta WhatsApp Business API首次主动发送模板消息未送达的原因及解决方法

为什么主动发的首条模板消息无法送达？ #

这是受WhatsApp Business API的核心规则限制，结合你的情况，可能的原因包括：

• 沙盒环境限制：如果账号处于沙盒测试阶段，仅能给预先添加到沙盒测试列表的号码发消息，非测试号码即便用了审核通过的模板也收不到。
• 账号权限不足：若正式账号未完成Meta商业验证，可能无法获得主动发送模板消息的权限。
• 状态确认偏差：API返回的accepted仅代表Meta服务器接收了请求，不代表消息已送达用户设备，最终状态需通过Webhook确认，可能存在模板隐性异常、账号绑定问题等。

如何无需用户先发消息就能发送首条模板消息？ #

针对不同场景，对应解决方案如下：

1. 解除沙盒限制
   • 登录Meta Business Manager，找到WhatsApp Business账号的沙盒设置，将收件人号码添加到测试号码列表，添加后即可给该号码发送模板消息。
2. 完成账号验证配置
   • 正式生产账号需完成Meta的商业验证流程，绑定有效商业实体信息，获取主动发送模板消息的权限。
3. 核对模板与号码细节
   • 再次确认模板状态：确保模板处于Approved（已批准）且Active（激活）状态，无草稿、拒绝标记。
   • 检查号码格式：使用纯数字的E.164格式（如印度号码为91790******，不带加号、空格等符号）。
4. 通过Webhook排查最终状态
   • 配置并监听WhatsApp Webhook事件，查看消息最终状态（如delivered、failed），若为failed，根据错误码（如template_invalid）针对性修复。

内容的提问来源于stack exchange，提问作者Cherridev cherritech