You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

WhatsApp API问题:返回200状态但模板消息未送达

WhatsApp API返回200但模板消息未送达(手动纯文本正常)

以下是针对该问题的具体排查方向:

  • 模板审核状态验证
    确认使用的模板(包括官方hello_world模板)是否处于已通过审核状态。在Meta Business Manager的WhatsApp模板管理界面检查,若模板处于“待审核”或“被拒绝”状态,即使API返回200,消息也无法送达。

  • 模板参数与请求结构匹配
    发送模板消息时,参数数量、格式必须与模板定义完全一致。无参数模板需确保components结构正确,无多余字段;带参数模板要保证占位符填充符合要求。同时检查请求体中template字段的language代码是否规范(如en_US),policy需设置为deterministic。

  • 目标号码格式合规性
    接收号码必须严格遵循E.164格式(如+1234567890,无空格、括号等特殊字符)。API返回200仅代表请求结构合法,若号码格式不符合WhatsApp规范,消息会被静默丢弃。

  • 账号配置与权限检查
    若使用测试沙箱账号,需确认测试号码已添加至沙箱白名单;正式账号需完成全部WhatsApp Business Platform配置(手机号验证、商业资产绑定等),确保账号具备模板消息发送权限。

  • Webhook状态回调排查
    开启WhatsApp API的Webhook消息状态通知,查看消息的实际处理状态。API返回200仅表示请求被接收,后续处理失败(如模板未审核、权限不足)会在Webhook中返回具体错误码,可据此定位问题。

内容的提问来源于stack exchange,提问作者Adrian Serrano

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.24 17:27:33