Шаблоны сообщений для нескольких товаров | Документация для разработчиков
Шаблоны сообщений для нескольких товаров
Обновлено: 3 марта 2026 г
В этом документе описываются шаблоны сообщений для нескольких продуктов («MPM»), их использование и способы применения.
Шаблоны MPM — это маркетинговые шаблоны, позволяющие продемонстрировать до 30 товаров из вашего каталога электронной коммерции, сгруппированных в 10 разделов, в одном сообщении.
Клиенты могут просматривать товары и разделы в сообщении, просматривать подробную информацию о каждом товаре, добавлять и удалять товары из корзины, а также отправлять корзину для оформления заказа. Затем заказы отправляются вам через веб-хук.
В статье нашего справочного центра «О шаблонах сообщений для нескольких товаров в WhatsApp» описаны распространенные сценарии использования и даны советы о том, как максимально эффективно использовать шаблоны MPM.
Требования
Для создания и использования шаблонов MPM вам необходим каталог товаров для электронной коммерции с информацией о наличии товара, подключенный к вашему аккаунту WhatsApp Business. См. руководство по Cloud API Commerce .
Ограничения
Создание шаблонов MPM
Синтаксис запроса
curl -X POST "https://graph.facebook.com/v23.0/<WHATSAPP_BUSINESS_ACCOUNT_ID> /message_templates" \ -H "Авторизация: Bearer"<ACCESS_TOKEN> " \ -H "Content-Type: application/json" \ -d '{ "name": "<NAME> ", "категория": "<CATEGORY> ", "язык": "<LANGUAGE> ", "компоненты": [<COMPONENTS> ] }'
Параметры запроса
| | |
| ||
| | |
| |
Компоненты
компоненты[ { "type": "HEADER", "format": "TEXT", "text": "<HEADER_TEXT> ", /* Пример необходим, если заголовок использует переменную */ "example": { "header_text": [ "<HEADER_EXAMPLE_TEXT> " ] } }, { "type": "BODY", "text": "<BODY_TEXT> ", /* Пример необходим, если в теле используются переменные */ "example": { "body_text": [ [ "<BODY_EXAMPLE_TEXT> " ] ] } }, { "type": "FOOTER", "text": "<FOOTER_TEXT> " }, { "type":"BUTTONS", "buttons": [ { "type": "MPM", "text": "View items" } ] } ]
Параметры запроса
| | |
| | |
| | |
| | |
| |
Ответ
{ "идентификатор": "<ID> ", "статус": "<STATUS> ", "категория": "МАРКЕТИНГ" }
Параметры отклика
| | |
| | |
Пример запроса
curl 'https://graph.facebook.com/v25.0/102290129340398/message_templates' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer EAAJB...' \ -d ' { "name": "abandoned_cart", "language": "en_US", "category": "MARKETING", "components": [ { "type": "HEADER", "format": "TEXT", "text": "Забыли что-то, {{1}}?", "example": { "header_text": [ "Pablo" ] } }, { "type": "BODY", "text": "Похоже, вы оставили эти товары в корзине, все еще заинтересованы? Используйте код {{1}}, чтобы получить скидку 10%!", "example": { "body_text": [ [ "10OFF" ] ] } }, { "type":"BUTTONS", "buttons": [ { "type": "MPM", "text": "View items" } ] } ] }'
Пример ответа
{ "id": "546151681022936", "status": "PENDING", "category": "MARKETING" }
Вебхуки
синтаксис веб-перехватчика
{ "object": "whatsapp_business_account", "entry": [ { "id": "<ENTRY.ID> ", "изменения": [ { "значение": { "messaging_product": "whatsapp", "метаданные": { "отображаемый_номер_телефона": "<DISPLAY_PHONE_NUMBER> ", "phone_number_id": "<PHONE_NUMBER_ID> " }, "контакты": [ { "профиль": { "имя": "<NAME> " }, "wa_id": "<WA_ID> " } ], "сообщения": [ { "из": "<FROM> ", "идентификатор": "<MESSAGES.ID> ", "временная метка": "<TIMESTAMP> ", "type": "order", "order": { "catalog_id": "<CATALOG_ID> ", "product_items": [ { "product_retailer_id": "<PRODUCT_RETAILER_ID> ", "количество":<QUANTITY> , "item_price":<ITEM_PRICE> , "валюта": "<CURRENCY> " } ] } } ] }, "поле": "сообщения" } ] } ] }
Содержимое веб-перехватчика
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| |
Пример веб-перехватчика
{ "object": "whatsapp_business_account", "entry": [ { "id": "102290129340398", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "15550051310", "phone_number_id": "106540352242922" }, "contacts": [ { "profile": { "name": "Pablo Morales" }, "wa_id": "16505551234" } ], "messages": [ { "from": "16505551234", "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQTMxNzA1QzNENEI4ODY0OTY2MAA=", "timestamp": "1683223069", "type": "order", "order": { "catalog_id": "1537566713439863", "product_items": [ { "product_retailer_id": "n6k6x0y7oe", "quantity": 1, "item_price": 99.99, "currency": "USD" } ] } } ] }, "field": "messages" } ] } ] }
Отправка сообщений по шаблону MPM
Компоненты
Синтаксис запроса
curl -X POST "https://graph.facebook.com/v23.0/<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": "header", "parameters": [ { "type": "text", "text": "<HEADER_TEXT> " } ] }, { "type": "body", "parameters": [ { "type": "text", "text": "<BODY_TEXT> " } ] }, { "type": "button", "sub_type": "mpm", "index": 0, "parameters": [ { "type": "action", "action": { "thumbnail_product_retailer_id": "<THUMBNAIL_PRODUCT_RETAILER_ID> ", "sections": [ { "title": " <TITLE>", "product_items": [ { "product_retailer_id": "<PRODUCT_RETAILER_ID_1>" }, { "product_retailer_id": "<PRODUCT_RETAILER_ID_2>" } // ... Add up to 30 product items per section ] } // ... Add up to 10 section objects as needed ] } } ] } ] } }'</title></code>
Параметры запроса
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| |
Ответ
{ "messaging_product": "whatsapp", "contacts": [ { "input": "<INPUT> ", "wa_id": "<WA_ID> " } ], "messages": [ { "id": "<ID> " } ] }
Параметры отклика
| | |
| | |
| |
Пример запроса
curl 'https://graph.facebook.com/v25.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": "abandoned_cart", "language": { "code": "en_US" }, "components": [ { "type": "header", "parameters": [ { "type": "text", "text": "Pablo" } ] }, { "type": "body", "parameters": [ { "type": "text", "text": "10OFF" } ] }, { "type": "button", "sub_type": "mpm", "index": 0, "parameters": [ { "type": "action", "action": { "thumbnail_product_retailer_id": "2lc20305pt", "sections": [ { "title": "Популярные комплекты", "product_items": [ { "product_retailer_id": "2lc20305pt" }, { "product_retailer_id": "nseiw1x3ch" } ] }, { "title": "Премиум-пакеты", "product_items": [ { "product_retailer_id": "n6k6x0y7oe" } ] } ] } } ] } ] } }'
Пример ответа
{ "messaging_product": "whatsapp", "contacts": [ { "input": "16505551234", "wa_id": "16505551234" } ], "messages": [ { "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBJDOEI3ODgxNzQzMjJBQTdEQTcA" } ] }