Интерактивные сообщения в карусели товаров | Документация для разработчиков
Интерактивные сообщения в карусели товаров
Обновлено: 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" } ...Синтаксис запроса
curl 'https://graph.facebook.com/<API_VERSION> /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID> /messages' \ -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>Нить | Необходимый. Системный токен или бизнес-токен . | |
<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> , "type": "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" } ] }