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

шаблоны карусели карточек товаров

Обновлено: 3 марта 2026 г

Шаблоны карусели товарных карточек позволяют отправлять одно текстовое сообщение, сопровождаемое набором до 10 товарных карточек в горизонтально прокручиваемом режиме:

Когда пользователь WhatsApp нажимает «Просмотреть» , он может увидеть дополнительную информацию о товаре, добавить его в корзину и оформить заказ, не покидая приложение WhatsApp. Если же вы предпочитаете перенаправлять пользователя на свой веб-сайт после нажатия кнопки, см. шаблоны карусели медиа-карточек .

Карточки товаров

Шаблоны карусели поддерживают до 10 карточек товаров, состоящих из основного текста сообщения, изображения товара, названия товара, цены товара и одной кнопки «Посмотреть» или кнопки «Ссылка». Все карточки, определенные в шаблоне, должны иметь одинаковые компоненты.

Просмотреть кнопки

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

Затем пользователи могут добавить товар в корзину и оформить заказ.

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

Пользователи, оформившие заказ, могут просмотреть его содержимое, нажав Посмотреть подробности» .

URL-кнопки

Вместо «Просмотреть можно использовать URL . Когда пользователь WhatsApp нажимает кнопку URL для покупки товара, URL-адрес, связанный с кнопкой, загружается в веб-браузере устройства по умолчанию, что выводит пользователя из интерфейса клиента WhatsApp. Это может быть полезно, например, если вы хотите загрузить товар на страницу оформления заказа в мобильном приложении, где пользователи смогут добавлять промокоды и находить похожие товары.

В случае использования кнопок в URL-адресе, поскольку оформление заказа происходит вне клиента WhatsApp, веб-хуки, описывающие заказ, не срабатывают.

Каталоги

Для использования шаблонов карусели карточек товаров необходимо иметь каталог товаров для электронной коммерции с информацией о наличии товара, подключенный к вашему аккаунту WhatsApp Business. Подробнее о подключении каталога к вашему аккаунту см. в руководстве Commerce

Вебхуки

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

Создание шаблонов карусели карточек товаров

Используйте POST / /message_templates для создания шаблона карусели карточек товаров.

Синтаксис запроса

При создании шаблона достаточно указать всего две карточки товаров. Утвержденный шаблон с двумя карточками товаров позволяет отправлять до 10 карточек в одном сообщении.

curl -X POST
 "https://graph.facebook.com/v23.0/  SS_ACCOUNT_ID>/message_templates" \ -H
 "Авторизация: Bearer" " \ -H
 "Content-Type: application/json" \ -d '
 {
 "name"
 : " " , "язык"
 : " " , "category"
 : "marketing" , "components"
 : [ {
 "type"
 : "body" , "text"
 : " " , "пример"
 : { "body_text"
 : [ [
 " "
 , " "
 ]
 ]
 }
 },
 {
 "type"
 : "carousel" , "cards"
 : [ {
 "components"
 : [ {
 "type"
 : "header" , "format"
 : "product" },
 {
 "type"
 : "buttons" , "buttons"
 : [ {
 "type"
 : "spm" , "text"
 : "View" }
 // ИЛИ, для кнопки URL, используйте вместо этого следующее
 : // {
 // "type": "url",
 // "text": " ",
 // "url": " ",
 // "пример": [
 // " "
 // ]
 // }
 ]
 }
 ]
 }
 // Добавьте сюда вторую карточку товара, используя ту же
 структуру, что и выше ]
 }
 ]
 }'

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

Заполнитель	Описание	Пример значения
`<MESSAGE_BODY_TEXT>` Нить	Необходимый. Текст сообщения. Поддерживает переменные. Максимальное количество символов: 1024.	`Редкие суккуленты в продаже! {{1}}, добавьте эти уникальные растения в свою коллекцию.`
`<MESSAGE_BODY_TEXT_VARIABLE_EXAMPLE>` Нить	Обязательно, если строка текста сообщения использует переменные. Пример текста сообщения в виде строковых переменных. Количество строк должно соответствовать количеству заполнителей переменных в тексте сообщения. Если в тексте сообщения используется одна переменная, `body_text` может быть строкой, в противном случае оно должно быть массивом, содержащим массив строк.	`Пабло`
`<TEMPLATE_LANGUAGE>` Нить	Необходимый. шаблона и код локали .	`en_US`
`<TEMPLATE_NAME>` Нить	Необходимый. Название шаблона. Максимальное количество символов: 512.	`carousel_template_product_cards_v1`
`<URL_BUTTON_LABEL_TEXT>` Нить	Обязательно, если используется кнопка с URL-адресом. Текст надписи кнопки URL. Максимум 25 символов.	`Купить сейчас`
`<URL_BUTTON_URL>` Нить	Обязательно, если используется кнопка с URL-адресом. URL-адрес, который будет загружен в веб-браузере по умолчанию устройства при нажатии пользователем WhatsApp на кнопку. Поддерживается 1 переменная. Заполнитель переменной необходимо добавить в конец строки URL. Максимум 2000 символов.	`https://www.luckyshrub.com/rare-succulents/{{1}}`
`<URL_BUTTON_URL_VARIABLE_EXAMPLE>` Нить	Обязательно, если URL кнопки URL использует переменную. Пример переменной строки для URL-адреса кнопки. Максимум 2000 символов.	`БУДДА`

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

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

