top of page
Search

How to Send Image Messages Using the WhatsApp Official API


Images are one of the most powerful ways to capture customer attention on WhatsApp. Whether you want to share product photos, promotional banners, event posters, or order updates, Image Messages help businesses communicate visually and instantly.

With Hibot and the WhatsApp Official API, you can send high-quality images directly to customers along with an optional caption.


What Are WhatsApp Image Messages?

Image Messages are WhatsApp messages that display a single image inside the chat. Businesses can also include a short caption below the image to provide additional context.

These messages are perfect for:

  • Product images

  • Promotional offers

  • Festival greetings

  • Event announcements

  • Order updates

  • Menu cards

  • Property photos

  • Travel packages

  • Educational posters

For example, an ecommerce business can send a product image with a special discount, while a restaurant can share its latest menu as an image.


Why Businesses Use Image Messages

Image Messages create more engagement than plain text because customers notice visuals faster.

Benefits of using Image Messages with Hibot include:

  • Better customer engagement

  • Higher click and response rates

  • Visually appealing communication

  • Faster sharing of products and offers

  • Improved customer experience on WhatsApp

Since customers spend more time looking at images, businesses can communicate important information more effectively.


How to Send an Image Message with the WhatsApp API

To send an image message, use the following endpoint:

POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages

You need:

  • Your WhatsApp Business Phone Number ID

  • The customer’s WhatsApp number

  • The image type

  • Either a media ID or a hosted image URL

Example API request:

curl 'https://graph.facebook.com/v25.0/<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
-d '
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "<CUSTOMER_PHONE_NUMBER>",
  "type": "image",
  "image": {
    "id": "<MEDIA_ID>",
    "caption": "Check out our latest offer!"
  }
}'

Important Parameters for Image Messages

When sending an image message, you can use the following fields:

Parameter

Description

id

Media ID of an uploaded image. Recommended for better performance.

link

Public image URL hosted on your server.

caption

Optional text displayed below the image. Maximum 1024 characters.

Recommended Method

Hibot recommends uploading your image first and using the media ID instead of a public URL.

This provides:

  • Faster delivery

  • Better reliability

  • More secure image access

  • Improved loading speed inside WhatsApp


Supported Image Formats on WhatsApp

The WhatsApp Official API currently supports the following image formats:

Image Type

Extension

Maximum Size

JPEG

.jpeg

5 MB

PNG

.png

5 MB

Additional requirements:

  • Images must be 8-bit

  • Images must use RGB or RGBA format

Other image formats may not display properly on WhatsApp.


Example: Sending a Product Image

Here is an example of sending an image with a caption:

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

If the request is successful, WhatsApp returns a message ID.

Example response:

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

Best Practices for WhatsApp Image Messages

To improve engagement and deliver the best experience, follow these tips:

  1. Use high-quality images.Blurry or low-resolution images reduce trust and engagement.

  2. Keep the file size small.Even though WhatsApp supports up to 5 MB, smaller images load faster.

  3. Add a clear caption.A short caption helps customers understand the purpose of the image.

  4. Use images with the correct aspect ratio.Avoid images that are too stretched or cropped.

  5. Upload the image before sending.Using a media ID is faster and more reliable than using a hosted URL.

  6. Use relevant visuals.Product images, banners, and real customer photos perform better than generic stock images.


Common Use Cases for Businesses

Ecommerce

Send product photos, new arrivals, sale banners, and order updates.

Restaurants

Share menu images, food photos, and special offers.

Real Estate

Send property images, floor plans, and project visuals.

Travel

Share travel destinations, hotel photos, and holiday packages.

Education

Send posters, notices, certificates, and event updates.

Healthcare

Share health tips, reports, and appointment reminders with images.


Boost Customer Engagement with Hibot

Hibot makes it easy to send image messages using the WhatsApp Official API.

With Hibot, you can:

  • Upload and manage images

  • Send promotional banners instantly

  • Automate product image sharing

  • Improve customer engagement on WhatsApp

  • Deliver better visual communication

Whether you want to promote products, announce offers, or share important updates, Hibot helps you send the right image to the right customer at the right time.

Start using Hibot today and turn WhatsApp conversations into visually engaging customer experiences.

 
 
 

Recent Posts

See All
WhatsApp Template Messages with Hibot API

WhatsApp Template Messages allow businesses to send pre-approved messages to customers even outside the standard 24-hour customer service window. With Hibot’s WhatsApp Official API, template messages

 
 
 
WhatsApp Sticker Messages with Hibot API

WhatsApp Sticker Messages allow businesses to send animated or static stickers directly to customers on WhatsApp. With Hibot’s WhatsApp Official API, you can use stickers to make conversations more en

 
 
 

Comments


bottom of page