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

Шаблоны сообщений для отдельных товаров | Документация для разработчиков

Шаблоны сообщений для отдельных товаров

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

Ограничения

    Для использования сервиса необходимо установить WhatsApp версии 2.22.24 или выше.Для шаблонов SPM пересылка сообщений отключена.

    Каталоги

    Для подключения к вашему аккаунту WhatsApp Business необходимо иметь каталог товаров для электронной коммерции с информацией о наличии на складе. Подробнее о подключении каталога к вашему аккаунту см. в руководстве Commerce

    Вебхуки

    Когда покупатель добавляет один или несколько товаров в корзину и оформляет заказ, срабатывает веб-перехватчик сообщений о заказе

    Создание шаблонов SPM

    Используйте POST / /message_templates для создания шаблона 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" } ] } ] }'
    Параметры запроса
    
Заполнитель

Описание

Пример значения

    <ACCESS_TOKEN>
    Нить
    Необходимый.
    Токен доступа.
    EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD
    <API_VERSION>
    Нить
    Необязательный.
    Версия API. Если этот параметр опущен, по умолчанию используется самая новая версия API, доступная для вашего приложения.
    v23.0
    <CARD_BODY_TEXT>
    Нить
    Необходимый.
    Основной текст карточки. Поддерживает переменные.
    Максимальное количество символов: 160.
    Используйте код {{1}}, чтобы получить скидку {{2}} на наш новый суккулент!
    <CARD_FOOTER_TEXT>
    Нить
    Необязательный.
    Текст нижнего колонтитула.
    Максимум 60 символов.
    30 сентября 2024 г
    <PARAMETER_NAME>
    Нить
    Обязательно, если в основном тексте используются параметры.
    Пример(ы) строкового(ых) значения параметра. Для каждого параметра необходимо указать пример в основном тексте сообщения.
    25OFF
    <PARAMETER_FORMAT>
    Нить
    Необязательный.
    Формат параметра . Значение может быть следующим:
      названпозиционный
      Если  parameter_format опущено, шаблон будет использовать позиционное форматирование.
      Счастливый кустарник: ваш проводник в мир суккулентов!
      <TEMPLATE_LANGUAGE>
      Нить
      Необходимый.
       шаблона и код локали .
      en_US
      <TEMPLATE_NAME>
      Нить
      Необходимый.
      Название шаблона.
      Максимальное количество символов: 512.
      abandon_cart_offer
      <WHATSAPP_BUSINESS_ACCOUNT_ID>
      Нить
      Необходимый.
      Идентификатор бизнес-аккаунта WhatsApp.
      546151681022936
      Пример запроса
      curl 'https://graph.facebook.com/ v25.0 /161311403722088/message_templates' \ - H 'Content-Type: application/json' \ - H 'Authorization: Bearer EAAJB...' \ - d ' { "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", "пример": "15%" } ] } }, { "тип": "футер", "текст": "Предложение действует до 22 сентября 2024 г." }, { "тип": "кнопки", "кнопки": [ { "тип": "спм", "текст": "Просмотр" } ] } ] }'
      Отправка шаблонных сообщений для одного товара
      Синтаксис запроса
      Используйте POST /  /messages для отправки сообщения по шаблону SPM.
      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 --> ] } ] } }'
      Параметры запроса
      
Заполнитель

Описание

Пример значения

      <ACCESS_TOKEN>
      Нить
      Необходимый.
      токен доступа
      EAAN...
      <API_VERSION>
      Нить
      Необязательный.
      Версия API. Если этот параметр опущен, по умолчанию используется самая новая версия API, доступная для вашего приложения.
      v23.0
      <BUSINESS_PHONE_NUMBER_ID>
      Нить
      Необходимый.
      Идентификатор бизнес-телефона WhatsApp.
      106540352242922
      <CATALOG_ID>
      Нить
      Необходимый.
      Идентификатор подключенного каталога электронной коммерции , содержащего данный товар.
      194836987003835
      <PARAMETER_NAME>
      Нить
      Обязательно, если шаблон использует один или несколько именованных параметров.
      код
      <PARAMETER_VALUE>
      Нить
      Обязательно, если шаблон использует один или несколько именованных параметров.
      10OFF
      <PRODUCT_ID>
      Нить
      Необходимый.
      Идентификатор продукта.
      nqryix03ez
      <TEMPLATE_LANGUAGE>
      Нить
      Необходимый.
       шаблона и код локали .
      en_US
      <TEMPLATE_NAME>
      Нить
      Необходимый.
      Название шаблона.
      Максимальное количество символов: 512.
      spm_template_named_params
      <WHATSAPP_USER_PHONE_NUMBER>
      Нить
      Необходимый.
      Номер телефона пользователя WhatsApp.
      +16505551234
      Пример запроса
      В этом примере отправляется утвержденный шаблон с именем «spm_template_named_params», который внедряет параметры (код скидки и процент скидки) в тело шаблона и включает нижний колонтитул. Изображение товара берется из каталога и отображается в заголовке сообщения.
      curl 'https://graph.facebook.com/ v25.0 /179776755229976/messages' \ - H 'Content-Type: application/json' \ - H 'Authorization: Bearer EAAJB...' \ - d ' { "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%" } ] } ] } }'
      
    
              
      
    
      

            
      
        
      
    
      

    
      

    
    
      
        
      
             Вернуться наверх