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

Шаблон сообщения «Карусель» поддерживается только в 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 символов.	https://www.luckyshrub.com/shop?promo={{1}}
URL_BUTTON_VAR_EXAMPLE String	Обязателен, если используется URL кнопка Пример URL на веб-ресурс, куда будет попадать пользователь при нажатии на кнопку-ссылку. Поддерживает одну переменную в конце строки Максимум 2000 символов.	https://www.luckyshrub.com/shop?promo=summer_lemons_2023