Шаблоны каталога | Документация для разработчиков
Шаблоны каталогов
Обновлено: 3 марта 2026 г
В этом документе объясняется, как создавать шаблоны каталогов. Подробнее о каталогах продукции и способах демонстрации товаров можно узнать «Продажа товаров и услуг»
Шаблоны каталога — это маркетинговые шаблоны, позволяющие полностью продемонстрировать ваш каталог товаров в WhatsApp. Шаблоны каталога отображают миниатюрное изображение товара в заголовке по вашему выбору, настраиваемый основной текст, а также фиксированный текст заголовка и фиксированный текст подзаголовка.
Когда покупатель нажимает Просмотреть каталог» в шаблонном сообщении с каталогом, ваш каталог товаров появляется в WhatsApp.
Создание шаблонов каталога
Требования
У вас должно быть Инвентарь загружен в Meta в каталоге электронной коммерции подключено к вашему аккаунту WhatsApp Business?.
Запрос
синтаксис
curl -X POST "https://graph.facebook.com/<API_VERSION> /<WHATSAPP_BUSINESS_ACCOUNT_ID> /message_templates" \ -H "Авторизация: Bearer"<ACCESS_TOKEN> " \ -H "Content-Type: application/json" \ -d ' { "name": "<NAME> ", "язык": "<LANGUAGE> ", "category": "MARKETING", "components": [ { "type": "BODY", "text": "<BODY_TEXT> ", "пример": { "body_text": [ [ "<EXAMPLE_BODY_TEXT> " ] ] } }, { "type": "FOOTER", "text": "<FOOTER_TEXT> " }, { "type": "BUTTONS", "buttons": [ { "type": "CATALOG", "text": "View catalog" } ] } ] }'
Параметры запроса
<BODY_TEXT>Нить
Необходимый.
Теперь вы можете покупать любимые товары прямо здесь, в WhatsApp! Получите скидку {{1}} рупий на все заказы свыше {{2}} рупий! Действительно для ваших первых {{3}} заказов, оформленных через WhatsApp!<EXAMPLE_BODY_TEXT>Строка (из массива строк)
Обязательно, если в основном тексте используются переменные.
<BODY_TEXT> нить.100<FOOTER_TEXT>Нить
Необязательный.
Лучшие предложения на продукты в WhatsApp!<LANGUAGE>Нить
Необходимый.
en_US<NAME>Нить
Необходимый.
вступительное_каталоговое_предложениеПример
запрос
curl 'https://graph.facebook.com/v17.0/102290129340398/message_templates' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer EAAJB...' \ -d ' { "name": "intro_catalog_offer", "language": "en_US", "category": "MARKETING", "components": [ { "type": "BODY", "text": "Теперь покупайте ваши любимые товары прямо здесь, в WhatsApp! Получите скидку {{1}} рупий на все заказы свыше {{2}} рупий! Действительно для ваших первых {{3}} заказов, размещенных в WhatsApp!", "example": { "body_text": [ [ "100", "400", "3" ] ] } }, { "type": "FOOTER", "text": "Лучшие предложения на продукты в WhatsApp!" }, { "type": "BUTTONS", "buttons": [ { "type": "CATALOG", "text": "View catalog" } ] } ] }'
Пример ответа
{ "id": "546151681022936", "status": "PENDING", "category": "MARKETING" }
Отправка сообщений по шаблону каталога
Вы можете отправлять утвержденные шаблоны каталогов в шаблонном сообщении. Подробнее о каталогах продукции и способах демонстрации товаров можно узнать «Продажа товаров и услуг»
Требования
У вас должно быть Инвентарь загружен в Meta в каталоге электронной коммерции подключено к вашему аккаунту WhatsApp Business?.
Запрос
синтаксис
ОДОБРЕННЫЙcurl -X POST "https://graph.facebook.com/v19.0/<WHATSAPP_BUSINESS_PHONE_NUMBER_ID> /messages" \ -H "Авторизация: Bearer"<ACCESS_TOKEN> " \ -H "Content-Type: application/json" \ -d ' { "messaging_product": "whatsapp", "recipient_type": "individual", "to": "<TO> ", "type": "template", "template": { "name": "<NAME> ", "язык": { "код": <CODE>" }, "components": [ { "type": "body", "parameters": [ { "type": "<TYPE> ", "text": "<TEXT> " } ] }, { "type": "button", "sub_type": "CATALOG", "index": 0, "parameters": [ { "type": "action", "action": { "thumbnail_product_retailer_id": "<THUMBNAIL_PRODUCT_RETAILER_ID> " } } ] } ] } }'</code>
Параметры запроса
<CODE>Нить
Необходимый.
en_US<NAME>Нить
Необходимый.
вступительное_каталоговое_предложение<THUMBNAIL_PRODUCT_RETAILER_ID>Нить
Необязательный.
параметры Если объект отсутствует, будет использовано изображение товара первого экземпляра из вашего каталога.2lc20305pt<TEXT>Нить
Обязательно, если шаблон использует переменные.
100<TO>Нить
Необходимый.
+16505551234<TYPE>Нить
Обязательно, если шаблон использует переменные.
текстПример
запрос
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": "template", "template": { "name": "intro_catalog_offer", "language": { "code": "en_US" }, "components": [ { "type": "body", "parameters": [ { "type": "text", "text": "100" }, { "type": "text", "text": "400" }, { "type": "text", "text": "3" } ] }, { "type": "кнопка", "подтип": "КАТАЛОГ", "индекс": 0, "параметры": [ { "тип": "действие", "действие": { "идентификатор миниатюры продукта_ритейлера": "2lc20305pt" } } ] } ] } }'
Пример ответа
{ "messaging_product": "whatsapp", "contacts": [ { "input": "+16505551234", "wa_id": "16505551234" } ], "messages": [ { "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBI5RkEwM0EyODFEQzQ2NDYzQTMA" } ] }