Этот документ обновлен.
Перевод (Русский) еще не готов.
Последнее обновление (английский): 9 мар 2023 г.

Общий шаблон

Общий шаблон позволяет отправлять структурированные сообщения с изображением, текстом и кнопками. Общий шаблон с несколькими шаблонами, описанными в массиве elements, служит для отправки кольцевой галереи с горизонтальной прокруткой, причем каждый элемент содержит изображение, текст и кнопки.

Эта функция пока недоступна на ПК.

Содержание

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

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

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

Свойства

recipient

Описание получателя сообщения. Все запросы должны содержать одно из перечисленных ниже свойств для идентификации получателя.

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

recipient.id

Строка

IGSID (ID пользователя в Instagram) получателя сообщения.

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

Строка

Должно быть значение generic.

elements

Массив <element>

Массив объектов element, которые описывают отправляемые экземпляры общего шаблона. Если указать несколько элементов, будет отправлена кольцевая галерея шаблонов с горизонтальной прокруткой. Максимальное число элементов — 10.

message.attachment.payload.elements

Общий шаблон поддерживает до 10 элементов на сообщение. Помимо title должно быть установлено по крайней мере одно свойство.

Имя свойства Тип Описание

title

Строка

Заголовок, отображаемый в шаблоне. Максимальное количество символов — 80.

subtitle

Строка

Необязательное свойство. Подзаголовок, отображаемый в шаблоне. Максимальное количество символов — 80.

image_url

Строка

Необязательное свойство. URL изображения, которое будет отображаться в шаблоне.

default_action

Объект

Необязательное свойство. Действие по умолчанию, выполняемое при нажатии на шаблон. Принимает те же свойства, что и кнопка URL, кроме title.

buttons

Массив <button>

Необязательное свойство. Массив кнопок, добавляемых в шаблон. Поддерживается до 3 кнопок на элемент. Поддерживаются только кнопки postback и web_url.