In the Responses section, you can add tabs for some of our supported integrations. This allows you to define default or integration-specific responses. In each tab, you can add up to 10 of the same or different message types. The DEFAULT tab and the integration tabs offer different message types. The integration tabs allow you to add images, cards, and quick replies.
To add integration tabs, either enable the respective integrations on the Integrations page or click on the + sign next to the DEFAULT tab. To add message elements, click the ADD MESSAGE CONTENT button.
Your agent's response can consist of up to 10 sequential messages that you can reorder in the UI.
Types of responses
Text
Text responses are available in all platforms. Your agent can send up to 10 sequential text messages in response to a user input (assuming no other message types are defined in the intent).
To add a new line in the UI, press Shift+Enter.
Facebook Messenger
Hangouts Chat
Kik
LINE
Skype
Slack
Telegram
Viber
You can reference parameter values as described here.
All you need to do is to store the image and provide the public URL in the response for the agent.
Facebook Messenger: jpg, png and gif (animated gifs are supported)
Hangouts Chat
Kik: jpg, 1 MB max size (to send animated gifs, use video format in Custom payload)
LINE: jpeg, 1 MB max size, 240 x 240 max dimensions
Skype: 20 MB max size
Slack: gif, jpeg, png, and bmp
Telegram: 5 MB max size
Viber: jpeg, 1 MB max size
Card
Cards consist of an image, a card title, a card subtitle, and interactive buttons (for sending user queries or opening links). These elements can be combined depending on the platform's requirements:
Cards are not natively supported in Kik, so they are sent as separate elements: image with title, subtitle as a text message, and buttons.
For buttons, only a URL is supported as a postback – in this case, it is displayed as an image with linked URL. If you leave the postback field blank, when such a button is tapped, the button title is sent as a user query to the agent.
LINE
Templates are used to create cards with the Line integration.
Title, subtitle, and at least one button are mandatory.
Title or subtitle or an image is required for a card.
Slack
There are no mandatory fields for cards in Slack – any combination of elements can be used.
Buttons with a URL and with a text postback are supported. Buttons with a URL are displayed as hyperlinks.
Telegram
Either the image URL field or the title field is mandatory.
Buttons with a URL and with a text postback are supported. When tapped, a button with a URL will open a web page, whereas a button with text will send the text as a user query.
Viber
In the 'Card' element, you can send a picture with a title and a subtitle accompanied by up to 3 buttons. None of these 'Card' elements are mandatory in the Viber integration, so you can use them individually.
For images, provide a public URL to a JPEG picture file up to 1MB in size.
Postback for buttons can be defined either as text or a URL.
For text, the button name will appear in the chat as a request from the user, whereas the postback text is sent to the bot and is not visible.
For a URL, the link will be open in a separate window and the URL will be sent in the chat as request from the user. More information about buttons logic can be found in the Viber REST API documentation.
Quick replies
Quick replies are displayed in messengers as clickable buttons with pre-defined user responses. When clicked, the button text is sent to the agent as a user query.
The following sections explain how to set up Quick Replies on each platform.
Requirements/Limitations:
One Quick reply element per intent.
Maximum of 10 replies.
20 character limit per reply.
Facebook Messenger
Quick replies are supported in Facebook Messenger integrations and correspond to a text version of Facebook Messenger quick replies.
When a user clicks one of the buttons, all buttons are dismissed. This prevents the issue where users could click buttons that are attached to old messages in a conversation.
Kik
Quick replies are supported in Kik integrations and correspond to a text version of Suggested response keyboards in Kik with a reduced number of replies and characters.
If you want to use a full version, you can do it through the Custom payload.
When a user clicks one of the buttons, all buttons are dismissed. This prevents the issue where users could click buttons that are attached to old messages in a conversation.
LINE
Templates are used to create quick replies with the Line integration.
When a user clicks one of the buttons, the buttons are dismissed. This prevents the issue where users could click buttons that are attached to old messages in a conversation.
Viber
Quick replies correspond to the text version of Viber Keyboards. You can add up to 10 quick replies.
Custom payload
You can send custom payloads in the JSON format provided in the platforms documentation.
To send a custom payload to Facebook Messenger, Kik, Slack, and Telegram one-click integrations, use the following format:
You can also send a custom payload to self-developed integrations. It won't be processed by Dialogflow, so you'll need to handle it in your own business logic.
See the integration's developer docs for more information:
The Kik mobile client requires that all videos are in mp4 format with h264 video and aac audio. If you provide a video with different specifications, it will be transcoded, which greatly increases the time required to send your messages. For more, please read Kik documentation.
The following example sends a playable video from your Kik bot to a Kik mobile client:
Instead of defining a text response in the 'Text response' element of the 'Response' section, you can do it in the 'Custom payload' element.
It may look like this:
{
"viber": {
"type": "text",
"text": "This text is being sent via Custom Payload"
}
}
Picture
Instead of setting a picture URL in the 'Image' element of the "Response' section, you can do it in the 'Custom payload' element.
Here's an example of how you can send a picture with text via custom payload:
{
"viber": {
"type": "picture",
"text": "New Year picture",
"media": "https://example.com/RichMessagesFiles/new_year_1MB.jpg"
}
}
Maximum picture size is 1MB. Only JPEG format is supported. Other image formats as well as animated GIFs can be sent as URL messages or file messages.
The "text" field value is a string of up to 120 characters long. It can have an empty value, but the field is mandatory.
You can also include an optional "thumbnail" field that contains public URL to the reduced size image of up to 100kb size. Recommended size is 400x400. Only JPEG format is supported.
Video
Your Viber bot can send videos. Here's an example of how the 'Custom payload' element may look for sending a video:
Note the all the fields – "type", "media", "size", and "duration" – are mandatory. Maximum video file size is 50MB. Only MP4 and H264 are supported. Maximum duration of the video is 180 seconds.
You can also add a "thumbnail" field with a URL of a reduced size image (JPEG). Maximum size of the thumbnail is 100kb. Recommended dimensions are 400x400 pixels.
File
Your Viber bot can send files. Here's an example of how the 'Custom payload' element may look for sending a file:
Note that all the fields – "type", "media", "size", and "file_name" – are mandatory. The maximum file size is 50MB. See the list of unsupported file formats. The "size" field has a numeric value and indicates the file size in bytes. The file name can be up to 256 characters including the file extension.
Stickers
Your bot can reply with stickers. Sticker IDs can be found here.
Here's an example of how the custom payload can be defined to send a sticker:
The name field value can be up to 28 characters long. The phone_number field value can be up to 18 characters long.
Keyboards (buttons)
Using the 'Custom payload' element, you can send custom keyboards (buttons) with any of the other message types available for sending via 'Custom payload'.