Quick Replies Reference

Quick Replies allow you to get message recipient input by sending buttons in a message. When a quick reply is tapped, the value of the button is sent in the conversation, and the Messenger Platform sends a messages event to you webhook. Quick replies are a message type sent with the Send API. For complete details on sending messages, see Messages.

For complete usage details, see Quick Replies.

Example Request

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"<PSID>"
  },
  "messaging_type": "RESPONSE",
  "message":{
    "text": "Pick a color:",
    "quick_replies":[
      {
        "content_type":"text",
        "title":"Red",
        "payload":"<POSTBACK_PAYLOAD>",
        "image_url":"http://example.com/img/red.png"
      },{
        "content_type":"text",
        "title":"Green",
        "payload":"<POSTBACK_PAYLOAD>",
        "image_url":"http://example.com/img/green.png"
      }
    ]
  }
}' "https://graph.facebook.com/v19.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"    

Example Response

{
  "recipient_id": "1254477777772919",
  "message_id": "AG5Hz2Uq7tuwNEhXfYYKj8mJEM_QPpz5jdCK48PnKAjSdjfipqxqMvK8ma6AC8fplwlqLP_5cgXIbu7I3rBN0P"
}  

Properties

Property Type Description

text

String

Non-empty message text to send with the quick replies. text or attachment must be set.

attachment

Object

An attachment to send with the quick replies. text or attachment must be set.

quick_replies

Array<quick_reply>

An array of objects the describe the quick reply buttons to send. A maximum of 13 quick replies are supported.

quick_reply

Property Type Description

content_type

String

Must be one of the following

  • text: Sends a text button
  • user_phone_number: Sends a button allowing recipient to send the phone number associated with their account.
  • user_email: Sends a button allowing recipient to send the email associated with their account.

title

String

Required if content_type is 'text'. The text to display on the quick reply button. 20 character limit.

payload

String, Number

Required if content_type is 'text'. Custom data that will be sent back to you via the messaging_postbacks webhook event. 1000 character limit.


May be set to an empty string if image_url is set.

image_url

String

Optional. URL of image to display on the quick reply button for text quick replies. Image should be a minimum of 24px x 24px. Larger images will be automatically cropped and resized.


Required if title is an empty string.