Шаблоны каталога | Документация для разработчиков
Шаблоны каталогов
Обновлено: 3 марта 2026 г
В этом документе объясняется, как создавать шаблоны каталогов. Подробнее о каталогах продукции и способах демонстрации товаров можно узнать «Продажа товаров и услуг»
Шаблоны каталога — это маркетинговые шаблоны, позволяющие полностью продемонстрировать ваш каталог товаров в WhatsApp. Шаблоны каталога отображают миниатюрное изображение товара в заголовке по вашему выбору, настраиваемый основной текст, а также фиксированный текст заголовка и фиксированный текст подзаголовка.
Когда покупатель нажимает Просмотреть каталог» в шаблонном сообщении с каталогом, ваш каталог товаров появляется в WhatsApp.
Создание шаблонов каталога
Требования
Для этого необходимо загрузить данные о наличии товаров в Meta в каталоге электронной коммерции, подключенном к вашему бизнес-аккаунту WhatsApp .
Синтаксис запроса
используйте «Шаблоны сообщений» в разделе «Аккаунт WhatsApp Business» > «Шаблоны сообщений» . После утверждения шаблона вы сможете использовать Cloud API для его отправки в шаблонном сообщении.
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>Нить | Необходимый. Шаблон основного текста. Поддерживаются переменные. Максимальное количество символов: 1024. | |
<EXAMPLE_BODY_TEXT>Строка (из массива строк) | Обязательно, если в основном тексте используются переменные. Примеры строк для замены заполнителей переменных в Максимальное количество символов: 1024. | 100 |
<FOOTER_TEXT>Нить | Необязательный. Шаблон текста нижнего колонтитула. Поддерживаются переменные. Максимум 60 символов. | Лучшие предложения на продукты в WhatsApp! |
<LANGUAGE>Нить | Необходимый. шаблона и код локали . | en_US |
<NAME>Нить | Необходимый. Название шаблона. Максимальное количество символов: 512. | вступительное_каталоговое_предложение |
Пример запроса
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 .
Синтаксис запроса
Используйте WhatsApp Business Phone Number > Messages , чтобы отправить сообщение с шаблоном каталога, имеющим
APPROVED .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>Нить | Необязательный. Артикул товара (SKU). В менеджере по коммерции обозначен как Content 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" } ] }