Incoming Media Message

The Incoming Media Message status allows you to receive and process media messages sent by participants in a WhatsApp group. The callback contains relevant media details, sender information, group details, message ID, timestamp, and other metadata required to process and track the incoming media message.

Prerequisites

An active WhatsApp for Business API plan on Kaleyra platform includes:
1. A WhatsApp business number.
2. An associated profile with the business number.
3. A WhatsApp verified and approved profile.
4. A WABA ID onboarded on Kaleyra WhatsApp API V2.
You must have the callback registered in the WhatsApp channel for the phone numbers. Refer WhatsApp Configuration for Callback.

Sample Webhook

The following is the sample webhook.

{
  "meta_object": {
    "field": "messages",
    "value": {
      "contacts": [
        {
          "profile": {
            "name": "John "
          },
          "wa_id": "91XXXXXXXXXX"
        }
      ],
      "messages": [
        {
          "from": "91XXXXXXXXXX",
          "group_id": "Y2FwaV9ncm91cDo5MTc5NjE3MzI4MDY6MTIwMzYzNDIyOTQXXXX0MTU5",
          "id": "wamid.HBgSMTIwMzYzNDIyOTQ0MTU5OTMwFQgAEhgUM0E0QTA0OUUzNDMzNXXXXEJFODIcGAw5MTkzNjA5NDkwODEVAgAA",
          "image": {
            "id": "211XXXXXXXXXX670",
            "mime_type": "image/jpeg",
            "sha256": "1WhwZ9QXmYkUORiTkwWwzDmz9fyuIGelZM97qdXXXXy=",
            "url": "https://lookaside.fbsbx.com/whatsapp_business/attachments/?mid=2116XXXXXXXX7707&source=webhook&ext=1771842064&hash=ARltcUgDMrLni36zy7UJLtc78Q4NI1-0vHvTz0L_TqjNBg"
          },
          "timestamp": "1771841763",
          "type": "image"
        }
      ],
      "messaging_product": "whatsapp",
      "metadata": {
        "display_phone_number": "91XXXXXXXXXX",
        "phone_number_id": "2865XXXXX595271"
      }
    }
  },
  "extra_info": {
    "media_url": "https://example.com/media/XXXXXXXX",
    "reply_to": "waXXX.ORIGINAL_MESSAGE_ID",
    "trace_id": "91454c45-640a-4ee3-9651-ea45XXXXX908",
    "waba_id": "2954XXXXXXXX431"
  }
}