Интерактивные сообщения в виде карусели | Документация для разработчиков

Интерактивные сообщения в виде карусели

Обновлено: 22 декабря 2025 г

Интерактивная карусель сообщений отображает набор горизонтально прокручиваемых карточек с медиаконтентом. Каждая карточка может содержать заголовок в виде изображения или видео, основной текст и либо кнопки быстрого ответа, либо кнопку для перехода по ссылке.

Например, это интерактивное сообщение в виде карусели из медиакарточек, отображающее три карточки в прокручиваемой области (выделены пунктирным прямоугольником), каждая из которых содержит заголовок с изображением, основной текст и кнопку URL:

Это то же самое сообщение, но вместо кнопок URL используются кнопки быстрого ответа:

Компоненты

Сообщения должны включать от 2 до 10 открыток.Основной текст сообщения обязателен.Заголовки, нижние колонтитулы и интерактивные компоненты основного сообщения не поддерживаются.В заголовке карточки должно быть либо изображение, либо видео. Другие типы заголовков не поддерживаются.Текст основного содержимого карточки необязателен.Карточки должны содержать либо одну кнопку URL, либо одну или несколько кнопок быстрого ответа. Типы и количество кнопок должны совпадать на всех карточках (например, если вы определили карточку с двумя кнопками быстрого ответа, то на всех карточках должно быть ровно две кнопки быстрого ответа).

Запрос синтаксис

curl 'https://graph.facebook.com/<API_VERSION>/<Идентификатор номера бизнес-телефона>/messages' \
-H 'Content-Type: application/json' \
-H 'Авторизация: Предъявитель' <ТОКЕН ДОСТУПА>' \
-д '
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "к": "<НОМЕР_ТЕЛЕФОНА_ПОЛЬЗОВАТЕЛЯ>",
  "type": "interactive",
  "интерактивный": {
    "type": "carousel",
    "тело": {
      "текст": "<СООБЩЕНИЕ_ТЕКСТ_ТЕЛА>"
    },
    "действие": {

<!-- First card object -->
      "карты": [
        {
          "card_index": <КАРТОЧНЫЙ_ИНДЕКС>,
          "type": "cta_url",
          "заголовок": {
            "тип": "<HEADER_TYPE>",
            "<HEADER_TYPE>": {
              "связь": "<MEDIA_ASSET_URL>"
            }
          },

<!-- Card body text is optional -->
          "тело": {
            "текст": "<CARD_BODY_TEXT>"
          },

          "действие": {
<!-- Only if using a URL button -->
            "name": "cta_url",
            "параметры": {
              "display_text": "<URL_BUTTON_LABEL>",
              "url": "<URL_BUTTON_URL>"
            }
<!-- Only if using one or more quick-reply buttons -->
            "кнопки": [
              {
                "type": "quick_reply",
                "quick_reply": {
                  "идентификатор": "<Идентификатор кнопки быстрого ответа>",
                  "заголовок": "<Метка кнопки быстрого ответа>"
                }
              },
<!-- Additional quick-reply buttons would follow -->
          }
        },
<!-- Additional card objects would follow -->
      ]
    }
  }
}'

Параметры запроса

Заполнитель Описание Пример значения

Нить

Необходимый.

Токен доступа.

EAAJB...

Нить

Необязательный.

Версия API.

v23.0

Целое число

Необходимый.

Идентификатор номера служебного телефона.

106540352242922

Нить

Необязательный.

Основной текст карточки. Максимум 160 символов, до 2 переносов строк.

*Синяя эхеверия*\n\nСуккулент в форме розетки с нежно-голубыми листьями, идеально подходящий для украшения любого помещения.

Целое число

Необходимый.

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

0

Нить

Необходимый.

Тип заголовка. Значение может быть следующим:

изображение —- Указывает на заголовок изображения карты.

видео —- Указывает на заголовок видеокарты.

Видеть Поддерживаемые типы носителей.

изображение

Нить

Необходимый.

Общедоступный URL медиафайла.

https://www.luckyshrub.com/assets/blue-echeveria.jpeg

Нить

Необходимый.

Основной текст сообщения. Максимальное количество символов: 1024.

Конечно! Вот три наших последних поступления, каждое по цене менее 25 долларов:

Нить

Обязательно при использовании кнопки быстрого ответа.

Идентификатор кнопки быстрого ответа. Максимальное количество символов: 256.

learn-blue-echeveria

Нить

Обязательно при использовании кнопки быстрого ответа.

Текст для надписи кнопки быстрого ответа. Максимум 20 символов.

Узнать больше

Нить

Обязательно, если используется кнопка с URL-адресом.

Текст надписи на кнопке URL. Максимум 20 символов.

Купить сейчас

Нить

Обязательно, если используется кнопка с URL-адресом.

URL-адрес для загрузки в ~~устройство'~~устройство's — веб-браузер по умолчанию при нажатии пользователем.

https://shop.luckyshrub.com/latest/blue-echeveria

Нить

Необходимый.

Номер телефона пользователя WhatsApp.

16505551234

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

Пример кнопок URL

В этом примере запроса отправляется сообщение в виде медиа-карусели, состоящее из 3 карточек, каждая из которых содержит заголовок с изображением, основной текст карточки и кнопку с URL-адресом.

