Buttons
You can use buttons with each of these types: call, url and node.
{
"version": "v1",
"content": {
"messages": [
{
"type": "text",
"text": "simple text",
"buttons": [
{
"type": "url",
"caption": "External link",
"url": "https://nicochat.com.br",
},
{
...Another buttons
}
]
},
{
...Another messages
}
],
"actions": [ //optional
{
"action": "add_tag",
"tag_name": "example tag"
},
{
...Another actions
}
],
"quick_replies": [ //optional
{
"type": "node",
"caption": "Quick reply text",
"target": "My Content"
},
{
...Another quick replies
}
]
}
}
Call button
{
"version": "v1",
"content": {
"messages": [
{
"type": "text",
"text": "simple text with button",
"buttons": [
{
"type": "call",
"caption": "Call me",
"phone": "+1 (555) 555-55-55"
}
]
}
],
"actions": [],
"quick_replies": []
}
}
URL button
There are 3 options for webview_size:
full — 100%,
medium — 75%,
compact — 50%
The "webview_size" property is optional.
{
"version": "v1",
"content": {
"messages": [
{
"type": "text",
"text": "simple text with button",
"buttons": [
{
"type": "url",
"caption": "External link",
"url": "https://nicochat.com.br",
"webview_size": "full"
}
]
}
],
"actions": [],
"quick_replies": []
}
}
Go to node button
{
"version": "v1",
"content": {
"messages": [
{
"type": "text",
"text": "simple text with button",
"buttons": [
{
"type": "node",
"caption": "Show",
"target": "My Content"
}
]
}
],
"actions": [],
"quick_replies": []
}
}
The target key must be linked to an existing node within the running flow. The node name appears in its header; use a unique name for the node connected to the link. If there are several nodes with similar names inside the same flow, the transition will not behave as expected. Go to node buttons are not supported in the Public API.
Dynamic block callback button
The "headers" and "payload" properties are optional.
{
"version": "v1",
"content": {
"messages": [
{
"type": "text",
"text": "simple text with button",
"buttons": [
{
"type": "dynamic_block_callback",
"caption": "Dynamic content",
"url": "https://your-service.com/dynamic",
"method": "post",
"headers": {
"x-header": "value"
},
"payload": {
"key": "value"
}
}
]
}
],
"actions": [],
"quick_replies": []
}
}
dynamic_block_callback works the same way as the dynamic block in a content node: when it is clicked, it sends a request to the server, and the server response is sent to the user. The external server URL must use the HTTPS protocol.