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.

💡
Build it, copy it, paste it

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:

JL
Jane Lee
● WhatsApp
💬 SMS ▾Internal Comment
Type a message…
😊 📎 🧩 🏷️ 🎙️ ➤
Illustration only — a simplified, auto-playing view. Open the builder from the message box; it also does list and carousel messages.
🧩
Turn on the in-GHL builder

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:

WAGHL
📊Dashboard
📱Devices
👥Sub-accounts
🧱Message Builder
🔌JS Scripts
⚙️Settings
WhatsApp Message Builder
ButtonListCarouselPoll
Poll
Which day suits you?
Monday
Tuesday
Wednesday
Preview
Preview · online
Which day suits you?
Monday
Tuesday
Wednesday
Generated string
#poll|Which day suits you?|Monday|Tuesday|Wednesday
Illustration only — a simplified view of the WAGHL panel. Example content.
  • 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).
Need help with this? WhatsApp us at +1 347 308 7143 — quick replies guaranteed.
💬 Message us