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

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

Сообщения каталога

Обновлено: 3 марта 2026 г
Сообщения с каталогом позволяют демонстрировать весь каталог вашей продукции непосредственно в WhatsApp.
В сообщениях каталога отображается выбранное вами изображение-миниатюра товара в заголовке, настраиваемый основной текст, фиксированный текстовый заголовок, фиксированный текстовый подзаголовок и «Просмотреть каталог» .
Пример сообщения в каталоге, демонстрирующий кнопку «Просмотреть каталог»
Когда покупатель нажимает Просмотреть каталог» , ваш каталог товаров появляется в WhatsApp.
Каталог продукции отображается в WhatsApp

Требования

Для этого необходимо загрузить данные о наличии товаров в Meta в каталоге электронной коммерции, подключенном к вашему бизнес-аккаунту WhatsApp .

Синтаксис запроса

Используйте WhatsApp Business Phone Number > Messages , чтобы отправить сообщение из каталога.
ПОЧТА /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID> /сообщения

Пост тело

{ "messaging_product": "whatsapp", "recipient_type": "individual", "to": "<TO> ", "type": "interactive", "interactive" : { "type" : "catalog_message", "body" : { "text": "<BODY_TEXT> " }, "action": { "name": "catalog_message", /* Объект Parameters является необязательным */ "parameters": { "thumbnail_product_retailer_id": "<THUMBNAIL_PRODUCT_RETAILER_ID> " } }, /* Объект нижнего колонтитула необязателен */ "footer": { "text": "<FOOTER_TEXT> " } }

Характеристики

Заполнитель Описание Пример значения
<BODY_TEXT>
Нить
Необходимый.

Текст, который будет отображаться в теле сообщения.

Максимальное количество символов: 1024.
Здравствуйте! Спасибо за ваш интерес. Сделать заказ очень просто. Просто зайдите в наш каталог и добавьте товары для покупки.
<FOOTER_TEXT>
Нить
Необязательный.

Текст, который будет отображаться в нижнем колонтитуле сообщения.

Максимум 60 символов.
Лучшие предложения на продукты в WhatsApp!
<THUMBNAIL_PRODUCT_RETAILER_ID>
Нить
Необязательный.

Артикул товара (SKU). В менеджере по коммерции Content ID

Миниатюрное изображение этого элемента будет использовано в качестве изображения в заголовке сообщения.

Если параметров опущен, будет использоваться изображение товара первого товара в вашем каталоге.
2lc20305pt
<TO>
Нить
Номер телефона клиента.
+16505551234

Пример запроса

curl 'https://graph.facebook.com/v17.0/106540352242922/messages' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer EAAJB...' \ -d ' { "messaging_product": "whatsapp", "recipient_type": "individual", "to": "+16505551234", "type": "interactive", "interactive": { "type": "catalog_message", "body": { "text": "Здравствуйте! Спасибо за ваш интерес. Сделать заказ очень просто. Просто посетите наш каталог и добавьте товары для покупки." }, "action": { "name": "catalog_message", "parameters": { "thumbnail_product_retailer_id": "2lc20305pt" } }, "footer": { "text": "Лучшие предложения на продукты в WhatsApp!" } } }'

Пример ответа

{ "messaging_product": "whatsapp", "contacts": [ { "input": "+16505551234", "wa_id": "16505551234" } ], "messages": [ { "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBI0ODVEREUwQzEzQkVBRjQ1RUUA" } ] }