Rich Messages
Rich messages are special messages with interactive features like buttons, dropdowns, or inputs. They allow an agent to request information from the user via a user input form or to display interactive content. Rich messages can be inserted into a chat message using shortcodes. Shortcodes accept various parameters like title and description. The available rich messages are listed below.
Name | Shortcode | Description |
---|---|---|
Card | Call-to-action card with an image, title, description, link, and more. | |
Slider | Slider of call-to-action cards with an image, title, description, link, and more. You can add up to 10 slides. | |
Slider images | Slider of images. | |
Chips | List of buttons. | |
Buttons | List of buttons. | |
Select | Dropdown list of options. | |
Inputs | List of text inputs. | |
Form to collect the user's email and phone number. All attributes are optional. Follow up settings used as default values. Add the attribute required-messaging-apps="true" to force users to provide their email and phone on messaging apps. | ||
Registration | Registration form. | |
Timetable | Timetable. | |
Articles | Articles with search area. The link attribute is used as fallback message for Facebook Messenger, WhatsApp, Telegram messages. | |
Rating | Agent rating form. To make the rating shortcode work on WhatsApp, Messenger, Telegram you need to use Dialogflow and the chatbot, create a new Intent with rating as input Context, nothing as output Context, a list of the user's most common messages for a positive rating as Training phrases(e.g. good, positive) and { "rating": 1, "force-message": true } as Custom Payload response. For the negative rating create a new intent with same context but replace the training phrases and the custom payload to { "rating": -1, "force-message": true }. The shortcode must include also a title or message. | |
List | Text list. | |
List double | Text list with titles. | |
List image | Text list with titles and images. | |
Table | Table. | |
Button | Display a link or open an article. The attribute target="_blank" is optional and open the link in a new window. The attribute style="link" is optional and change the button design. To open an article on click the link value must be #article-ID, replace ID with the article ID. | |
Video | Display a YouTube or Vimeo video. The value of the attribute type can be youtube or vimeo. The attribute id is the ID of the video, get it from the URL. The attribute height is optional and sets the video height in px. | |
Image | Image. | |
Share | Social share buttons. |
Global parameters
All of the rich messages support the following parameters:
Parameters | Description |
---|---|
The ID of the rich message (used also to save the JSON data). | |
The rich message title. | |
The rich message description that appears underneath the title. | |
The message that appears when the user completes and sends the rich message. The user input is appended to this message. | |
Extra field for optional extra values. |
Rich message response
When a user completes a rich message, the response data is saved in JSON format in the database under table sb_messages and column payload. Example:
Custom rich messages
You can create custom rich messages with your own custom content by going to Settings > Miscellaneous. Currently, custom rich messages are static and there are no interactive options available as there are with shortcodes. However, you can insert custom HTML codes.
HTML codes
When creating a custom rich message, you can use the following codes:
Code | Description |
---|---|
Link with button design. | |
Link. | |
Image that zoom on click. |
Last updated