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
相关产品推荐
相关产品推荐

