Image Messages

Image messages are messages that display a single image and an optional caption.

Sending Image Messages

Use the POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages endpoint to send an image message to a WhatsApp user.

Request Syntax

POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages

Post Body

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "<WHATSAPP_USER_PHONE_NUMBER>",
  "type": "image",
  "image": {
    "id" : "<MEDIA_ID>", /* Only if using uploaded media */
    "link": "<MEDIA_URL>", /* Only if linking to your media */
    "caption": "<IMAGE_CAPTION_TEXT>"
  }
}

Post Body Parameters

Placeholder	Description	Example Value
`<IMAGE_CAPTION_TEXT>` String	Optional. Image caption text. Maximum 1024 characters.	`The best succulent ever?`
`<MEDIA_ID>` String	Required if using an uploaded media asset (recommended). Uploaded media asset ID.	`1479537139650973`
`<MEDIA_URL>` String	Required if linking to your media asset (not recommended) URL of image asset on your public server. For better performance, we recommend that you upload your media asset instead.	`https://www.luckyshrub.com/assets/succulents/aloe.png`
`<WHATSAPP_USER_PHONE_NUMBER>` String	Required. WhatsApp user phone number.	`+16505551234`

Supported Image Formats

Images must be 8-bit, RGB or RGBA.

Image Type	Extension	MIME Type	Max Size
JPEG	.jpeg	image/jpeg	5 MB
PNG	.png	image/png	5 MB

Example Request

Example request to send an image message with a caption to a WhatsApp user.

curl 'https://graph.facebook.com/v21.0/106540352242922/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "+16505551234",
  "type": "image",
  "image": {
    "id" : "1479537139650973",
    "caption": "The best succulent ever?"
  }
}'

Example Response

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "+16505551234",
      "wa_id": "16505551234"
    }
  ],
  "messages": [
    {
      "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA"
    }
  ]
}