Image header with reply buttons

Overview

The #ButtonMix command with an image header sends a WhatsApp message that pairs a .jpg image with a title, a subtitle and up to three reply buttons. When a contact taps a button, Wazzap returns the button's ID to your CRM so you can branch a workflow on it.

It's the right tool for rating prompts (Good / Bad / Terrible), confirmations (Yes / No / Later), and small visual menus where you want a structured answer instead of free text.

Command syntax

#ButtonMix|Title|Subtitle|image*IMAGE_URL|button*Text1*id_1/button*Text2*id_2/button*Text3*id_3

How it works

1. #ButtonMix declares the message type (media header with interactive buttons).
2. Title is the bold text that appears above the body.
3. Subtitle is the secondary text shown below the title.
4. image*IMAGE_URL is the public URL of a .jpg file. File size depends on your CRM, commonly up to 5 MB.
5. button*Text*id defines each interactive button:
   • Text: the label shown on the button.
   • id: the unique identifier that comes back when the contact taps. Keep it stable so your CRM can route on it.
6. Use 1 to 3 buttons. More than three is not supported.

Example

A rating prompt with three options:

#ButtonMix|How was your visit?|Tap a button to rate us|image*https://wisphub.io/static/img/wisp-bg-5.jpg|button*Good*id_good/button*Bad*id_bad/button*Terrible*id_terrible

Result

1. The contact receives a message with the image, the title, the subtitle, and the three buttons.
2. When they tap, the response is recorded with the matching ID (id_good, id_bad, id_terrible).
3. Your CRM can branch on that ID, for example:
   • Save the rating against the contact.
   • Auto-reply with a thank-you message.
   • Notify the support team when the rating is low.
4. See the HighLevel CRM integration page for how reply IDs flow into the conversation.

Important notes

• The header image must be a .jpg. PNG, WEBP and GIF won't render.
• Max file size is set by your CRM, commonly 5 MB.
• Keep button IDs unique per command. Stable IDs make workflows easier to debug.
• Keep button labels short. WhatsApp truncates long text on small screens.
• Never go beyond 3 buttons. If you need more options, use list buttons.
• As with every Wazzap command, send it from the Conversations tab of your CRM, not from the WhatsApp app on your phone.

Troubleshooting

The image doesn't show, only the buttons

Almost always a file format problem. Confirm the URL ends in .jpg, returns a 200 OK, and that the file is reachable from the public internet. WhatsApp will not follow auth-walled URLs.

The buttons don't appear at all

Check the separators. Buttons are split by / and fields by |. A single stray | or / in your title or label will break the parser. Quote-escape or remove them.