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

Meta WhatsApp Messages API无法发送带图片标题的模板消息

WhatsApp Cloud API 含媒体元素的模板消息发送失败,无状态更新

问题现象

  • 可正常发送仅含文本变量的WhatsApp消息模板,且能通过Webhook接收完整的消息状态更新
  • 发送带有图片标题的媒体模板消息时,API返回包含wamid的成功响应,但消息从未送达接收端,同时Webhook无任何该消息的状态更新推送,也没有未送达原因提示
  • 普通文本消息及非媒体模板均能正常触发Webhook状态更新

请求体示例(鉴权等信息已确认正确)

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "PHONE_NUMBER",
  "type": "template",
  "template": {
    "name": "request_permission",
    "language": {
      "code": "LANGUAGE_CODE"
    },
    "components": [
      {
        "type": "header",
        "parameters": [
          {
            "type": "image",
            "image": {
              "link": "https://www.gstatic.com/webp/gallery3/1.sm.png"
            }
          }
        ]
      },
      {
        "type": "body",
        "parameters": [
          {
            "type": "text",
            "text": "TEXT_STRING"
          },
          {
            "type": "text",
            "text": "TEXT_STRING"
          }
        ]
      },
      {
        "type": "button",
        "sub_type": "quick_reply",
        "index": "0",
        "parameters": [
          {
            "type": "payload",
            "payload": "PAYLOAD"
          }
        ]
      },
      {
        "type": "button",
        "sub_type": "quick_reply",
        "index": "1",
        "parameters": [
          {
            "type": "payload",
            "payload": "PAYLOAD"
          }
        ]
      }
    ]
  }
}

已尝试的排查动作

  • 更换不同的图片URL、图片格式及来源(均使用无令牌保护的公网URL,符合官方文档要求)
  • 查阅官方模板消息相关文档,确认请求格式无误

已知官方Bug

经核实,该问题为Meta官方已知Bug,两周前已有用户反馈,目前Bug已被识别并分配处理,但尚未修复。受影响用户均反映自定义模板存在消息延迟或发送失败的情况。

内容的提问来源于stack exchange,提问作者Pedro Fernandez

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.07.18 06:10:36