Интерактивные сообщения в карусели товаров | Документация для разработчиков
Интерактивные сообщения в карусели товаров
Обновлено: 3 марта 2026 г
Интерактивная карусель товаров позволяет компаниям отправлять карточки товаров с горизонтальной прокруткой прямо в чате WhatsApp, предоставляя пользователям возможность просматривать товары и взаимодействовать с ними непосредственно в переписке.
Этот формат интегрируется с каталогом товаров и поддерживает действия «Одно сообщение о товаре» (SPM) для каждой карточки, обеспечивая удобный и интерактивный процесс покупок через API WhatsApp Business и мобильные клиенты.
Как создать сообщение для карусели товаров
Сообщение карусели товаров содержит
карточки . Вам необходимо добавить в сообщение 2 объекта карточки, максимальное количество — 10. Каждая карточка находится в cards[] и должна иметь "card_index" от 0 до 9 .Тип каждой карточки должен быть установлен на
"product" , и каждая карточка должна ссылаться на один и тот же "catalog_id" .К сообщению необходимо добавить текст сообщения; заголовки, нижние колонтитулы и кнопки не допускаются.
Наконец, на каждой карточке должны быть указаны идентификаторы товара и каталога:
"product_retailer_id" и "catalog_id" .Объект карты
Параметры запроса
| Заполнитель | Описание | Пример значения |
|---|---|---|
<ACCESS_TOKEN>Нить |
Необходимый.
Системный токен или бизнес-токен . |
|
<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" |
Комментарии отсутствуют
Комментарии отсутствуют