WhatsApp Cloud API媒体模板创建失败及URL问题求助

1. 正确上传媒体模板避免被拒的要点 #

• 严格遵循媒体规范：图片必须是JPEG/PNG格式，文件大小≤5MB，宽高比在1:1到2:1之间，分辨率不低于500px（避免模糊）。禁止使用带版权水印、敏感内容（暴力/色情/政治）或与模板主题无关的媒体。
• 示例媒体与模板强关联：创建模板时的示例媒体必须和模板文本内容匹配，比如订单通知模板的示例图就得是订单相关的，不能放无关图片。
• 使用官方API上传媒体：通过WhatsApp Business Management API的/media端点上传媒体，上传时指定messaging_product: "whatsapp"，确保媒体被标记为WhatsApp专用，而非通用Facebook媒体。
• 模板分类与内容合规：选择正确的模板分类（如交易通知、营销推广），模板文本不能包含诱导性语言、违规内容，变量（如{{1}}）的使用要符合逻辑。
• 避免外部链接作为示例：创建模板时不要用外部网站的图片链接当示例，必须上传到Meta平台的媒体才会被认可。

2. 正确发送带图片的模板消息 #

• 使用审核通过的模板ID：确保模板已经通过Meta审核，拿到有效的模板ID。
• 用媒体ID而非外部URL：发送时不要直接填图片URL，而是先通过/media端点上传图片，拿到media_id，然后在模板消息的components中指定：

  "message": {
    "template": {
      "name": "你的模板名称",
      "language": { "code": "zh_CN" },
      "components": [
        {
          "type": "header",
          "parameters": [
            {
              "type": "image",
              "image": { "id": "上传后的media_id" }
            }
          ]
        },
        // 其他组件（如body、button）
      ]
    }
  }
  

• 检查媒体权限：上传媒体的应用必须拥有对应WhatsApp业务账号的whatsapp_business_management权限，且媒体属于该业务账号名下，否则Meta无法访问。
• 排查错误码131053：如果还是触发这个错误，先确认media_id是否有效（可以通过GET /{media_id}接口验证），再检查媒体格式是否符合模板要求，若之前用了外部URL，立刻换成媒体ID重试。

3. 获取scontent.whatsapp.net域名的媒体链接 #

• 关联模板审核：通过API上传的媒体初始是lookaside.fbsbx.com域名的临时链接，当你将该媒体作为模板的示例媒体提交审核，且模板审核通过后，Meta会自动将媒体迁移到WhatsApp的CDN，生成scontent.whatsapp.net的永久链接。
• 指定WhatsApp专属上传：上传媒体时务必在请求中添加messaging_product: "whatsapp"参数，确保媒体被归类为WhatsApp专用资源，而非通用Facebook媒体。示例请求：

  curl -X POST "https://graph.facebook.com/v18.0/{WA_BUSINESS_ACCOUNT_ID}/media" \
    -H "Authorization: Bearer {ACCESS_TOKEN}" \
    -F "file=@/path/to/your/image.jpg" \
    -F "type=image/jpeg" \
    -F "messaging_product=whatsapp"
  

• 从审核通过的模板中提取：模板审核通过后，调用GET /{TEMPLATE_ID}接口，返回的模板详情里的示例媒体链接就是scontent.whatsapp.net开头的，你可以直接复用这个链接。

内容的提问来源于stack exchange，提问作者Jonathan