Docs › Buttons and lists · Leggi in italiano
Buttons and lists
One line of text sends a message with buttons or a pick list. Write it in the GoHighLevel message: in Conversations, a workflow or a bulk send.
The syntax is the same as GoGHL: lines made with builder.goghl.ai work as they are.
The rules
- Parts are separated by
|, a button's fields by*, list items by/. - A field you do not want is written
undefined, never left empty. - 1 to 10 buttons per message.
- Images, videos and documents only from
https://links. - If the line has a mistake (a required field missing, an unknown type, too many buttons) it goes out as plain text, as written.
{Hi|Hello}picks one variant at random on each send (in texts, not in ids and links).
Button message
#btn|message text|small text below|media|type*text*value|type*text*value
The message text is required. The small text and the media are optional (undefined).
Quick reply
The customer taps and replies with the button's text.
#btn|Hi {{contact.first_name}}! Can you confirm your appointment?|Rossi Clinic|undefined|quick_reply*Confirm*confirm|quick_reply*Reschedule*reschedule
Open a website
#btn|Our catalog is online|undefined|undefined|cta_url*Visit site*https://example.com
Call a number
#btn|Need help?|undefined|undefined|cta_call*Call us*+15551234567
Copy a code
#btn|Here is your discount|Valid until Sunday|undefined|cta_copy*Copy code*SAVE10
WhatsApp call
#btn|Rather talk it through?|undefined|undefined|voice_call*Call me*voice_call
With an image, video or document
#btn|Deal of the week|undefined|image*https://example.com/promo.jpg|cta_url*See the deal*https://example.com|cta_copy*Copy code*SAVE10
#btn|See how it works|undefined|video*https://example.com/demo.mp4|quick_reply*I'm interested*interested
#btn|Your quote|undefined|document*https://example.com/quote.pdf*quote.pdf|quick_reply*Accept*accept|quick_reply*I have questions*questions
List (pick menu)
#list|title|description|footer|button text|Section*Item*Description*id/Section*Item*Description*id
- The description is required; title, footer and button text are optional.
- Without a button text, the button reads "View Options".
- Items with the same section name go into the same section, in any order.
#list|Opening hours|Pick a time|Rossi Clinic|See times|Morning*09:00*undefined*h9/Morning*11:00*undefined*h11/Afternoon*15:00*undefined*h15
What the customer sees
- Up to 3 quick replies: buttons under the message, with an image or video too.
- More than 3 quick replies without media: they become a list with the same items.
- With a site, call, copy or WhatsApp call button: a button message. In this case, on iPhone, quick replies in the same message may stay grey: if you need them, send them in a separate message.
What arrives in GoHighLevel
- When the customer taps a quick reply or a list item, GoHighLevel gets a message with the button's text (for example "Confirm"). The conversation reads naturally and workflow "contains" triggers work.
- Site, call, copy and WhatsApp call buttons send no reply.
- In the GoHighLevel conversation your message stays as the line you wrote (
#btn|...).
In groups
WhatsApp shows no buttons in groups. A group gets readable text, never the #btn|... line: the message text and numbered choices, for example 1) Confirm, 2) Visit site: https://example.com. With media, the media goes with that text as its caption. Members reply by typing.