WhatsApp模板API返回成功但未收到消息的技术咨询
WhatsApp模板API返回成功但未收到消息的排查方案
API返回了包含有效消息ID的成功响应,但目标号码918291413565仍未收到消息,以下是具体的请求和响应内容:
请求内容
{ "messaging_product": "whatsapp", "recipient_type": "individual", "to": "918291413565", "type": "text", "text": { "preview_url": false, "body": "Enter the Descrption" } }
响应内容
{ "messaging_product": "whatsapp", "contacts": [ { "input": "918291413565", "wa_id": "918291413565" } ], "messages": [ { "id": "wamid.HBgMOTE4MjkxNDEzNTY1FQIAERgSN0NFRENCMjQ4N0VEOTYxRTI3AA==" } ] }
可从以下几个方向排查:
- 确认目标号码状态:检查
918291413565是否正常使用WhatsApp,无封号、停机情况,且已激活WhatsApp服务。 - 验证模板合规性:发送的文本
Enter the Descrption必须是预先通过Meta审核的模板内容。若内容与审核通过的模板不一致,即使API返回成功,消息也会被拦截,无法送达。 - 排查延迟问题:跨地区发送消息可能存在10-15分钟的延迟,可等待一段时间后再次确认。
- 检查测试环境限制:如果使用沙箱测试,确认目标号码是否在官方允许的测试号码清单内,沙箱仅支持指定号码接收消息。
- 查看Webhook回调:若配置了Webhook,检查消息状态回调,通过
status字段确认消息是delivered(已送达)还是failed(失败),定位具体问题。
内容的提问来源于stack exchange,提问作者Jai Shiddharth
相关产品推荐
相关产品推荐

