Suggestion buttons appear at the bottom of a text message, rich card or carousel card. Customers tap them to reply or to use a device feature, without leaving their messaging app.
Limits
|
Item |
Limit |
|---|---|
|
Buttons per rich card or carousel card |
4 |
|
Suggestions on a text message |
11 |
|
Button label |
25 characters |
|
Calendar event title |
Required, max 100 characters |
|
Calendar event description |
Optional, max 500 characters |
Button types
|
Button (Campaigns app) |
API action |
What the customer gets |
What you enter |
|---|---|---|---|
|
Visit Website |
Openurl |
Link opens in the browser, or in a WebView inside the messaging app (full, half or tall). If WebView is not supported, the browser is used. |
Label, URL, browser or WebView |
|
Call Phone Number |
Dial |
Dialer opens with the number filled in |
Label, number in international format (for example +31...) |
|
Predefined reply |
Reply |
The button text is sent back as the customer's reply |
Label (for example Yes / No) |
|
Create Calendar Event |
CreateCalendarEvent |
Calendar app opens with the event pre-filled |
Label, title, start and end time, optional description |
|
View Location |
viewLocation |
Maps app opens at the location |
Label, latitude and longitude. The API also supports a query near the user's location and a custom pin label. |
Add a button in the Campaigns app
-
In the card editor, click Add Button.
-
Choose the button type from the drop-down.
-
Enter the label and the type-specific details.
Postback data (payload)
Every button can carry a hidden identifier that is sent back to your systems when the customer taps it. Customers never see it. Example: a button labelled Shop Now with postback promo_summer_clicked. Use it to track which buttons drive engagement, measure conversions and trigger automated follow-ups.
Best practices
-
Put the main action first when you combine button types. This gives the most consistent display on iOS and Android.
-
Keep labels short and clear, for example Call us now or Add to calendar.
-
Use predefined replies for simple choices such as Yes / No, or for surveys and confirmations.
API example
"suggestions": [
{ "action": "Reply", "label": "Tell me more" },
{ "action": "Openurl", "label": "Go to website", "url": "https://www.example.com" },
{ "action": "Dial", "label": "Call us", "dial": { "PhoneNumber": "+31201234567" } }
]
For calendar and location fields, see the developer documentation.
Related
E-learning video
For a walkthrough of each button type, watch the e-learning video on suggestion buttons.