Programs

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 your 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/v24.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.

Build with Meta

News

Support

Terms and policies

About

Careers

Terms