Справка по шаблонам с кнопками

Шаблоны с кнопками позволяют отправлять структурированные сообщения с текстом и кнопками. Полную информацию о реализации см. в этом разделе.

Содержание

URI запроса

https://graph.facebook.com/v19.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>

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

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"<PSID>"
  },
  "message":{
    "attachment":{
      "type":"template",
      "payload":{
        "template_type":"button",
        "text":"What do you want to do next?",
        "buttons":[
          {
            "type":"web_url",
            "url":"https://www.messenger.com",
            "title":"Visit Messenger"
          },
          {
            ...
          },
          {...}
        ]
      }
    }
  }
}' "https://graph.facebook.com/v2.6/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

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

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

Свойства

recipient

Описание получателя сообщения. Все запросы должны включить один из идентификаторов: id, phone_number или user_ref.

СвойствоТипОписание

recipient.id

Строка

PSID, phone_number или user_ref получателя сообщения.

recipient.phone_number

Строка

Необязательно. Номер телефона получателя в формате +1(212)555-2368.


Чтобы отправлять сообщения этим способом, бот должен получить одобрение на поиск клиентов.

recipient.user_ref

Строка

Необязательно.user_ref из плагина с галочкой.

recipient.name

Объект

Необязательно. Требуется, только если phone_number имеет значение. Указывает имя человека в формате:


{"first_name":"John", "last_name":"Doe"}

Если указать имя, вероятность успешного поиска вырастет.

message

Description of the message to be sent.
Property Type Description

message.attachment

Object

An object describing attachments to the message.

message.attachment

Property Type Description

type

String

Value must be template

payload

Object

Полезные данные (payload) шаблона.

message.attachment.payload

Свойство Тип Описание

template_type

Строка

Необходимо указать значение button

text

Строка

Текст в кодировке UTF-8 (не более 640 символов). Этот текст будет отображаться на кнопках.

buttons

Массив<button>

Набор кнопок (от 1 до 3), которые будут представляться как призывы к действию.