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

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

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

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

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

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

Объект карты​



... { "card_index": 0, "type": "product", "action": { "product_retailer_id": "abc123xyz", "catalog_id": "123456789" } ...
Синтаксис запроса




локон
'https://graph.facebook.com/<API_VERSION> /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID> /сообщения'

-H 'Content-Type: application/json' -H 'Authorization: Bearer'<ACCESS_TOKEN> ' \ -d '{ "messaging_product": "whatsapp", "recipient_type": "individual", "to": "<WHATSAPP_USER_PHONE_NUMBER> ", "type": "interactive", // должен быть интерактивным "interactive": { "type": "carousel", // должен быть каруселью "body": { "text": "<MESSAGE_BODY_TEXT> " }, "action": { "cards": [ { "card_index": 0, "type": "product", "action": { "product_retailer_id": "abc123xyz", "catalog_id": "123456789" } } // дополнительные карточки товаров ] } } }'
Параметры запроса








Заполнитель 

Описание 

Пример значения 






<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




...

{

"card_index":


<INDEX>,
"тип":
"product", "action": { "product_retailer_id": "<PRODUCT_RETAILER_ID> ", "catalog_id": "<CATALOG_ID> " } ...

Заполнитель 


Описание 

Пример значения 







Целое число





Необходимый
 Для каждой карты предусмотрен уникальный индекс (0-9). Не должен повторяться в сообщении.





2







Нить





Необходимый
 Уникальный идентификатор розничного продавца товара в каталоге.





"0JkSUu4qizuXv"







Нить





Необходимый
 Уникальный идентификатор каталога, содержащего данный продукт.





"Lq1ZtoWL5OkljTerAW"
Пример запроса
{ "messaging_product": "whatsapp", "recipient_type": "individual", "to": "1234567890", "type": "interactive", "interactive": { "type": "carousel", "body": { "text": "Ознакомьтесь с нашими рекомендуемыми товарами!" }, "action": { "cards": [ { "card_index": 0, "type": "product", "action": { "product_retailer_id": "abc123xyz", "catalog_id": "123456789" } }, { "card_index": 1, "type": "product", "action": { "product_retailer_id": "def456uvw", "catalog_id": "123456789" } } ] } } }
Пример ответа
{ "messaging_product": "whatsapp", "contacts": [ { "input": "+16505551234", "wa_id": "16505551234" } ], "messages": [ { "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA" } ] }

    
        

    


            

        

    


    


    
    

        

             Вернуться наверх