How to Send Image Messages Using the WhatsApp Official API
- Bot Automation

- Apr 8
- 3 min read
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:
Use high-quality images.Blurry or low-resolution images reduce trust and engagement.
Keep the file size small.Even though WhatsApp supports up to 5 MB, smaller images load faster.
Add a clear caption.A short caption helps customers understand the purpose of the image.
Use images with the correct aspect ratio.Avoid images that are too stretched or cropped.
Upload the image before sending.Using a media ID is faster and more reliable than using a hosted URL.
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.
.png)
Comments