Content Types - Quick-Reply Buttons

Quick-reply buttons offer a simple and consistent format for menus with up to three options where no additional context is required (e.g., Yes/No answers).

They are more accessible and accurate than requiring a user to type a response. Standardized responses can trigger additional action by a bot or human agent.

Benefits and use cases include

  • Product selection: choosing between subscription packages, product options, etc. 
  • Customer satisfaction prompt: for example, “Did this answer your question?” with “Yes” / “No” / “Need more help” response buttons.
  • Next action prompt: for example, “you flight departs in 24 hours” with “Get boarding pass” / “Change seat” / “See other flight options” response buttons.
image_wa_conversation_rounded_borders_interactive_buttons_quick_reply_1-1-1_message_01_0.35x

In comparison to Call-to-Action Buttons, you cannot assign a URL or phone number to a Quick Reply Button.

When submitting your Message Template, the buttons’ parameters are subject to WhatsApp’s Message Template approval.

Quick Reply Payloads

Each Quick Reply Button can be assigned a different payload, which is then sent back with your user’s answer. This payload enables you to associate an ID that correlates to any kind of ID in your systems, making it easy for you to reference the answer.

API Request for Quick Reply Buttons

When sending a Message Template with Interactive Buttons, you will need to ensure that the " index" matches the button’s position in your Message Template.

For example, if the Quick Reply button is placed in the first position, the index must be set to "0". For Quick Reply Buttons, the index options range from "0"(first position) to "2"(third position).

curl –XPOST https://api.tyntec.com/conversations/v3/messages\
  -H 'Content-Type: application/json' \
  -H 'apikey: <API KEY>' \
  -d '{
{
    "from" : "{{whatsAppBusinessNumber}}",
    "to" : "{{receiverPhoneNumber}}",
    "channel" : "whatsapp",
    "content" : {
        "contentType" : "template",
        "template" : {
            "templateId" : "event_rating",
            "templateLanguage" : "en",
            "components" : {
                "body" : [
                    {
                        "type": "text",
                        "text": "User"
                    },
                    {
                        "type": "text",
                        "text": "WhatsApp Demo"
                    }
 
                ],
                "button" : [
                    {
                        "type" : "quick_reply",
                        "index": 0,
                        "payload" : "event-id123"
                    },
                    {
                        "type" : "quick_reply",
                        "index": 1,
                        "payload" : "event-id123"
                    },
                    {
                        "type" : "quick_reply",
                        "index": 2,
                        "payload" : "event-id123"
                    }
                ]
            }
        }
    }
}