Quick Replies Reference

Send API

Quick replies are a message type sent with the Send API. For complete details on sending messages, see the Messages.

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.

For complete usage details, see Quick Replies.

Example Request

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"<PSID>"
  },
  "message":{
    "text": "Here's a quick reply!",
    "quick_replies":[
      {
        "content_type":"text",
        "title":"Search",
        "payload":"<POSTBACK_PAYLOAD>",
        "image_url":"http://example.com/img/red.png"
      },
      {
        "content_type":"location"
      },
      {
        "content_type":"text",
        "title":"Something Else",
        "payload":"<POSTBACK_PAYLOAD>"
      }
    ]
  }
}' "https://graph.facebook.com/v2.6/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

Example Response

{
  "recipient_id": "1254477777772919",
  "message_id": "mid.$cAAJsujCd2ORj_1qmrFdzhVa-4cvO"
}  

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 11 quick replies are supported.

quick_reply

Property Type Description

content_type

String

Must be one of the following

  • text: Sends a text button
  • location: Sends a button to collect the recipient's location

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.

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.