Hey Aravind, allow me to give this a try. I think there might be a workaround here!
Since Meta's WhatsApp API does not support dynamic image headers in templates, a better approach is to bypass template headers entirely and send a separate dynamic media message before the template.
- First, send the dynamic image as a media message via the
POST /api/v2/conversations/messages/agentless API.
This allows you to send any image dynamically without being restricted by template headers, and you can include a caption to provide context.
- Immediately after, send the pre-registered template message (without an image in the header).
This keeps the format structured while allowing flexibility for media.
For example:
- Send image dynamically:
{
"fromAddress": "your_whatsapp_number",
"toAddress": "customer_whatsapp_number",
"provider": "whatsapp",
"media": {
"mediaType": "image",
"url": "https://yourserver.com/dynamic-image.jpg"
},
"text": "Here's the latest update for you!"
}
- Send template message w/o image header:
{
"fromAddress": "your_whatsapp_number",
"toAddress": "customer_whatsapp_number",
"provider": "whatsapp",
"text": "Hi {{1}}, your request has been processed. Let us know if you need further assistance!"
}
Note: Currently, Meta limits dynamic headers in templates. However, by restructuring the way media is sent, you can still create fully personalized WhatsApp messages without the need to manually generate multiple templates. If WhatsApp limitations become a blocker, consider switching the experience to Web Messaging or rich interactive cards in a bot flow. These channels fully support dynamic media content without template restrictions. Let me know what you think, Aravind! Hope this helps.
------------------------------
Julie Kim
Principal Solution Consultant
------------------------------
Original Message:
Sent: 02-11-2025 00:58
From: Aravind Piratla
Subject: Whatsapp Template Dynamic images
What I understood is, we can create the template once on FB with a sample image uploaded in header.
But in Genesys, you'll end up creating multiple templates if you need different images in the header. Feels little weird, but i see that's the only way it works today as they don't offer variables in headers.
------------------------------
Aravind Piratla
Chatbot Lead
------------------------------
Original Message:
Sent: 02-10-2025 12:12
From: Samuel Jillard
Subject: Whatsapp Template Dynamic images
Hi Aravind,
Someone in the community might be able to help, but I would also recommend asking this question in the Genesys Cloud Developer Forum as they may be better placed to answer this.
------------------------------
Sam Jillard
Online Community Manager/Moderator
Genesys - Employees