Шаблоны карусели карточек товаров | Документация для разработчиков
шаблоны карусели карточек товаров
Обновлено: 3 марта 2026 г
Шаблоны карусели товарных карточек позволяют отправлять одно текстовое сообщение, сопровождаемое набором до 10 товарных карточек в горизонтально прокручиваемом режиме:
Когда пользователь WhatsApp нажимает «Просмотреть» , он может увидеть дополнительную информацию о товаре, добавить его в корзину и оформить заказ, не покидая приложение WhatsApp. Если же вы предпочитаете перенаправлять пользователя на свой веб-сайт после нажатия кнопки, см. шаблоны карусели медиа-карточек .
Карточки товаров
Шаблоны карусели поддерживают до 10 карточек товаров, состоящих из основного текста сообщения, изображения товара, названия товара, цены товара и одной кнопки «Посмотреть» или кнопки «Ссылка». Все карточки, определенные в шаблоне, должны иметь одинаковые компоненты.
Когда пользователь WhatsApp нажимает на кнопку, появляется страница с подробной информацией о товаре, взятой из вашего каталога товаров.
Затем пользователи могут добавить товар в корзину и оформить заказ.
Когда пользователь отправляет корзину, веб-хук с описанием заказа, и в переписке появляется сообщение с подтверждением заказа.
Пользователи, оформившие заказ, могут просмотреть его содержимое, нажав Посмотреть подробности» .
Вместо Вид кнопки, которые вы, возможно, захотите использовать URL кнопки. Когда пользователь WhatsApp нажимает на кнопку с URL-адресом для покупки товара, URL-адрес, связанный с этой кнопкой, загружается в приложение устройство'устройство'Это может быть полезно, например, если вы хотите разместить товар на странице оформления заказа в мобильном приложении, где пользователи смогут добавлять промокоды и находить похожие товары.
В случае использования кнопок в URL-адресе, поскольку оформление заказа происходит вне клиента WhatsApp, веб-хуки, описывающие заказ, не срабатывают.
Каталоги
Для использования шаблонов карусели карточек товаров необходимо иметь каталог товаров для электронной коммерции с информацией о наличии товара, подключенный к вашему аккаунту WhatsApp Business. Подробнее о подключении каталога к вашему аккаунту см. в руководстве Commerce
Вебхуки
Создание шаблонов карусели карточек товаров
Синтаксис запроса
curl -X POST"https://graph.facebook.com/v23.0/SS_ACCOUNT_ID>/message_templates"\-ЧАС«Авторизация: Предъявитель»<ACCESS_TOKEN> "\-ЧАС"Content-Type: application/json"\-д '{"имя":"<TEMPLATE_NAME> ","язык":"<TEMPLATE_LANGUAGE> ","категория":«маркетинг»,«компоненты»: [{"тип":"тело","текст":"<MESSAGE_BODY_TEXT> ","пример": {"body_text": [["<MESSAGE_BODY_TEXT_VARIABLE_EXAMPLE_1> ","<MESSAGE_BODY_TEXT_VARIABLE_EXAMPLE_2> "]]}},{"тип":"карусель","карты": [{«компоненты»: [{"тип":"заголовок","формат":"продукт"},{"тип":"кнопки","кнопки": [{"тип":"спм","текст":"Вид"}// Или, для кнопки с URL-адресом, используйте вместо этого следующее:// {// "type": "url",// "текст": "<URL_BUTTON_LABEL_TEXT> ",// "url": "<URL_BUTTON_URL> ",// "пример": [// "<URL_BUTTON_URL_VARIABLE_EXAMPLE> "// ]// }]}]}// Добавьте здесь вторую карточку товара, после sта же структура, что и выше]}]}'
Параметры запроса
| | |
| | |
| | |
| | |
| | |
| | |
| |
Пример запроса
локон 'https://graph.facebook.com/v25.0/161311403722088/message_templates' \
-ЧАС 'Content-Type: application/json' \
-ЧАС «Авторизация: Предъявитель EAAJB...» \
-д ' { "name": "carousel_template_product_cards_v1", "language": "en_US", "category": "marketing", "components": [ { "type": "body", "text": "Редкие суккуленты в продаже! {{1}}, добавьте эти уникальные растения в свою коллекцию. Все три этих редких суккулента доступны для покупки на нашем сайте, и на них распространяется 100% гарантия удовлетворения. Независимо от того,опытный любитель суккулентов или только начинаете собирать свою коллекцию растений, Эти редкие суккуленты непременно произведут впечатление.Магазин сейчас и добавить что-то уникальное и прекрасные растения для вашей коллекции!",
"пример": {
"body_text": "Пабло"
}
},
{
"тип": "карусель",
"карты": [
{
"компоненты": [
{
"тип": "заголовок",
"формат": "продукт"
},
{
"тип": "кнопки",
"кнопки": [
{
"тип": "смп",
"текст": "Вид"
}
]
}
]
},
{
"компоненты": [
{
"тип": "заголовок",
"формат": "продукт"
},
{
"тип": "кнопки",
"кнопки": [
{
"тип": "смп",
"текст": "Вид"
}
]
}
]
}
]
}
]
}'Отправка шаблонов карусели карточек товаров
Синтаксис запроса
curl -X POST"https://graph.facebook.com/v23.0/SS_PHONE_NUMBER_ID>/messages"\-ЧАС«Авторизация: Предъявитель»<ACCESS_TOKEN> "\-ЧАС"Content-Type: application/json"\-д '{"messaging_product":"WhatsApp","recipient_type":"индивидуальный","к":"<WHATSAPP_USER_PHONE_NUMBER> ","тип":"шаблон","шаблон": {"имя":"<TEMPLATE_NAME> ","язык": {"код":"<TEMPLATE_LANGUAGE> "},«компоненты»: [{"тип":"тело","параметры": [{"тип":"текст","текст":"<MESSAGE_BODY_TEXT_VARIABLE_1> "},{"тип":"текст","текст":"<MESSAGE_BODY_TEXT_VARIABLE_2> "}]},{"тип":"карусель","карты": [{"card_index":0,«компоненты»: [{"тип":"заголовок","параметры": [{"тип":"продукт","продукт": {"product_retailer_id":"<PRODUCT_ID_1> ","catalog_id":"<CATALOG_ID> "}}]}// Добавьте здесь дополнительные компоненты (например, кнопки)если ваш шаблон их определяет]}// Добавьте здесь дополнительные карты, увеличивая значение card_inдекс для каждого]}]}}'
Параметры запроса
| | |
| | |
| | |
| | |
| | |
| | |
| |
Пример запроса
локон 'https://graph.facebook.com/v25.0/179776755229976/messages' \
-ЧАС 'Content-Type: application/json' \
-ЧАС «Авторизация: Предъявитель EAAJB...» \
-д ' { "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" } } ] } ] } ] } ] } }'