Перейти к основному содержимому

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

Интерактивные сообщения в карусели товаров

Обновлено: 3 марта 2026 г
Интерактивная карусель товаров позволяет компаниям отправлять карточки товаров с горизонтальной прокруткой прямо в чате WhatsApp, предоставляя пользователям возможность просматривать товары и взаимодействовать с ними непосредственно в переписке.
Этот формат интегрируется с каталогом товаров и поддерживает действия «Одно сообщение о товаре» (SPM) для каждой карточки, обеспечивая удобный и интерактивный процесс покупок через API WhatsApp Business и мобильные клиенты.

Как создать сообщение для карусели товаров

Сообщение карусели товаров содержит карточки . Вам необходимо добавить в сообщение 2 объекта карточки, максимальное количество — 10. Каждая карточка находится в cards[] и должна иметь "card_index" от 0 до 9 .
Тип каждой карточки должен быть установлен на "product" , и каждая карточка должна ссылаться на один и тот же "catalog_id" .
К сообщению необходимо добавить текст сообщения; заголовки, нижние колонтитулы и кнопки не допускаются.
Наконец, на каждой карточке должны быть указаны идентификаторы товара и каталога: "product_retailer_id" и "catalog_id" .

Объект карты

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

Заполнитель Описание Пример значения
<ACCESS_TOKEN>
Нить
Необходимый.
EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD
<API_VERSION>
Нить
Необязательный.
Версия Graph API.
v25.0
<MESSAGE_BODY_TEXT>
Нить
Необходимый.
Максимальное количество символов: 1024.
Какой вариант вы предпочитаете?
<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>
Нить
Необходимый.
Идентификатор бизнес-телефона WhatsApp.
106540352242922
<WHATSAPP_USER_PHONE_NUMBER>
Нить
Необходимый.
Номер телефона пользователя WhatsApp.
+16505551234

Параметры объекта Card

Заполнитель Описание Пример значения

Целое число
Обязательно наличие
уникального индекса для каждой карты (0-9). Не должен повторяться в сообщении.
2

Нить
Обязательно.
Уникальный идентификатор розничного продавца товара в каталоге.
"0JkSUu4qizuXv"

Нить
Обязательно.
Уникальный идентификатор каталога, содержащего данный продукт.
"Lq1ZtoWL5OkljTerAW"