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

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

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

Шаблон «Карусель» имеет два формата отправки:

Карусель с карточками товара с произвольным заполнением

Максимальная гибкость под ваш сценарий. Идеально, если важна кастомизация и маркетинговая свобода.

• Вы сами формируете карусель: количество карточек, тексты, переменные и кнопки

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

• Подходит для нестандартных акций, спецпредложений и контента под конкретный сегмент

• Полный контроль над визуалом и смыслом каждой карточки

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

Карусель с карточками товара из вашего каталога WhatsApp

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

• Карточки подтягиваются напрямую из каталога 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"
                  ]
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Пример создания шаблона "Карусель"​ с карточкой товара из WhatsApp

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

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": [
    {
      "type": "BODY",
      "text": "Hi, {{1}}! Summer is here, and we have the freshest produce around!",
       "example": {
        "body_text": [
          [
            "Anna"
          ]
        ]
      }
    },
    {
      "type": "CAROUSEL",
      "cards": [
      /* Первая карточка карусели c товаром, заполнение ID товара */
      /* будет при отправке шаблона */
        {
          "components": [
            {
              "type": "HEADER",
              "format": "PRODUCT"
            },
            {
              "type": "BUTTONS",
              "buttons": [
                {
                  "type": "SPM",
                  "text": "View"
                }
              ]
            }
          ]
        },
         /* Вторавя карточка карусели c товаром, заполнение ID товара */
         /* будет при отправке шаблона */
        {
          "components": [
            {
              "type": "HEADER",
              "format": "PRODUCT"
            },
            {
              "type": "BUTTONS",
              "buttons": [
                {
                  "type": "SPM",
                  "text": "View"
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Параметры	Описание	Пример
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 #2
TEMPLATE_CATEGORY Enum	Обязателен. Категория MARKETING или UTILITY.	MARKETING
TEMPLATE_LANGUAGE Enum	Обязателен. Язык шаблона	en
TEMPLATE_NAME String	Обязателен. Наименование шаблона Максимум 512 символов.	marceting_carousel_01_test
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

Как отправить шаблон Карусель

Отправка шаблона описана в документации API в методе /sendTemplate.

Вы также можете отправить шаблон через раздел в личном кабинете "Кабинет разработчика" →"Тестирование запросов". Чтобы отправить шаблон, необходимо знать namespace, name и language шаблона. Чтобы получить эти данные, вызовите метод "Получить список шаблонов" (/templates).

Некоторые свойства, которые могут вызвать вопросы в методе /sendTemplate.

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

• Имеет свой type - CAROUSEL

• Объект с типом CAROUSEL содержит массив cards. Используется только для данного типа шаблона

• Каждая карточка содержит card_index - порядок появления карточек в карусели карточек.0 означает первую карту, 1 означает вторую карту и т. д

Пример как отправить шаблон "Карусель"​

Пример шаблона из 2-ух карточек. Каждая карточка содержит кнопку быстрого ответа и url-кнопку. Медиа-заголовок - картинка.

POST https://api.1msg.io/{{channel}}/sendTemplate
Content-Type: application/json
Body: {
  "token": "{{token}}",
  "namespace": "{{namespace}}", // Вызовите список шаблонов через метод /templates и найдете namespace для нужного шаблона
  "template": "marceting_carousel_01_test", // name шаблона
  "language": {
    "policy": "deterministic",
    "code": "en" // код language из запроса /templates
  },
  "params": [
    {
   /* Общее текстовое сообщение. Можно опустить, если в тексте нет переменных. */
      "type": "body", 
      "parameters": [
        {
          "type": "text",
          "text": "21OFF" // переменная {{1}} для общего текстового сообщения
        },
        {
          "type": "text",
          "text": "21" // переменная {{2}} для общего текстового сообщения
        }
      ]
    },
    {
      "type": "carousel",
      "cards": [
        /* Первая карточка */
        {
          "card_index": 0,
          "components": [
            {
              "type": "header",
              "parameters": [
                {
                  "type": "image",
                  "image": {
                    "link": "https://img.freepik.com/free-photo/top-view-citric-fruit-slices-table_23-2148495686.jpg"
                  }
                }
              ]
            },
            {
              "type": "button",
              "sub_type": "url",
              "index": 1,  // положение кнопки, начинается с 0. Тут url-кнопка вторая в последовательности, поэтому index=1
              "parameters": [
                {
                  "type": "text",
                  "text": "summer" // параметр в url ссылке
                }
              ]
            },
            {
             /* Текст карточки. Можно опустить, если в тексте не будет переменных. */
              "type": "body",
              "parameters": [
                {
                  "type": "text",
                  "text": "10F" // переменная {{1}} в первой карточке
                },
                {
                  "type": "text",
                  "text": "10" // переменная {{2}} в первой карточке
                }
              ]
            }
          ]
        },
        /* Вторая карточка */
        {
          "card_index": 1, 
          "components": [
            {
              "type": "header",
              "parameters": [
                {
                  "type": "image",
                  "image": {
                    "link": "https://img.freepik.com/free-photo/delicious-background-orange-slices_23-2148231462.jpg"
                  }
                }
              ]
            },
            {
              "type": "button",
              "sub_type": "url",
              "index": 1, // положение кнопки, начинается с 0. Тут url-кнопка вторая в последовательности, поэтому index=1
              "parameters": [
                {
                  "type": "text",
                  "text": "winter" // параметр в url ссылке
                }
              ]
            },
            {
             /* Текст карточки. Можно опустить, если в тексте не будет переменных. */
              "type": "body",
              "parameters": [
                {
                  "type": "text",
                  "text": "30F" // переменная {{1}} во второй карточке
                },
                {
                  "type": "text",
                  "text": "30" // переменная {{2}}  во второй карточке
                }
              ]
            }
          ]
        }
      ]
    }
  ],
  "phone": "[phone]"
}

Пример как отправить шаблон "Карусель"​ с карточкой товара из WhatsApp

Пример шаблона из 2-ух карточек. Каждая карточка содержит кнопку быстрого ответа и url-кнопку. Медиа-заголовок - картинка.

POST https://api.1msg.io/{{channel}}/sendTemplate
Content-Type: application/json
Body: {
  "token": "{{token}}",
  "namespace": "{{namespace}}", // Вызовите список шаблонов через метод /templates и найдете namespace для нужного шаблона
  "template": "marceting_carousel_01_test", // name шаблона
  "language": {
    "policy": "deterministic",
    "code": "en" // код language из запроса /templates
  },
  "params": [
    {
      "type": "body",
      "parameters": [
        {
          "type": "text",
          "text": "Anna"
        }
      ]
    },
    {
      "type": "carousel",
      "cards": [
        /* Первая карточка */
      {
          "card_index": 0,
          "components": [
            {
              "type": "header",
              "parameters": [
                {
                  "type": "product",
                  "product": {
                    "product_retailer_id": "0001",
                    "catalog_id": "{{catalog_id}}"
                  }
                }
              ]
            }
          ]
        },
          /* Первая карточка */
        {
          "card_index": 1,
          "components": [
            {
              "type": "header",
              "parameters": [
                {
                  "type": "product",
                  "product": {
                    "product_retailer_id": "0002",
                    "catalog_id": "{{catalog_id}}"
                  }
                }
              ]
            }
          ]
        }
      ]
    }
  ],
  "phone": "{{phone}}"
}

Как отправить шаблон Карусель как сервисное сообщение

Для отправки Карусель как сервисное сообщение используйте метол /sendCarousel

Для такого способа отправки заранее не надо создавать шаблон Meta.

Пример как отправить "Карусель"​

Пример шаблона из 2-ух карточек. Каждая карточка содержит кнопку 2 кнопки быстрого ответа. Медиа-заголовок - картинка.

POST https://api.1msg.io/{{channel}}/sendCarousel
Content-Type: application/json
Body: {
  "phone": "{{phone}}",
  "params": [
    {
      "type": "body",
      "parameters": [
        {
          "type": "text",
          "text": "Text Body"
        }
      ]
    },
    {
      "type": "CAROUSEL",
      "cards": [
        {
          "card_index": 0,
          "components": [
            {
              "type": "header",
              "parameters": [
                {
                  "type": "image",
                  "image": {
                    "link": "https://test-pick.ru/38eff70e116842949fd3019b226d31db.jpg"
                  }
                }
              ]
            },
            {
              "type": "body",
              "parameters": [
                {
                  "type": "text",
                  "text": "Description card 1"
                }
              ]
            },
            {
              "type": "button",
              "sub_type": "quick_reply",
              "parameters": [
                {
                  "text": "Кнопка",
                  "id": "Buttons1"
                },
                {
                  "text": "Кнопка 2",
                  "id": "Buttons2"
                }
              ]
            }
          ]
        },
        {
          "card_index": 1,
          "components": [
            {
              "type": "header",
              "parameters": [
                {
                  "type": "image",
                  "image": {
                    "link": "https://test-pick.ru/38eff70e116842949fd3019b226d31db.jpg"
                  }
                }
              ]
            },
            {
              "type": "body",
              "parameters": [
                {
                  "type": "text",
                  "text": "Description card 2"
                }
              ]
            },
            {
              "type": "button",
              "sub_type": "quick_reply",
              "parameters": [
                {
                  "text": "Кнопка",
                  "id": "Button3"
                },
                {
                  "text": "Кнопка 2",
                  "id": "Button4"
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Пример как отправить "Карусель"​ с карточкой товара из WhatsApp

Пример шаблона из 2-ух карточек товара из каталога WhatsApp

POST https://api.1msg.io/{{channel}}/sendCarousel
Content-Type: application/json
Body: {
  "phone": "{{phone}}",
  "params": [
    {
      "type": "body",
      "parameters": [
        {
          "type": "text",
          "text": "Text body"
        }
      ]
    },
    {
      "type": "CAROUSEL",
      "cards": [
        {
          "card_index": 0,
          "components": [
            {
              "type": "header",
              "parameters": [
                {
                  "type": "product",
                  "product": {
                    "product_retailer_id": "0001",
                    "catalog_id": "{{catalog_id}}"
                  }
                }
              ]
            }
          ]
        },
        {
          "card_index": 1,
          "components": [
            {
              "type": "header",
              "parameters": [
                {
                  "type": "product",
                  "product": {
                    "product_retailer_id": "0002",
                    "catalog_id": "{{catalog_id}}"
                  }
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}