Шаблон Карусель

Шаблон сообщения «Карусель» поддерживается только в Cloud API.

Шаблон Карусель

Шаблон "Карусель" в WhatsApp

Шаблоны карусели позволяют отправлять одно общее текстовое сообщение (1) в сопровождении набора из 10 карточек карусели (2) с горизонтальной прокруткой.

Шаблон пользователи могут просматривать как с мобильных устройств, так и в веб-клиенте WhatsApp.

Возможности шаблона Карусель

  • Подборки помогут показать разный ассортимент товаров или услуг либо рассказать об одной интересующей линейке, но с разными вариациями. Это лучше удовлетворит запрос клиента, а вам увеличит конверсию.

  • Продвигайте новинки, специальные предложения, акции на праздники и т.д.

  • С помощью кнопок ведите вашего клиента к действию - например, предложите записаться на услугу, сделать заказ, открыть сайт и т.д.

Создание шаблона через API

Отличие от базового создания шаблона в добавлении нового типа CAROUSEL в компоненты и массива cards. Полный пример добавления шаблона Карусель добавлен ниже.

Основные правила создания шаблона:

  1. Шаблон обязательно должен иметь общее и объединяющее по контексту текстовое сообщение (1).

  2. Шаблон может содержать от 1 до 10 карточек.

  3. Формат медиа-заголовка и типы кнопок должны быть одинаковыми для всех карточек.

  4. Медиа-заголовок (изображение или видео) и текстовое сообщение обязательны для каждой карточки.

  5. В каждой карточке должно быть не менее 1 кнопки, максимум - две кнопки.

  6. Поддерживаются следующие типы кнопок: "Быстрый ответ", "URL" и "Номер телефона". Кнопки могут быть одного типа или сочетать в себе кнопки быстрого ответа, кнопки телефонного номера или кнопки URL для каждой карточки.

  7. Не забывайте указывать примеры переменных, если вы добавили их в body, ссылку URL кнопок. Иначе шаблон будет отклонен Meta*.

Пример создания шаблона "Карусель"

Ссылки указаны тестовые, при копировании не забудьте указать верные. Пример наполнения взят из источника 360Dialog

POST https://api.1msg.io/{{channel}}/addTemplate
Content-Type: application/json
Body: {
  "token": "{{token}}",
  "name": "marceting_carousel_01_test",
  "allow_category_change": true,
  "category": "MARKETING",
  "language": "en",
  "components": [
    {
      "text": "Summer is here, and we have the freshest produce around! Use code {{1}} to get {{2}} off your next order.",
      "type": "BODY",
      "example": {
        "body_text": [
          [
            "15OFF",
            "15%"
          ]
        ]
      }
    },
    /* Карточки Карусели */
    {
      "type": "CAROUSEL" // новый тип для шаблона Карусель
      "cards": [ 
        {
        /* Первая карточка карусели */
          "components": [ 
            {
              "type": "HEADER",
              "format": "IMAGE", 
              "example": {
                "header_handle": [
                  "https://img.example.com/delicious-background-orange-slices_23-2148231462.jpg"
                ]
              }
            },
            {
              "type": "BODY", 
              "text": "Rare lemons for unique cocktails. Use code {{1}} to get {{2}} off all produce",
              "example": { //Примеры параметров. Количество значений должно соответствовать количеству переменных, включенных в строку.
                "body_text": [
                  [
                    "150FF",
                    "10%"
                  ]
                ]
              }
            },
            {
              "type": "BUTTONS",
              "buttons": [
                {
                  "type": "QUICK_REPLY",
                  "text": "Send more like this #1"
                },
                {
                  "type": "URL",
                  "text": "Buy now",
                  "url": "https://www.luckyshrub.com/shop?promo={{1}}",
                  "example": [
                    "summer_lemons_2023"
                  ]
                }
              ]
            }
          ]
        },
        /* Вторая карточка карусели */
        {
          "components": [
            {
              "type": "HEADER",
              "format": "IMAGE",
              "example": {
                "header_handle": [
                  "https://img.example.com/top-view-citric-fruit-slices-table_23-2148495686.jpg"
                ]
              }
            },
            {
              "type": "BODY",
              "text": "Exotic fruit for unique cocktails! Use code {{1}} to get {{2}} off all exotic produce",
              "example": {
                "body_text": [
                  [
                    "20OFFEXOTIC",
                    "20%"
                  ]
                ]
              }
            },
            {
              "type": "BUTTONS",
              "buttons": [
                {
                  "type": "QUICK_REPLY",
                  "text": "Send more like this #2"
                },
                {
                  "type": "URL",
                  "text": "Buy now",
                  "url": "https://www.luckyshrub.com/shop?promo={{1}}",
                  "example": [
                    "exotic_produce_2023"
                  ]
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}
ПараметрыОписаниеПример

BUBBLE_TEXT

String

Обязателен.

Текстовое сообщение, что выводится выше карточек

Максимум 1024 символов.

Summer is here, and we've got the freshest produce around! Use code {{1}} to get {{2}} off your next order.

BUBBLE_TEXT_VAR_EXAMPLE

Array of strings

Обязателен, если в bubble text используются переменные

Массив примеров строк переменных. Количество значений должно соответствовать количеству переменных, включенных в строку.

"15OFF","15%"

CARD_BODY_TEXT

String

Обязателен.

Описание карточки. Поддерживает переменные

Максимум 160 символов.

Rare lemons for unique cocktails. Use code {{1}} to get {{2}} off all produce.

CARD_BODY_TEXT_VAR_EXAMPLE

Array of strings

Обязателен, если в текст карточки содержит переменные

"15OFF","15%"

CARD_HEADER_FORMAT

Enum

Обязателен. Медиа-формат заголовка

(IMAGE илиVIDEO)

IMAGE

CARD_HEADER_HANDLE

Media asset handle

Обязателен.

Пример отправляемого медиа

QUICK_REPLY_BUTTON_TEXT

String

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

Текст кнопки

Максимум 25 символов.

Send more like this

TEMPLATE_CATEGORY

Enum

Обязателен.

Категория MARKETING или UTILITY.

MARKETING

TEMPLATE_LANGUAGE

Enum

Обязателен.

Язык шаблона

en_US

TEMPLATE_NAME

String

Обязателен.

Наименование шаблона

Максимум 512 символов.

summer_carousel_promo_2023

URL_BUTTON_TEXT

String

Обязателен, если используется URL кнопка

Текст URL-кнопки.

Максимум 25 символов.

Buy now

URL_BUTTON_URL

String

Обязателен, если используется URL кнопка

URL на веб-ресурс, куда будет попадать пользователь при нажатии на кнопку-ссылку.

Поддерживает одну переменную в конце строки

Максимум 2000 символов.

URL_BUTTON_VAR_EXAMPLE

String

Обязателен, если используется URL кнопка

Пример URL на веб-ресурс, куда будет попадать пользователь при нажатии на кнопку-ссылку.

Поддерживает одну переменную в конце строки

Максимум 2000 символов.