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

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.07.03 07:10:13