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

如何复用Resumable API上传的WhatsApp模板图片哈希,无需二次上传

解决方法

你通过Resumable API上传媒体得到的哈希h,是模板创建阶段用于验证媒体归属的校验值,不能直接用于发送模板消息。要复用该媒体无需二次上传,需按以下步骤操作:

1. 通过哈希查询获取media_id

调用WhatsApp Media API的媒体查询接口,传入你拿到的哈希值,获取对应的media_id:

  • 请求示例(以Graph API v18.0为例):
    GET https://graph.facebook.com/v18.0/{你的电话号码ID}/media?hash=2:c2FtcGxl...&access_token={你的访问令牌}
    
  • 接口返回的响应中会包含该媒体的id字段,这就是你需要的media_id。

2. 使用media_id发送模板消息

将获取到的media_id替换到模板参数中,格式如下:

{
  "type": "header",
  "parameters": [
    {
      "type": "image",
      "image": {
        "id": "{获取到的media_id}"
      }
    }
  ]
}

注意事项

  • 确保你的访问令牌拥有whatsapp_business_messaging和business_management权限。
  • 媒体文件需符合WhatsApp规范:图片格式为JPG/PNG,大小不超过5MB,且无违规内容。
  • 如果查询接口返回媒体不存在,需核对哈希值是否正确,或确认上传的媒体已成功关联到目标模板。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.06.15 20:02:35