How it works
Each interactive message is written as a short message string that starts with a tag, such as #btn, #list, #carousel, #location or #poll. When you send it, WAGHL turns it into the real WhatsApp message — the contact never sees the string.
For example, this string:
#btn|title*Your order|msg*Your order #1042 has shipped!|url*Track order*https://shop.example/track/1042
is sent to the contact as a WhatsApp message with a Track order button.
You don't have to write these by hand. Build the message in the Message Builder (below), click Copy, and paste the string wherever you send messages — a GHL conversation, or a workflow / automation message action. You can still type or edit a string by hand if you prefer.
The message types
Open any type for its format, an example, and a live demo:
The Message Builder
The builder turns a form into the finished message string, with a live phone preview. It covers Button, List, Carousel and Poll, and has a Test Now button to send a test. It's the same builder in two places — inside GoHighLevel, and in the WAGHL panel.
In GoHighLevel
When the WhatsApp message builder tool is on, a builder icon sits in the conversation message box. Open it, fill in the form, click Copy message, and it's pasted into the box ready to send — without leaving GHL:
The builder icon shows up once the tool is enabled. See how to add and enable the Message Builder in GHL — in short: WAGHL panel → JS Scripts → turn on WhatsApp message builder, then reload GoHighLevel.
In the WAGHL panel
The same builder is in your WAGHL panel too — log in to your panel and open Message Builder from the left menu:
- Tabs: Button, List, Carousel, Poll.
- Generated String appears once all required fields are filled; copy it with the copy button.
- Import pastes an existing string back into the form to edit it (supports
#btn,#list,#carousel,#poll). - Test Now: pick a connected number, enter a recipient, and send a real test.
Where you can use it
- the Conversations message box
- the conversation tab on a contact's page
- GHL workflows / automations (any action that sends a message through WAGHL)
- snippets / templates
Good to know
- Tags and keys are lowercase (
#btn,title*) — except#poll, which accepts any case. - The
|character separates parts of the string, so it can't be used inside your own text. - In GoHighLevel the sent message shows as the string. With the Interactive message preview tool on, it shows as a WhatsApp-style card, with Show text to see the string.
- Interactive messages work for contacts, WhatsApp groups and username-only WhatsApp contacts.
Troubleshooting
- The contact got the raw string as text — the string must start exactly with the tag, in lowercase (
#btn|,#list|,#carousel|,#location|), with nothing before it. - Message Builder icon not visible — WAGHL panel → JS Scripts → turn on WhatsApp message builder, then reload GoHighLevel.
- Builder says "unrecognised format" for a poll — the in-GHL builder was cached. Hard-refresh GoHighLevel (Ctrl+Shift+R).