Choice Message

A choice message is a message that features a number of clickable choice buttons presented to the user. These choices can be text, a URL, a location, or to make a call. You can send a choice message by making a POST request to the /messages:send Conversation API endpoint with the following payload:

{
  "app_id": "{{APP_ID}}",
  "recipient": {
    "contact_id": "{{CONTACT_ID}}"
  },
  "message": {
    "choice_message": {
        "text_message": {
            "text": "Friendly reminder of your appointment tomorrow at 10AM. Please confirm your booking by replying below."
        },
        "choices": [
            {
                "text_message": {
                    "text": "Confirm"
                }
            },
            {
                "text_message": {
                    "text": "Cancel"
                }
            }
        ]
    }
  }
}

The follow sections give examples of how choice messages are rendered in each channel.

WhatsApp

WhatsApp channel provides a limited native support for choice messages. If you only include text choices in your choice message then Conversation API is able to use a rich message format on WhatsApp. Otherwise your message will be transcoded as a text message.

The following images gives an example of a choice message.

Choice Message

SMS

SMS doesn't natively support choice messages. Choice messages are transcoded in plain text. The following image gives an example of a choice message.

Choices Message

Facebook Messenger

Facebook Messenger supports choice messages natively. You can configure the following choice types:

  • Text Choice
  • URL Choice
  • Location Choice

The following image gives an example of a choice message.

Choice Message

Instagram

Instagram supports choice messages natively.

Note

Choice Message will only be supported on Android and iOS Instagram’s apps. Choice message won't be rendered on a web client. Instead, users will see just the text message without the choice buttons.

MMS

MMS doesn't natively support Choice messages therefore they're transcoded and sent as text messages by Conversation API.

The following image gives an example of a choice message.

URL Choice Message

RCS

RCS channel natively supports Choice Messages. You can configure a choice message from the following four choice types:

  • Text Choice
  • URL Choice
  • Call Choice
  • Location Choice

You can send a maximum of 3 choices in one message.

The following image gives an example of a choice message.

Choice Message

Viber Bot

Viber Bot channel natively supports choice messages. The following image gives an example of a choice message.

Choice Message

Viber Business Messages

Viber Business Messages channel provides native support for single choice (URL, Call, or Location) choice messages. The title of the choice has a maximum length of 30 characters, longer content will be truncated. The following image gives an example of a choice message.

URL Choice Message

Telegram

Telegram channel natively supports choice messages. The following image gives an example of a choice message.

Choice Message

Kakaotalk

Kakaotalk supports choice messages natively.

The text of the Choice message has a maximum length of 1000 characters.

The title of the choice in the Choice message has a maximum length of 14 characters.