Mensajes de imagen - Heybot

En esta referencia, se describen los eventos de activación y el contenido de la carga útil del webhook messages de la cuenta de WhatsApp Business para mensajes que contienen una imagen. El cuerpo del evento contiene directamente el objeto value de Meta (entry[].changes[].value), como se explica en la introducción.

Cuando ocurre

Un usuario de WhatsApp envía una imagen.
Un usuario de WhatsApp reenvía un mensaje con imagen.
Un usuario de WhatsApp envía una imagen a un negocio a través de un anuncio de clic a WhatsApp.

Ejemplos

{
  "messaging_product": "whatsapp",
  "metadata": {
    "display_phone_number": "15550783881",
    "phone_number_id": "106540352242922"
  },
  "contacts": [
    {
      "profile": {
        "name": "Sheena Nelson"
      },
      "wa_id": "16505551234"
    }
  ],
  "messages": [
    {
      "from": "16505551234",
      "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQUQ0N0VFMDA2MTQ0RkJFNkNDNAA=",
      "timestamp": "1750275992",
      "type": "image",
      "image": {
        "caption": "<MEDIA_ASSET_CAPTION>",
        "mime_type": "<MEDIA_ASSET_MIME_TYPE>",
        "sha256": "<MEDIA_ASSET_SHA256_HASH>",
        "id": "<MEDIA_ID>",
        "url": "<MEDIA_URL>"
      }
    }
  ]
}

Si ha sido reenviado 5 veces o menos

Se agrega al mensaje (messages[]) un campo context con la propiedad forwarded

{
  "messaging_product": "whatsapp",
  "metadata": {
    "display_phone_number": "15550783881",
    "phone_number_id": "106540352242922"
  },
  "contacts": [
    {
      "profile": {
        "name": "Sheena Nelson"
      },
      "wa_id": "16505551234"
    }
  ],
  "messages": [
    {
      "from": "16505551234",
      "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQUQ0N0VFMDA2MTQ0RkJFNkNDNAA=",
      "timestamp": "1750275992",
      "type": "image",
      "image": {
        "caption": "<MEDIA_ASSET_CAPTION>",
        "mime_type": "<MEDIA_ASSET_MIME_TYPE>",
        "sha256": "<MEDIA_ASSET_SHA256_HASH>",
        "id": "<MEDIA_ID>"
      },
      "context": {
        "forwarded": true
      }
    }
  ]
}

Si ha sido reenviado más de 5 veces

Se agrega al mensaje (messages[]) un campo context con la propiedad frequently_forwarded

{
  "messaging_product": "whatsapp",
  "metadata": {
    "display_phone_number": "15550783881",
    "phone_number_id": "106540352242922"
  },
  "contacts": [
    {
      "profile": {
        "name": "Sheena Nelson"
      },
      "wa_id": "16505551234"
    }
  ],
  "messages": [
    {
      "from": "16505551234",
      "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQUQ0N0VFMDA2MTQ0RkJFNkNDNAA=",
      "timestamp": "1750275992",
      "type": "image",
      "image": {
        "caption": "<MEDIA_ASSET_CAPTION>",
        "mime_type": "<MEDIA_ASSET_MIME_TYPE>",
        "sha256": "<MEDIA_ASSET_SHA256_HASH>",
        "id": "<MEDIA_ID>"
      },
      "context": {
        "frequently_forwarded": true
      }
    }
  ]
}