curl 'https://graph.facebook.com/ v25.0 /161311403722088/message_templates' \ - H 'Content-Type: application/json' \ - H 'Authorization: Bearer EAAJB...' \ - d ' { "name": "carousel_template_product_cards_v1", "language": "en_US", "category": "marketing", "components": [ { "type": "body", "text": "Редкие суккуленты в продаже! {{1}}, добавьте эти уникальные растения в свою коллекцию. Все три этих редких суккулента доступны для покупки на нашем сайте, и на них распространяется 100% гарантия удовлетворения. Независимо от того, являетесь ли вы опытным любителем суккулентов или только начинаете свою коллекцию растений , эти редкие суккуленты обязательно произведут на вас впечатление . Купите сейчас и добавьте в свою коллекцию несколько уникальных и красивых растений ! ", " пример ": { " body_text ": " Пабло " } }, { " тип ": " карусель ", " карточки ": [ { " компоненты ": " заголовок ", " формат ": " продукт " }, { " тип ": " кнопки ", " кнопки ": [ { " тип ": " spm ", " текст ": " Просмотр " } ] } ] }, { " компоненты ": [ { " тип ": " заголовок ", " формат ": " продукт " }, { " тип ": " кнопки ", " кнопки ": [ { " тип ": " spm ", " текст ": " Просмотр " } ] } ] } ] } ] }

Отправка шаблонов карусели карточек товаров

Синтаксис запроса

Используйте POST / /messages для отправки утвержденного шаблона карусели карточек товаров пользователю WhatsApp.

curl -X POST
 "https://graph.facebook.com/v23.0/  SS_PHONE_NUMBER_ID>/messages" \ -H
 "Авторизация: Bearer " \ -H
 "Content-Type: application/json" \ -d '
 {
 "messaging_product"
 : "whatsapp" , "recipient_type"
 : "individual" , "to"
 : " " , "type"
 : "template" , "template"
 : { "name"
 : " " , "language"
 : { "code"
 : " " },
 "components"
 : [ {
 "type"
 : "body" , "parameters"
 : [ {
 "type" : "text" , "text" : " " }, {
 "type" : "text" , "text" : " " } ]
 },
 {
 "type"
 : "carousel" , "cards"
 : [ {
 "card_index"
 : 0 , "components"
 : [ {
 "type"
 : "header" , "parameters"
 : [ {
 "type"
 : "product" , "product"
 : { "product_retailer_id"
 : " " , "catalog_id"
 : " " }
 }
 ]
 }
 // Добавьте здесь дополнительные компоненты (например, кнопки),
 если ваш шаблон их определяет ]
 }
 // Добавьте здесь дополнительные карточки, увеличивая значение card_in
 dex для каждой ]
 }
 ]
 }
 }'

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

Заполнитель	Описание	Пример значения
`<CARD_INDEX>` Целое число	Необходимый. Порядок отображения карт в карусели определяется нулевой индексацией. `0` обозначает первую карту, `1` — вторую и так далее.	`0`
`<CATALOG_ID>` Нить	Необходимый. Идентификатор подключенного каталога электронной коммерции , содержащего данный товар.	`194836987003835`
`<MESSAGE_BODY_TEXT_VARIABLE>` Объект	Обязательно, если в тексте сообщения шаблона используются переменные; в противном случае опустите. Объект, описывающий переменную сообщения. Если шаблон использует несколько переменных, необходимо определить объект для каждой переменной. Поддерживаются `text` , `currency` и `date_time` . См. Параметры сообщений . Для этого значения нет максимального ограничения по количеству символов, но оно учитывается в общем объеме текста сообщения, который составляет 1024 символа.	`{ "type" : "text" , "text" : "Pablo" }`
`<PRODUCT_ID>` Нить	Необходимый. Идентификатор продукта.	`vrpj01fvwp`
`<TEMPLATE_LANGUAGE>` Нить	Необходимый. шаблона и код локали .	`en_US`
`<TEMPLATE_NAME>` Нить	Необходимый. Название шаблона. Максимальное количество символов: 512.	`carousel_template_media_cards_v1`
`<WHATSAPP_USER_PHONE_NUMBER>` Нить	Необходимый. Номер телефона пользователя WhatsApp.	`+16505551234`

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

В этом примере запроса отправляется утвержденный шаблон с именем «carousel_template_product_cards_v1». Он содержит одно значение переменной в теле запроса (которое требуется шаблону) и три карточки товаров. Каждая карточка указывает, где она должна отображаться в карусели (card_index), а также идентификатор товара и идентификатор каталога, где можно найти подробную информацию о товаре (название, описание, цена и т. д.).

curl 'https://graph.facebook.com/ v25.0 /179776755229976/messages' \ - H 'Content-Type: application/json' \ - H 'Authorization: Bearer EAAJB...' \ - d ' { "messaging_product": "whatsapp", "recipient_type": "individual", "to": "+16505551234", "type": "template", "template": { "name": "carousel_template_product_cards_v1", "language": { "code": "en_US" }, "components": [ { "type": "body", "parameters": [ { "type": "text", "text": "Pablo" } ] }, { "type": "carousel", "cards": [ { "card_index": 0, "components": [ { "type": "header", "parameters": [ { "type": "product", "product": { "product_retailer_id": "vrpj01fvwp", "catalog_id": "194836987003835" } } ] } ] }, { "card_index": 1, "components": [ { "type": "header", "parameters": [ { "type": "product", "product": { "product_retailer_id": "va2l5ioeat", "catalog_id": "194836987003835" } } ] } ] }, { "card_index": 2, "components": [ { "type": "header", "parameters": [ { "type": "product", "product": { "product_retailer_id": "sqpjv0mgde", "catalog_id": "194836987003835" } } ] } ] } ] } ] } ] } }'