Шаблоны сообщений для отдельных товаров | Документация для разработчиков
Шаблоны сообщений для отдельных товаров
Обновлено: 3 марта 2026 г
В этом документе описываются шаблоны сообщений для отдельных продуктов (SPM), их назначение и способы использования.
Шаблоны SPM — это маркетинговые шаблоны, позволяющие представить один товар из вашего каталога электронной коммерции, сопроводив его изображением, названием товара и ценой (все данные берутся из каталога товаров), а также настраиваемым основным текстом, дополнительным текстом в нижнем колонтитуле и интерактивной «Просмотреть» .
Пользователи WhatsApp могут нажать на кнопку, чтобы просмотреть подробную информацию о товаре, а также добавить или удалить товар из корзины покупок WhatsApp:
Если пользователь WhatsApp добавит товар в корзину и оформит заказ, вы получите уведомление через веб-хук, и пользователь увидит, что заказ оформлен:
Пользователи, оформившие заказ, также могут использовать кнопку «Просмотреть подробности», чтобы увидеть информацию о заказе:
Ограничения
Каталоги
Для подключения к вашему аккаунту WhatsApp Business необходимо иметь каталог товаров для электронной коммерции с информацией о наличии на складе. Подробнее о подключении каталога к вашему аккаунту см. в руководстве Commerce
Вебхуки
Создание шаблонов SPM
Синтаксис запроса
curl 'https://graph.facebook.com/<API_VERSION> /<WHATSAPP_BUSINESS_ACCOUNT_ID> /message_templates' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer<ACCESS_TOKEN> ' \ -d ' { "name": "<TEMPLATE_NAME> ", "язык": "<TEMPLATE_LANGUAGE> ", "category": "marketing", "parameter_format": "<PARAMETER_FORMAT> ", "components": [ { "type": "header", "format": "product" }, { "type": "body", "text": "<CARD_BODY_TEXT> ",<!-- Example parameter values required, if body text contains parameters --> "пример": { "body_text_named_params": [ { "param_name": "<PARAMETER_NAME> ", "пример": "<PARAMETER_EXAMPLE> " },<!-- Additional parameters would follow --> ] } }, { "type": "footer", "text": "<CARD_FOOTER_TEXT> " }, { "type": "buttons", "buttons": [ { "type": "spm", "text": "View" } ] } ] }'
Параметры запроса
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| |
Пример запроса
локон 'https://graph.facebook.com/v25.0/161311403722088/message_templates' \
-ЧАС 'Content-Type: application/json' \
-ЧАС «Авторизация: Предъявитель EAAJB...» \
-д ' { "name": "spm_template_named_params", "language": "en_US", "category": "marketing", "parameter_format": "named", "components": [ { "type": "header", "format": "product" }, { "type": "body", "text": "Use code {{code}} to get {{percent}} off our newest succulent!", "example": { "body_text_named_params": [ { "param_name": "code", "example": "15OFF" }, { "param_name": "percent", "example": "15%" } ] } }, { "type": "footer", "text": "Offer ends September 22, 2024" }, { "type": "buttons", "buttons": [ { "type": "spm", "text": "View" } ] } ] }'Отправка шаблонных сообщений для одного товара
Синтаксис запроса
curl 'https://graph.facebook.com/<API_VERSION> /<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": "template", "template": { "name": "<TEMPLATE_NAME> ", "язык": { "код": "<TEMPLATE_LANGUAGE> " }, "components": [ { "type": "header", "parameters": [ { "type": "product", "product": { "product_retailer_id": "<PRODUCT_ID> ", "catalog_id": "<CATALOG_ID> " } } ] }, { "type": "body", "parameters": [ { "type": "text", "parameter_name": "<PARAMETER_NAME> ", "текст": "<PARAMETER_VALUE> " },<!-- Additional parameter values would follow, if required by template --> ] } ] } }'
Параметры запроса
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| |
Пример запроса
локон 'https://graph.facebook.com/v25.0/179776755229976/messages' \
-ЧАС 'Content-Type: application/json' \
-ЧАС «Авторизация: Предъявитель EAAJB...» \
-д ' { "messaging_product": "whatsapp", "recipient_type": "individual", "to": "16505551234", "type": "template", "template": { "name": "spm_template_named_params", "language": { "code": "en_US" }, "components": [ { "type": "header", "parameters": [ { "type": "product", "product": { "product_retailer_id": "nqryix03ez", "catalog_id": "194836987003835" } } ] }, { "type": "body", "parameters": [ { "type": "text", "parameter_name": "code", "text": "25OFF" }, { "type": "text", "parameter_name": "percent", "text": "25%" } ] } ] } }'