如何使用WhatsApp Cloud API通过PHP发送多张图片

安全阿岳

2026-7-25

解决WhatsApp Cloud API发送多张图片的问题

你当前使用的是模板消息，而WhatsApp官方模板的header组件仅支持添加单个媒体（图片/视频/文档），这是平台的硬性限制，所以无法直接通过模板消息实现多张图片发送。以下是两种可行的解决方案：

方案1：拆分发送单张图片消息

直接多次调用单图发送接口，每次发送一张图片，请求体结构如下：

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "NUMBER",
  "type": "image",
  "image": {
    "link": "IMAGE_URL"
  }
}

这种方式无需依赖模板，实现成本低，适合不需要固定话术的场景。

方案2：使用交互式轮播消息一次性展示多张图片

如果需要让用户在一条消息内滑动查看多张图片（可搭配标题/描述），可以使用WhatsApp的交互式轮播（Carousel）消息，请求体示例：

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "NUMBER",
  "type": "interactive",
  "interactive": {
    "type": "carousel",
    "body": {
      "text": "这里填写轮播消息的正文说明"
    },
    "action": {
      "sections": [
        {
          "title": "图片集合",
          "rows": [
            {
              "id": "img_01",
              "title": "图片1标题",
              "image": "IMAGE_URL_1"
            },
            {
              "id": "img_02",
              "title": "图片2标题",
              "image": "IMAGE_URL_2"
            },
            {
              "id": "img_03",
              "title": "图片3标题",
              "image": "IMAGE_URL_3"
            }
          ]
        }
      ]
    }
  }
}