Перейти к основному содержимому

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

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

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

Компоненты

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

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

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


    Нить
    Обязательно.

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


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

    Версия API.
    v23.0


    Целое число
    Обязательно.

    Идентификационный номер рабочего телефона.
    106540352242922


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

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


    Целое число
    Обязательно.

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


    Нить
    Обязательно.

    Тип заголовка. Возможные значения:

    image — указывает на заголовок изображения карты;

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

    См. Поддерживаемые типы носителей .
    изображение


    Нить
    Обязательно.

    Общедоступный URL-адрес медиафайла.
    https://www.luckyshrub.com/assets/blue-echeveria.jpeg


    Нить
    Обязательно.

    Основной текст сообщения. Максимальное количество символов: 1024.
    Конечно! Вот три наших последних поступления, каждое по цене менее 25 долларов:


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

    Идентификатор кнопки быстрого ответа. Максимум 256 символов.
    learn-blue-echeveria


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

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


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

    Текст метки кнопки с URL-адресом. Максимум 20 символов.
    Купить сейчас


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

    URL-адрес, который будет загружен в веб-браузере по умолчанию устройства при нажатии пользователем.
    https://shop.luckyshrub.com/latest/blue-echeveria


    Нить
    Обязательно.

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

    Комментарии отсутствуют

    Вернуться наверх