Quick Replies

Quick Replies are buttons with a set of pre-defined short replies that appear underneath the message bubble, making the keyboard less important. When a button is tapped, the message is sent as a text and you'll receive it to your webhook. Each button can only be tapped once.

Quick Replies can be attached to a Text Message type in the content.quick_replies attribute.

{
  "channel": { ... },
  "contact": { ... },
  "content": {
    "type": "...",
    "payload": "...",
    "quick_replies": [
      { "..." },
      { "..." },
      { "..." }
    ]
  }
}

Parameter

Type

Description

quick_replies

array of objects

Holds a list of up to 3 objects of Text Quick Reply type.

Text Quick Reply

Text Quick Replies show buttons with text and optionally a small image icon. Each button also holds a developer-defined payload, which is invisible to the user but can be used for automated processing. When the user taps on the button, it fires Message Received webhook with text and developer payload if specified.

...
"quick_replies": [
  {
    "type": "text",
    "title": "Pilsner Urquell",
    "payload": "DEVELOPER_DEFINED_PAYLOAD",
  },
  {
    "type": "text",
    "title": "Heineken",
    "payload": "DEVELOPER_DEFINED_PAYLOAD",
  }
]
...

Parameter

Type

Description

type*

string

Must be set to text.

title*

string

Button title with limit of 20 character; longer text gets truncated.

payload*

string

Developer-defined payload with limit of 256 character. This payload is delivered back together with title as a text message in Message Received webhook.