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

