Справка по быстрым ответам

Быстрые ответы позволяют взаимодействовать с получателем с помощью кнопок в сообщении. Когда получатель нажимает кнопку быстрого ответа, ее значение отправляется в переписку и платформа Messenger отправляет событие messages в Webhooks. Быстрые ответы — это тип сообщений в API Send. Информацию об отправке сообщений см. в этой статье.

Информацию о том, как использовать быстрые ответы, см. в этой статье.

Пример запроса

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>"

Пример ответа

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

Свойства

Свойство	Тип	Описание
`text`	Строка	Непустой текст, который отправляется в качестве быстрого ответа. Необходимо задать `text` или `attachment`.
`attachment`	Объект	Вложение, которое отправляется в качестве быстрого ответа. Необходимо задать `text` или `attachment`.
`quick_replies`	Массив<`quick_reply`>	Массив объектов, описывающий кнопки быстрого ответа. Поддерживается не более 13 быстрых ответов.

`quick_reply`

Свойство	Тип	Описание
`content_type`	Строка	Возможные значения: `text` — кнопка с текстом; `user_phone_number` — кнопка, позволяющая получателю отправить номер телефона, связанный с его аккаунтом; `user_email` — кнопка, позволяющая получателю отправить адрес электронной почты, связанный с его аккаунтом.
`title`	Строка	Обязательное свойство, если `content_type` имеет значение text. Текст, который должен отображаться на кнопке быстрого ответа. Максимальное количество символов — 20.
`payload`	Строка, число	Обязательное свойство, если `content_type` имеет значение text. Пользовательские данные, которые будут возвращены через событие Webhooks `messaging_postbacks`. Максимальное количество символов — 1 000. Если задано значение `image_url`, значение может быть пустым.
`image_url`	Строка	*Необязательное свойство.* URL изображения, которое отображается на кнопке быстрого ответа для ответов с текстом. Размер изображения — минимум 24 x 24 пикселя. Изображения большего размера будут обрезаны. Обязательное свойство, если `title` — пустая строка.