локон'https://graph.facebook.com/v23.0/106540352242922/сообщения \
-ЧАС'Content-Type: application/json' \
-ЧАС«Авторизация: Предъявитель EAAJB...» \
-д'
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "к": "16505551234",
  "type": "interactive",
  "интерактивный": {
    "type": "carousel",
    "тело": {
      "текст": "Конечно! Вот три наших лаТестовые прибытия, каждое менее чем за 25 долларов:
    },
    "действие": {
      "карты": [
        {
          "card_index": 0,
          "type": "cta_url",
          "заголовок": {
            "type": "image",
            "изображение": {
              "ссылка": "https://www.luckyshrub.com/assets/blue-echeveria.jpeg"
            }
          },
          "тело": {
            "text": "*Голубая Эхеверия*\n\nРозеткаСуккулент в форме буквы «-» с голубоватыми листьями, идеально подходящий для..для того, чтобы оживить любое пространство
          },
          "действие": {
            "name": "cta_url",
            "параметры": {
              "display_text": "Купить сейчас",
              "url": "https://shop.luckyshrub.com/latest/blue-echeveria"
            }
          }
        },
        {
          "card_index": 1,
          "type": "cta_url",
          "заголовок": {
            "type": "image",
            "изображение": {
              "ссылка": "https://www.luckyshrub.com/assets/zebra-haworthia.jpeg"
            }
          },
          "тело": {
            "текст": "*Зебровая хавортия*\n\nПоразительный Белые полосы на темно-зеленых листьях придают этому сорту особый шарм"Придать образу сочность, смелый, современный вид."
          },
          "действие": {
            "name": "cta_url",
            "параметры": {
              "display_text": "Купить сейчас",
              "url": "https://shop.luckyshrub.com/последняя/зебра-хавортия"
            }
          }
        },
        {
          "card_index": 2,
          "type": "cta_url",
          "заголовок": {
            "type": "image",
            "изображение": {
              "ссылка": "https://www.luckyshrub.com/assets/panda-plant.jpeg"
            }
          },
          "тело": {
            "текст": "*Растение Панда*\n\nМягкий, пушистый листья с шоколадно-коричневыми краями — очаровательные и «Легко в уходе»
          },
          "действие": {
            "name": "cta_url",
            "параметры": {
              "display_text": "Купить сейчас",
              "url": "https://shop.luckyshrub.com/latest/panda-plant"
            }
          }
        }
      ]
    }
  }
}'

Пример кнопок быстрого ответа

В этом примере запроса отправляется сообщение в виде медиа-карусели, состоящее из 3 карточек, каждая из которых содержит заголовок с изображением, основной текст карточки и две кнопки быстрого ответа.

локон'https://graph.facebook.com/v23.0/106540352242922/сообщения \
-ЧАС'Content-Type: application/json' \
-ЧАС«Авторизация: Предъявитель EAAJB...» \
-д'
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "к": "16505551234",
  "type": "interactive",
  "интерактивный": {
    "type": "carousel",
    "тело": {
      "текст": "Конечно! Вот три наших лаТестовые прибытия, каждое менее чем за 25 долларов:
    },
    "действие": {
      "карты": [
        {
          "card_index": 0,
          "type": "cta_url",
          "заголовок": {
            "type": "image",
            "изображение": {
              "ссылка": "https://www.luckyshrub.com/assets/blue-echeveria.jpeg"
            }
          },
          "тело": {
            "text": "*Голубая Эхеверия*\n\nРозеткаСуккулент в форме буквы «-» с голубоватыми листьями, идеально подходящий для..для того, чтобы оживить любое пространство
          },
          "действие": {
            "кнопки": [
              {
                "type": "quick_reply",
                "quick_reply": {
                  "id": "learn-blue-echeveria",
                  "title": "Узнать больше"
                }
              },
              {
                "type": "quick_reply",
                "quick_reply": {
                  "id": "fav-blue-echeveria",
                  "title": "Добавить в избранное"
                }
              }
            ]
          }
        },
        {
          "card_index": 1,
          "type": "cta_url",
          "заголовок": {
            "type": "image",
            "изображение": {
              "ссылка": "https://www.luckyshrub.com/assets/zebra-haworthia.jpeg"
            }
          },
          "тело": {
            "текст": "*Зебровая хавортия*\n\nПоразительный Белые полосы на темно-зеленых листьях придают этому сорту особый шарм"Придать образу сочность, смелый, современный вид."
          },
          "действие": {
            "кнопки": [
              {
                "type": "quick_reply",
                "quick_reply": {
                  "id": "учить-зебра-хавортия",
                  "title": "Узнать больше"
                }
              },
              {
                "type": "quick_reply",
                "quick_reply": {
                  "id": "fav-zebra-haworthia",
                  "title": "Добавить в избранное"
                }
              }
            ]
          }
        },
        {
          "card_index": 2,
          "type": "cta_url",
          "заголовок": {
            "type": "image",
            "изображение": {
              "ссылка": "https://www.luckyshrub.com/assets/panda-plant.jpeg"
            }
          },
          "тело": {
            "текст": "*Растение Панда*\n\nМягкий, пушистый листья с шоколадно-коричневыми краями — очаровательные и «Легко в уходе»
          },
          "действие": {
            "кнопки": [
              {
                "type": "quick_reply",
                "quick_reply": {
                  "id": "learn-panda-plant",
                  "title": "Узнать больше"
                }
              },
              {
                "type": "quick_reply",
                "quick_reply": {
                  "id": "fav-panda-plant",
                  "title": "Добавить в избранное"
                }
              }
            ]
          }
        }
      ]
    }
  }
}'

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

{
"messaging_product": "WhatsApp",
"контакты": [
    {
"вход": "+16505551234",
"ва_ид": "16505551234"
    }
  ],
"сообщения": [
    {
"идентификатор": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA"
    }
  ]
}