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

Шаблоны кнопок оформления заказа | Документация для разработчиков

Шаблоны кнопок оформления заказа

Обновлено: 12 декабря 2025 г
Шаблоны кнопок оформления заказа — это маркетинговые шаблоны, которые могут демонстрировать один или несколько товаров вместе с соответствующими кнопками оформления заказа, которые пользователи WhatsApp могут использовать для совершения покупок, не выходя из приложения WhatsApp.

Отдельные товары

Шаблоны кнопок оформления заказа могут отображать заголовок с одним изображением товара или видеороликом, а также основной текст сообщения, нижний колонтитул сообщения, одну кнопку оформления заказа и до 9 кнопок быстрого ответа.
Пользователи WhatsApp, нажавшие на кнопку, увидят подробности заказа:
Пользователи могут продолжить, выбрав предоставленную вами информацию о доставке (если вы знаете их данные и указали их в содержимом отправляемого сообщения)...
...или могут добавить свою собственную информацию для доставки:

Включение купонов, информации о наличии товаров в режиме реального времени и обновлений цен

Функция включения купонов, обновления информации о наличии товаров и ценах в режиме реального времени в настоящее время находится в стадии бета-тестирования и доступна только для индийских компаний и пользователей WhatsApp с индийским телефонным кодом. Для получения дополнительной информации, [email protected]
Для включения купонов, обновления информации о наличии товаров и ценах в режиме реального времени можно настроить конечную точку оформления заказа, которая будет обмениваться данными в режиме реального времени для обновления заказа в клиенте WhatsApp. Это позволит компаниям получать адрес доставки, предлагать купоны в зависимости от заказа и давать пользователям возможность применить купон. Это также позволит компаниям проверять наличие товаров и возможность доставки заказа до того, как пользователь завершит оформление.
Настройка конечной точки оформления заказа включает в себя следующие шаги: это'это'это тот же метод, что и Конечная точка WhatsApp Flows используется для обмена данными с клиентами WhatsApp.
    Создайте пару ключей, загрузите и подпишите открытый ключ, используя Cloud API .Настройка конечной точкиРеализовать шифрование/дешифрование полезной нагрузкиСвяжите конечную точку оформления заказа с конфигурацией платежаРеализуйте логику конечной точки оформления заказа

    Настройте конечную точку

    Клиент WhatsApp отправляет HTTPS-запрос для обмена данными с бизнес-интерфейсом. Вам следует убедиться, что интерфейс настроен на прием запроса, и связать URL-адрес интерфейса с настройками оплаты .
    

    https://business.com/checkout
    

    Ваш сервер должен быть настроен на прием и обработку POST- запросов, использовать HTTPS и иметь установленный действительный TLS/SSL-сертификат. Этот сертификат не обязательно должен использоваться для шифрования/дешифрования полезной нагрузки.
    

    

    

    

    Внедрить шифрование/дешифрование
    

    Тело каждого запроса содержит зашифрованные данные и имеет следующий вид:
    

    

    

    

    Пример синтаксиса запроса к конечной точке
    

    

    {
     encrypted_flow_data: "
     < ENCRYPTED_FLOW_DATA > ", encrypted_aes_key: "
     < ENCRYPTED_AES_KEY > ", initial_vector: "
     < INITIAL_VECTOR > " }
    

    

    



Параметр 

Описание 




    

    encrypted_flow_data string
    


    

    Обязательно. Зашифрованные данные запроса.
    



    

    encrypted_aes_key string
    


    

    Обязательно. Зашифрованный 128-битный ключ AES.
    



    

    начальный_вектор строка
    


    

    Обязательно. 128-битный вектор инициализации.
    

    После обработки расшифрованного запроса создайте ответ и зашифруйте его, прежде чем отправить обратно в клиент WhatsApp. Зашифруйте полезную нагрузку, используя ключ AES, полученный в запросе, и отправьте его обратно в виде строки Base64.
    

    Вы можете ознакомиться с примерами расшифровки и шифрования .
    

    Если запрос не удается расшифровать, конечная точка должна вернуть код состояния ответа HTTP 421 ( подробнее  «Коды ошибок бизнес-конечных точек 
    

    

    

    

    Пример ответа конечной точки
    

    

    локон-я-ЧАС"Тип контента:
    
application/json"-X
    Обратите внимание, что это всего лишь определение кнопки. Фактические сведения о продукте, который соответствует этой кнопке, будут включены в шаблон сообщения, которое вы отправляете . Например:
    

    

    {
    "тип":
    
"кнопка",
    "sub_type": "order_details",
    "индекс": 0,
    "параметры": [
        {
    "тип": "действие",
    "действие": {
    "order_details": {
    "reference_id": "abc.123_xyz-1",
    "тип": «материальные товары»,
    "валюта": "INR",
    "payment_settings": [
                {
    "тип": "платежный шлюз",
    "платежный шлюз": {
    "тип": "razorpay",
    "configuration_name": "prod-razor-pay-config-05"
                  }
                }
              ],
    "shipping_info": {
    "страна": "В",
    "адреса": [
                  {
    "имя": «Нидхи Трипати»,
    "номер телефона": "919000090000",
    "адрес": «Комплекс Бандра Курла»,
    "город": «Мумбаи»,
    "состояние": «Махараштра»,
    "in_pin_code": "400051",
    "номер_дома": "12",
    "номер_башни": "5",
    "building_name": «Один БКК»,
    "достопримечательная_зона": «Рядом с BKC Circle»
                  }
                ]
              },
    "заказ": {
    "предметы": [
                  {
    "количество": {
    "компенсировать": 100,
    "ценить": 200000
                    },
    "sale_amount": {
    "компенсировать": 100,
    "ценить": 150000
                    },
    "имя": «Алоэ синего эльфа»,
    "количество": 1,
    "страна происхождения": "Индия",
    "импортер_имя": Компания «Lucky Shrub Imports and Exports»,
    "importer_address": {
    "Адресная строка 1": «Один БКК»,
    "address_line2": «Комплекс Бандра Курла»,
    "город": «Мумбаи»,
    "zone_code": "МХ",
    "Почтовый индекс": "400051",
    "country_code": "В"
                    }
                  }
                ],
    «Итого»: {
    "компенсировать": 100,
    "ценить": 150000
                },
    "перевозки": {
    "компенсировать": 100,
    "ценить": 20000
                },
    "налог": {
    "компенсировать": 100,
    "ценить": 10000
                },
    "скидка": {
    "компенсировать": 100,
    "ценить": 15000,
    "описание": Дополнительная скидка 10%
                },
    «статус»: "в ожидании",
    "срок действия": {
    "временная метка": "1726627150"
                }
              },
    "Общая сумма": {
    "компенсировать": 100,
    "ценить": 165000
              }
            }
          }
        }
      ]
    }
    Если вы отправляете шаблон карусели медиа-карточек (который может содержать два или более товаров), каждая кнопка оформления заказа должна быть определена в шаблоне, и при отправке шаблона необходимо указать сведения о товарах, которые соответствуют каждой кнопке.
    

    

    

    Создание
шаблоны кнопок оформления заказа
    Используйте ПОЧТА /<WHATSAPP_BUSINESS_ACCOUNT_ID> /message_templates Конечная точка для создания шаблона, использующего кнопку оформления заказа.
    Синтаксис запроса
    ПОЧТА /<Идентификатор бизнес-аккаунта WhatsApp>/шаблоны сообщений
    Пост тело
    Ниже приведён шаблон кнопки оформления заказа, отображающий одну кнопку. См Шаблоны карусели медиакарточек Документ, содержащий синтаксический код шаблона карусели для тела сообщения.
    {"имя":"<TEMPLATE_NAME> ","язык":"<TEMPLATE_LANGUAGE> ","категория":«маркетинг»,«компоненты»:[{"тип":"заголовок","формат":"<MESSAGE_HEADER_FORMAT> ","пример":{"header_handle":["<MESSAGE_HEADER_ASSET_HANDLE> "]}},{"тип":"тело","текст":"<MESSAGE_BODY_TEXT> ","пример":{"body_text":[["<MESSAGE_BODY_TEXT_VARIABLE_EXAMPLE> ","<MESSAGE_BODY_TEXT_VARIABLE_EXAMPLE> "]]}},/* Компонент нижнего колонтитула является необязательным */{"тип":«нижний колонтитул»,"текст":"<MESSAGE_FOOTER_TEXT> "},{"тип":"кнопки","кнопки":[{"тип":"order_details","текст":"Купить сейчас"},/* Кнопки быстрого ответа необязательны; допускается до 9 кнопок */{"тип":"быстрый_ответ","текст":"<QUICK_REPLY_BUTTON_LABEL_TEXT> "}]}]}
    Параметры тела после
    
Заполнитель

Описание

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

    <MESSAGE_BODY_TEXT>
    Нить
    Необходимый.
    Текст сообщения. Поддерживает переменные.
    Максимальное количество символов: 1024.
    Привет, {{1}}! Товар {{2}} снова в наличии! Закажите сейчас, пока он не закончился!
    <MESSAGE_BODY_TEXT_VARIABLE_EXAMPLE>
    Нить
    Обязательно, если строка текста сообщения использует переменные.
    Пример текста сообщения в виде строковых переменных. Количество строк должно соответствовать количеству заполнителей переменных в тексте сообщения.
    Если в тексте сообщения используется одна переменная, body_text Значение может быть строкой, в противном случае это должен быть массив, содержащий массив строк.
    Пабло
    <MESSAGE_FOOTER_TEXT>
    Нить
    Обязательно, если используется нижний колонтитул сообщения.
    Текстовая строка нижнего колонтитула сообщения.
    Максимум 60 символов.
    Нажмите кнопку «Стоп» ниже, чтобы отменить напоминания о поступлении товара на склад.
    <MESSAGE_HEADER_ASSET_HANDLE>
    Нить
    Обязательно, если используется заголовок медиафайла, не являющийся текстовым.
    Идентификатор загруженного медиафайла. Используйте API для возобновления загрузки для генерации идентификатора актива.
    Медиафайлы автоматически обрезаются до широкого соотношения сторон в зависимости от устройства пользователя WhatsApp.
    4::anBlZw==:ARa525ZJ1g0J-8egeiRvb4Z4r9RSi9qeKF7-wXsUiaDFsll5CKbu5H7h_9mTW0TDfA8LEGHC4bAeXtJJi VQADMp5Ooe2huQlhpBxMadJiu3qVg:e:1724535430:634974688087057:100089620928913:ARaQoFQMm6BlbI3MYo4
    <MESSAGE_HEADER_FORMAT>
    Нить
    Необходимый.
    Формат заголовка сообщения. Значение может быть изображение или видео.
    изображение
    <QUICK_REPLY_BUTTON_LABEL_TEXT>
    Нить
    Обязательно при использовании кнопки быстрого ответа.
    Текст подписи кнопки быстрого ответа.
    Максимум 25 символов.
    Останавливаться
    <TEMPLATE_LANGUAGE>
    Нить
    Необходимый.
    en_US
    <TEMPLATE_NAME>
    Нить
    Необходимый.
    Название шаблона.
    Максимальное количество символов: 512.
    item_back_in_stock_v1
    Пример запроса
    В этом примере запроса создается шаблон кнопки оформления заказа, содержащий заголовок с одним изображением, основной текст сообщения, использующий две переменные, нижний колонтитул, одну кнопку оформления заказа и кнопку быстрого ответа.
    локон 'https://graph.facebook.com/v25.0/102290129340398/message_templates' \
-ЧАС 'Content-Type: application/json' \
-ЧАС «Авторизация: Предъявитель EAAJB...» \
-д ' { "name": "item_back_in_stock_v1", "language": "en_US", "category": "marketing", "components": [ { "type": "header", "format": "image", "example": { "header_handle": [ "3:NDU..." ] } }, { "type": "body", "text": "Привет, {{1}}! Товар {{2}} снова в наличии! Закажите сейчас, пока он не закончился!", "example": { "body_text": [ [ "Pablo", "Blue Elf Aloe" ] ] } }, { "type": "footer", "text": "Нажмите «Стоп» ниже, чтобы отключить напоминания о поступлении товара." }, { "type": "buttons", "buttons": [ { "type": "order_details", "text": "Купить сейчас" }, { "type": "quick_reply", "text": "Стоп" } ] } ] }'
    Отправить шаблон кнопки оформления заказа
    

    После утверждения шаблона кнопки оформления заказа или шаблона карусели вы можете отправить его в виде шаблонного сообщения.
    

    

    

    Запрос
синтаксис
    Используйте ПОЧТА /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID> /сообщения Конечная точка для отправки одобренного шаблона кнопки оформления заказа или шаблона карусели пользователю WhatsApp.
    ПОЧТА /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/сообщения
    Пост тело
    

    Этот синтаксис тела POST-запроса предназначен для шаблона кнопки оформления заказа. См. раздел «Отправка шаблонов карусели медиакарточек» для получения информации о синтаксисе полезной нагрузки тела POST-запроса для шаблона карусели медиакарточек.
    

    {"messaging_product":"WhatsApp","recipient_type":"индивидуальный","к":"<WHATSAPP_USER_PHONE_NUMBER> ","тип":"шаблон","шаблон":{"имя":"<TEMPLATE_NAME> ","язык":{"политика":«детерминированный»,"код":"<TEMPLATE_LANGUAGE> "},«компоненты»:[{"тип":"заголовок","параметры":[{"тип":"<MESSAGE_HEADER_FORMAT> ","<MESSAGE_HEADER_FORMAT> ":{"идентификатор":"<MESSAGE_HEADER_ASSET_ID> "}}]},{"тип":"тело","параметры":[{<MESSAGE_BODY_TEXT_VARIABLE>},{<MESSAGE_BODY_TEXT_VARIABLE>}]},{"тип":"кнопка","sub_type":"order_details","индекс":0,"параметры":[{"тип":"действие","действие":{"order_details":{"reference_id":"<REFERENCE_ID> ","валюта":"INR","тип":"<PRODUCT_TYPE> ","payment_settings":[{"тип":"платежный шлюз","платежный шлюз":{"тип":"<PAYMENT_GATEWAY_NAME> ","configuration_name":"<PAYMENT_GATEWAY_CONFIGURATION_NAME> "}}],/*
    
"shipping_info"
    
необходимый
    
для
    
тип физических товаров, иначе опустить */"shipping_info":{"страна":"В","адреса":[/* Если известен адрес получателя, требуется объект, в противном случае его следует опустить (т.е. установить "addresses" в пустой массив) */{"имя":"<SHIPPING_INFO_NAME> ","номер телефона":"<SHIPPING_INFO_PHONE_NUMBER> ","адрес":"<SHIPPING_INFO_ADDRESS> ","город":"<SHIPPING_INFO_CITY> ","состояние":"<SHIPPING_INFO_STATE> ","in_pin_code":"<SHIPPING_INFO_INDIA_PIN> ","достопримечательная_зона":"<SHIPPING_INFO_LANDMARK_AREA> ","номер_дома":"<SHIPPING_INFO_HOUSE_NUMBER> ","номер_башни":"<SHIPPING_INFO_TOWER_NUMBER> ","building_name":"<SHIPPING_INFO_BUILDING_NAME> "}]},"заказ":{"предметы":[{"количество":{"компенсировать":100,"ценить":<ЦЕНА_ТОВАРА>},/* "sale_amount" необязательный параметр */"sale_amount":{"компенсировать":100,"ценить":<ЦЕНА_РАСПРОДАЖИ>},"имя":"<ITEM_NAME> ","количество":<КОЛИЧЕСТВО_ТОВАРА>,"страна происхождения":"<ITEM_COUNTRY_OF_ORIGIN> ","импортер_имя":"<IMPORTER_NAME> ","importer_address":{"Адресная строка 1":"<IMPORTER_ADDRESS_LINE_1> ","address_line2":"<IMPORTER_ADDRESS_LINE_2> ","город":"<IMPORTER_CITY> ","zone_code":"<IMPORTER_ZONE_CODE> ","Почтовый индекс":"<IMPORTER_POSTAL_CODE> ","country_code":"В"}}],«Итого»:{"компенсировать":100,"ценить":<ИТОГО>}"перевозки":{"компенсировать":100,"ценить":<СУММА ДОСТАВКИ>},"налог":{"компенсировать":100,"ценить":<СУММА НАЛОГА>,"описание":"<TAX_DESCRIPTION> "},/* "скидка" необязательна */"скидка":{"компенсировать":100,"ценить":<СУММА_СКИДКИ>,"описание":"<DISCOUNT_DESCRIPTION> "},«статус»:"в ожидании",/* "срок действия" необязателен */"срок действия":{"временная метка":"<EXPIRATION_TIMESTAMP> "}},"Общая сумма":{"компенсировать":100,"ценить":<ОБЩАЯ СУММА>}}}}]}]}}
    Параметры тела после
    

    

    



Заполнитель 

Описание 

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




    

    <DISCOUNT_AMOUNT>
    

    Целое число
    


    

    Обязательно при использовании скидки.
    

    Сумма скидки, умноженная на значение discount.offset.
    

    Например, для обозначения скидки в размере ₹?2, значение будет 200.
    

    Сумма скидки применяется к общей сумме заказа.
    


    

    15000
    



    

    <DISCOUNT_DESCRIPTION>
    

    Нить
    


    

    Необязательный.
    

    Описание скидки.
    

    Максимум 60 символов.
    


    

    Дополнительная скидка 10%
    



    

    <EXPIRATION_TIMESTAMP>
    

    Нить
    


    

    Обязательно, если используется срок действия заказа.
    

    Временная метка UTC, указывающая, когда следует отключить  Купить сейчас» . Эта метка времени будет использоваться для генерации текстовой строки, которая отобразится в нижней части  сведений о заказе . Например:
    

    Срок действия данного распоряжения истекает 30 сентября 2024 года в 12:00.
    

    Пользователи WhatsApp, которые увидят сообщение после указанного времени, не смогут приобрести товар, используя кнопку оформления заказа.
    

    Значения должны представлять время в формате UTC, по крайней мере, на 300 секунд позже момента отправки запроса на отправку сообщения.
    


    

    1726692927
    



    

    <IMPORTER_ADDRESS_LINE_1>
    

    Нить
    


    

    Необходимый.
    

    Адрес импортера, строка 1 (дверь, башня, номер дома, улица и т. д.).
    

    Максимум 100 символов.
    


    

    Один БКК
    



    

    <IMPORTER_ADDRESS_LINE_2>
    

    Нить
    


    

    Необязательный.
    

    Адрес импортера, строка 2 (ориентир, район и т. д.).
    

    Максимум 100 символов.
    


    

    Бандра Курла Комплекс
    



    

    <IMPORTER_CITY>
    

    Нить
    


    

    Необходимый.
    

    Город-импортер.
    

    Максимальное количество символов: 120.
    


    

    Мумбаи
    



    

    <IMPORTER_NAME>
    

    Нить
    


    

    Необходимый.
    

    Имя импортера.
    

    Максимум 200 символов.
    


    

    Компания Lucky Shrub Imports and Exports
    



    

    <IMPORTER_POSTAL_CODE>
    

    Нить
    


    

    Необходимый.
    

    Шестизначный почтовый индекс импортера.
    

    Максимум 6 цифр.
    


    

    400051
    



    

    <IMPORTER_ZONE_CODE>
    

    Нить
    


    

    Необходимый.
    

    Двухбуквенный код зоны импортера.
    


    

    МХ
    



    

    <ITEM_COUNTRY_OF_ORIGIN>
    

    Нить
    


    

    Необходимый.
    

    Элемент'Элемент'страна происхождения.
    

    Максимум 100 символов.
    


    

    Индия
    



    

    <ITEM_NAME>
    

    Нить
    


    

    Необходимый.
    

    Название товара.
    

    Максимум 60 символов.
    


    

    Алоэ синего эльфа
    



    

    <ITEM_PRICE>
    

    Целое число
    


    

    Необходимый.
    

    Цена за единицу товара (цена за единицу), умноженная на сумму скидки.
    

    Например, для обозначения цены товара ₹?12,99, значение будет 1299.
    


    

    200000
    



    

    <ITEM_QUANTITY>
    

    Целое число
    


    

    Необходимый.
    

    Количество товаров в заказе, если заказ оформлен.
    

    Максимум 100 целых чисел.
    


    

    1
    



    

    <MESSAGE_BODY_TEXT_VARIABLE>
    

    Объект
    


    

    Обязательно, если в тексте сообщения шаблона используются переменные; в противном случае опустите.
    

    Объект, описывающий переменную сообщения. Если шаблон использует несколько переменных, необходимо определить объект для каждой переменной.
    

    Поддерживаются  text , currency и date_time . См. Параметры сообщений .
    

    Для этого значения нет максимального ограничения по количеству символов, но оно учитывается в общем объеме текста сообщения, который составляет 1024 символа.
    


    

    {"тип":"текст","текст":«Нидхи»}
    



    

    <MESSAGE_HEADER_ASSET_ID>
    

    Нить
    


    

    Необходимый.
    

    Заголовок объект'объект's идентификатор загруженного медиафайла. Используйте ПОЧТА /<BUSINESS_PHONE_NUMBER_ID> /медиа Конечная точка для генерации идентификатора актива.
    


    

    1558081531584829
    



    

    <MESSAGE_HEADER_FORMAT>
    

    Нить
    


    

    Необходимый.
    

    Указывает тип заголовка и соответствующее имя свойства.
    

    Обратите внимание, что <MESSAGE_HEADER_FORMAT> В приведенном выше примере тела сообщения заполнитель встречается дважды, поскольку он служит заполнителем для типа свойство'свойство'значение s и соответствующее ему имя свойства.
    

    Ценность может представлять собой изображение или видео .
    


    

    изображение
    



    

    <PAYMENT_GATEWAY_CONFIGURATION_NAME>
    

    Нить
    


    

    Необходимый.
    

    Название платежного шлюза, который вы настроили в своем аккаунте WhatsApp Business.
    


    

    prod-razor-pay-config-05
    



    

    <PAYMENT_GATEWAY_NAME>
    

    Нить
    


    

    Необходимый.
    

    Название платежного шлюза, которое вы настроили в своем аккаунте WhatsApp Business.
    

    Возможные значения:
    

      razorpayпаюзаакпай
      


      

      razorpay
      



      

      <PRODUCT_TYPE>
      

      Нить
      


      

      Необходимый.
      

      Тип товара. Ценность может выражаться в цифровых или физических товарах .
      


      

      цифровые товары
      



      

      <QUICK_REPLY_BUTTON_PAYLOAD>
      

      Нить
      


      

      Необязательный.
      

      Значение, которое будет включено в веб-хуки сообщений ( messages.button.payload ) при нажатии кнопки.
      


      

      уклоняться
      



      

      <REFERENCE_ID>
      

      Нить
      


      

      Необходимый.
      

      Ваш уникальный идентификатор заказа или счета-фактуры. Учитывается регистр. Не может быть пустым. В процессе оформления заказа перед ним будет стоять символ решетки (#).
      

      Значение должно быть уникальным для каждого шаблонного сообщения кнопки оформления заказа. При отправке шаблона карусели каждая кнопка оформления заказа должна иметь уникальный идентификатор.
      

      Если вам необходимо отправить несколько сообщений для одного и того же заказа/счета, рекомендуется добавить к значению порядковый номер (например, -1).
      

      Значения могут содержать только английские буквы, цифры, символы подчеркивания, дефисы или точки.
      

      Максимальное количество символов: 35.
      


      

      abc.123_xyz-1
      



      

      <SALE_PRICE>
      

      Целое число
      


      

      Обязательно, если используется сумма продажи.
      

      Цена продажи, умноженная на  скидки .
      

      Например, для обозначения продажной цены ₹?10, значение будет 1000.
      


      

      150000
      



      

      <SHIPPING_AMOUNT>
      

      Целое число
      


      

      Необходимый.
      

      Стоимость доставки заказа, умноженная на  доставки .
      

      Например, для обозначения стоимости доставки ₹?0,99, значение будет 99.
      


      

      20000
      



      

      <SHIPPING_INFO_ADDRESS>
      

      Нить
      


      

      Требуется, если вы знаете получатель'получатель'информация о доставке.
      

      Продукт получатель'получатель'адрес.
      

      Максимальное количество символов: 512.
      


      

      Бандра Курла Комплекс
      



      

      <SHIPPING_INFO_BUILDING_NAME>
      

      Нить
      


      

      Необязательный.
      

      Продукт получатель'получатель'название здания.
      

      Максимальное количество символов: 128.
      


      

      Один БКК
      



      

      <SHIPPING_INFO_CITY>
      

      Нить
      


      

      Требуется, если вы знаете получатель'получатель'информация о доставке.
      

      Полное название продукта получатель'получатель'город.
      

      Максимум 100 символов.
      


      

      Мумбаи
      



      

      <SHIPPING_INFO_FLOOR_NUMBER>
      

      Нить
      


      

      Необязательный.
      

      Продукт получатель'получатель'номер этажа.
      

      Максимум 10 символов.
      


      

      2
      



      

      <SHIPPING_INFO_HOUSE_NUMBER>
      

      Нить
      


      

      Необязательный.
      

      Продукт получатель'получатель'номер дома.
      

      Максимум 8 символов.
      


      

      12
      



      

      <SHIPPING_INFO_INDIA_PIN>
      

      Нить
      


      

      Требуется, если вы знаете получатель'получатель'информация о доставке.
      

      Продукт получатель'получатель'почтовый индексный номер.
      

      Максимум 6 символов.
      


      

      400051
      



      

      <SHIPPING_INFO_LANDMARK_AREA>
      

      Нить
      


      

      Необязательный.
      

      Продукт получатель'получатель'знаковый район.
      

      Максимальное количество символов: 128.
      


      

      Рядом с круговой развязкой BKC
      



      

      <SHIPPING_INFO_NAME>
      

      Нить
      


      

      Требуется, если вы знаете получатель'получатель'информация о доставке.
      

      Продукт получатель'получатель'полное имя.
      

      Максимальное количество символов: 256.
      


      

      Нидхи Трипати
      



      

      <SHIPPING_INFO_PHONE_NUMBER>
      

      Нить
      


      

      Требуется, если вы знаете получатель'получатель'информация о доставке.
      

      Продукт получатель'получатель'Номер телефона WhatsApp.
      

      Максимум 12 символов.
      


      

      919000090000
      



      

      <SHIPPING_INFO_STATE>
      

      Нить
      


      

      Требуется, если вы знаете получатель'получатель'информация о доставке.
      

      Полное название продукта получатель'получатель'штат.
      

      Максимум 100 символов.
      


      

      Махараштра
      



      

      <SHIPPING_INFO_TOWER_NUMBER>
      

      Нить
      


      

      Необязательный.
      

      Продукт получатель'получатель'номер башни.
      

      Максимум 8 символов.
      


      

      2
      



      

      <SUBTOTAL_AMOUNT>
      

      Целое число
      


      

      Необходимый.
      

      Итого по заказу. Рассчитайте путем умножения. к по промежуточному смещению .
      

      Например, если шаблон предназначен для оформления одного заказа, содержащего 2 товара по цене.. ₹?12,99, значение будет 2598.
      


      

      150000
      



      

      <TAX_AMOUNT>
      

      Целое число
      


      

      Необходимый.
      

      Сумма налога, умноженная на налоговый вычет .
      

      Например, для обозначения суммы налога в ₹?5, значение будет 500.
      


      

      10000
      



      

      <TAX_DESCRIPTION>
      

      Нить
      


      

      Необязательный.
      

      Описание налога.
      

      Максимум 60 символов.
      


      

      налог с продаж
      



      

      <TEMPLATE_LANGUAGE>
      

      Нить
      


      

      Необходимый.
      

       шаблона и код локали .
      


      

      en_US
      



      

      <TEMPLATE_NAME>
      

      Нить
      


      

      Необходимый.
      

      Название шаблона.
      

      Максимальное количество символов: 512.
      


      

      item_back_in_stock_v1
      



      

      <TOTAL_AMOUNT>
      

      Целое число
      


      

      Необходимый.
      

      Общая сумма заказа, умноженная на  total_amount.offset .
      

      Например, для обозначения общей суммы ₹?18, значение быть 1800.
      

      Должна представлять собой сумму:
      

        order.subtotal.valueorder.shipping.valueorder.tax.value

        Минус:
        

          order.discount.value
          


          

          165000
          



          

          <WHATSAPP_USER_PHONE_NUMBER>
          

          Нить
          


          

          Необходимый.
          

          Номер телефона пользователя WhatsApp.
          


          

          +16505551234
          

          

          

          

          Пример запроса
          

          локон
          
'https://graph.facebook.com/v25.0/106540352242922/messages' \
-ЧАС 'Content-Type: application/json' \
-ЧАС «Авторизация: Предъявитель EAAJB...» \
-д ' { "messaging_product": "whatsapp", "recipient_type": "individual", "to": "+16505551234", "type": "template", "template": { "name": "item_back_in_stock_v2", "language": { "policy": "deterministic", "code": "en_US" }, "components": [ { "type": "header", "parameters": [ { "type": "image", "image": { "id": "1558081531584829" } } ] }, { "type": "body", "parameters": [ { "type": "text", "text": "Nidhi" }, { "type": "text", "text": "Blue Elf Aloe" } ] }, { "type": "button", "sub_type": "order_details", "index": 0, "параметры": [ { "тип": "действие", "действие": { "подробности заказа": { "идентификатор ссылки": "abc.123_xyz-1", "тип": "физические товары", "валюта": "INR", "настройки оплаты": [ { "тип": "платежный шлюз", "платежный шлюз": { "тип": "razorpay", "имя_конфигурации": "prod-razor-pay-config-05" } } ], "информация_доставки": { "страна": "IN", "адреса": [ { "имя": "Нидхи Трипати", "номер_телефона": "919000090000", "адрес": "Комплекс Бандра Курла", "город": "Мумбаи", "штат": "Махараштра", "почтовый индекс": "400051", "номер_дома": "12", "номер_башни": "5", "название_здания": "One BKC", "landmark_area": ​​"Near BKC Circle" } ] }, "order": { "items": [ { "amount": { "offset": 100, "value": 200000 }, "sale_amount": { "offset": 100, "value": 150000 }, "name": "Blue Elf Aloe", "quantity": 1, "country_of_origin": "India", "importer_name": "Lucky Shrub Imports and Exports", "importer_address": { "address_line1": "One BKC", "address_line2": "Bandra Kurla Complex", "city": "Mumbai", "zone_code": "MH", "postal_code": "400051", "country_code": "IN" } } ], "subtotal": { "offset": 100, "value": 150000 }, "shipping": { "offset": 100, "value": 20000 }, "tax": { "offset": 100, "value": 10000 }, "discount": { "offset": 100, "value": 15000, "description": "Дополнительная скидка 10%" }, "status": "pending", "expiration": { "timestamp": "1726627150" } }, "total_amount": { "offset": 100, "value": 165000 } } } } ] } ] } }'
          

          Приведенные ниже примеры запросов и ответов поддерживаются только при включении функции купонов, обновления информации о наличии товаров и ценах в режиме реального времени.  Для получения дополнительной информации, пожалуйста, свяжитесь с нами по адресу [email protected]
          Получить купоны - пример запроса конечной точки
                {
          "данные":
              {
          "order_details":
                  {
          "reference_id": "abc.123_xyz-1",
          "тип": «материальные товары»,
          "валюта": "INR",
          "shipping_info":
                      {
          "страна": "В",
          "адреса":
                          [
                              {
          "имя": «Нидхи Трипати»,
          "номер телефона": "919000090000",
          "адрес": «Комплекс Бандра Курла»,
          "город": «Мумбаи»,
          "состояние": «Махараштра»,
          "in_pin_code": "400051",
          "номер_дома": "12",
          "номер_башни": "5",
          "building_name": «Один БКК»,
          "достопримечательная_зона": «Рядом с BKC Circle»
                              }
                          ]
                      },
          "заказ":
                      {
          "предметы":
                          [
                              {
          "количество":
                                  {
          "компенсировать": 100,
          "ценить": 200000
                                  },
          "sale_amount":
                                  {
          "компенсировать": 100,
          "ценить": 150000
                                  },
          "имя": «Алоэ синего эльфа»,
          "количество": 1,
          "страна происхождения": "Индия",
          "импортер_имя": Компания «Lucky Shrub Imports and Exports»,
          "importer_address":
                                  {
          "Адресная строка 1": «Один БКК»,
          "address_line2": «Комплекс Бандра Курла»,
          "город": «Мумбаи»,
          "zone_code": "МХ",
          "Почтовый индекс": "400051",
          "country_code": "В"
                                  }
                              }
                          ],
          «Итого»:
                          {
          "компенсировать": 100,
          "ценить": 150000
                          },
          "перевозки":
                          {
          "компенсировать": 100,
          "ценить": 20000
                          },
          "налог":
                          {
          "компенсировать": 100,
          "ценить": 10000
                          },
          "скидка":
                          {
          "компенсировать": 100,
          "ценить": 15000,
          "описание": Дополнительная скидка 10%
                          },
          «статус»: "в ожидании",
          "срок действия":
                          {
          "временная метка": "1726627150",
          "описание": "Срок действия заказа истекает через 5 минут"
                          }
                      },
          "Общая сумма":
                      {
          "компенсировать": 100,
          "ценить": 165000
                      }
                  },
          "вход":
                  {
          "ID пользователя": "919000090000"
                  }
              },
          "действие": "data_exchange",
          "под_действие": "get_coupons",
          "версия": "1.0"
          }
          Получить купоны - пример ответа конечной точки
                {
          "версия": "1.0",
          "под_действие": "get_coupons",
          "данные":
              {
          «купоны»:
                  [
                      {
          "описание": «Сэкономьте 20 рандов на заказе»,
          "код": "TRYNEW20",
          "идентификатор": "try_new_20_id"
                      },
                      {
          "описание": «Сэкономьте 30 рандов на заказе»,
          "код": "TRYNEW30",
          "идентификатор": "try_new_30_id"
                      },
                      {
          "описание": «Сэкономьте 50 рандов на заказе»,
          "код": "TRYNEW50",
          "идентификатор": "try_new50_id"
                      }
                  ]
              }
          }
          Применить купон - запрос образца конечной точки
                {
          "данные":
              {
          "order_details":
                  {
          "reference_id": "abc.123_xyz-1",
          "тип": «материальные товары»,
          "валюта": "INR",
          "shipping_info":
                      {
          "страна": "В",
          "адреса":
                          [
                              {
          "имя": «Нидхи Трипати»,
          "номер телефона": "919000090000",
          "адрес": «Комплекс Бандра Курла»,
          "город": «Мумбаи»,
          "состояние": «Махараштра»,
          "in_pin_code": "400051",
          "номер_дома": "12",
          "номер_башни": "5",
          "building_name": «Один БКК»,
          "достопримечательная_зона": «Рядом с BKC Circle»
                              }
                          ]
                      },
          "заказ":
                      {
          "предметы":
                          [
                              {
          "количество":
                                  {
          "компенсировать": 100,
          "ценить": 200000
                                  },
          "sale_amount":
                                  {
          "компенсировать": 100,
          "ценить": 150000
                                  },
          "имя": «Алоэ синего эльфа»,
          "количество": 1,
          "страна происхождения": "Индия",
          "импортер_имя": Компания «Lucky Shrub Imports and Exports»,
          "importer_address":
                                  {
          "Адресная строка 1": «Один БКК»,
          "address_line2": «Комплекс Бандра Курла»,
          "город": «Мумбаи»,
          "zone_code": "МХ",
          "Почтовый индекс": "400051",
          "country_code": "В"
                                  }
                              }
                          ],
          «Итого»:
                          {
          "компенсировать": 100,
          "ценить": 150000
                          },
          "перевозки":
                          {
          "компенсировать": 100,
          "ценить": 20000
                          },
          "налог":
                          {
          "компенсировать": 100,
          "ценить": 10000
                          },
          "скидка":
                          {
          "компенсировать": 100,
          "ценить": 15000,
          "описание": Дополнительная скидка 10%
                          },
          «статус»: "в ожидании",
          "срок действия":
                          {
          "временная метка": "1726627150",
          "описание": "Срок действия заказа истекает через 5 минут"
                          }
                      },
          "Общая сумма":
                      {
          "компенсировать": 100,
          "ценить": 165000
                      }
                  },
          "вход":
                  {
          "ID пользователя": "919000090000",
          "купон":
                      {
          "код": "TRYNEW10"
                      }
                  }
              },
          "действие": "data_exchange",
          "под_действие": "apply_coupon",
          "версия": "1.0"
          }
          Применить купон - пример ответа конечной точки
                {
          "под_действие": "apply_coupon",
          "версия": "1.0",
          "данные":
              {
          "order_details":
                  {
          "reference_id": "abc.123_xyz-1",
          "тип": «материальные товары»,
          "валюта": "INR",
          "shipping_info":
                      {
          "страна": "В",
          "адреса":
                          [
                              {
          "имя": «Нидхи Трипати»,
          "номер телефона": "919000090000",
          "адрес": «Комплекс Бандра Курла»,
          "город": «Мумбаи»,
          "состояние": «Махараштра»,
          "in_pin_code": "400051",
          "номер_дома": "12",
          "номер_башни": "5",
          "building_name": «Один БКК»,
          "достопримечательная_зона": «Рядом с BKC Circle»
                              }
                          ]
                      },
          "заказ":
                      {
          "предметы":
                          [
                              {
          "количество":
                                  {
          "компенсировать": 100,
          "ценить": 200000
                                  },
          "sale_amount":
                                  {
          "компенсировать": 100,
          "ценить": 150000
                                  },
          "имя": «Алоэ синего эльфа»,
          "количество": 1,
          "страна происхождения": "Индия",
          "импортер_имя": Компания «Lucky Shrub Imports and Exports»,
          "importer_address":
                                  {
          "Адресная строка 1": «Один БКК»,
          "address_line2": «Комплекс Бандра Курла»,
          "город": «Мумбаи»,
          "zone_code": "МХ",
          "Почтовый индекс": "400051",
          "country_code": "В"
                                  }
                              }
                          ],
          «Итого»:
                          {
          "компенсировать": 100,
          "ценить": 150000
                          },
          "перевозки":
                          {
          "компенсировать": 100,
          "ценить": 20000
                          },
          "налог":
                          {
          "компенсировать": 100,
          "ценить": 10000
                          },
          "скидка":
                          {
          "компенсировать": 100,
          "ценить": 15000,
          "описание": Дополнительная скидка 10%
                          },
          «статус»: "в ожидании",
          "срок действия":
                          {
          "временная метка": "1726627150",
          "описание": "Срок действия заказа истекает через 5 минут"
                          }
                      },
          "купон":
                      {
          "код": "TRYNEW10",
          "скидка":
                          {
          "ценить": 16500,
          "компенсировать": 100
                          }
                      },
          "Общая сумма":
                      {
          "компенсировать": 100,
          "ценить": 148500
                      }
                  }
              }
          }
          Удалить купон - запрос на демонстрацию конечной точки
                {
          "данные":
              {
          "order_details":
                  {
          "reference_id": "abc.123_xyz-1",
          "тип": «материальные товары»,
          "валюта": "INR",
          "shipping_info":
                      {
          "страна": "В",
          "адреса":
                          [
                              {
          "имя": «Нидхи Трипати»,
          "номер телефона": "919000090000",
          "адрес": «Комплекс Бандра Курла»,
          "город": «Мумбаи»,
          "состояние": «Махараштра»,
          "in_pin_code": "400051",
          "номер_дома": "12",
          "номер_башни": "5",
          "building_name": «Один БКК»,
          "достопримечательная_зона": «Рядом с BKC Circle»
                              }
                          ]
                      },
          "заказ":
                      {
          "предметы":
                          [
                              {
          "количество":
                                  {
          "компенсировать": 100,
          "ценить": 200000
                                  },
          "sale_amount":
                                  {
          "компенсировать": 100,
          "ценить": 150000
                                  },
          "имя": «Алоэ синего эльфа»,
          "количество": 1,
          "страна происхождения": "Индия",
          "импортер_имя": Компания «Lucky Shrub Imports and Exports»,
          "importer_address":
                                  {
          "Адресная строка 1": «Один БКК»,
          "address_line2": «Комплекс Бандра Курла»,
          "город": «Мумбаи»,
          "zone_code": "МХ",
          "Почтовый индекс": "400051",
          "country_code": "В"
                                  }
                              }
                          ],
          «Итого»:
                          {
          "компенсировать": 100,
          "ценить": 150000
                          },
          "перевозки":
                          {
          "компенсировать": 100,
          "ценить": 20000
                          },
          "налог":
                          {
          "компенсировать": 100,
          "ценить": 10000
                          },
          "скидка":
                          {
          "компенсировать": 100,
          "ценить": 15000,
          "описание": Дополнительная скидка 10%
                          },
          «статус»: "в ожидании",
          "срок действия":
                          {
          "временная метка": "1726627150",
          "описание": "Срок действия заказа истекает через 5 минут"
                          }
                      },
          "купон":
                      {
          "код": "TRYNEW10",
          "скидка":
                          {
          "ценить": 16500,
          "компенсировать": 100
                          }
                      },
          "Общая сумма":
                      {
          "компенсировать": 100,
          "ценить": 148500
                      }
                  },
          "вход":
                  {
          "ID пользователя": "919000090000"
                  }
              },
          "действие": "data_exchange",
          "под_действие": "удалить_купон",
          "версия": "1.0"
          }
          Удалить купон - пример ответа конечной точки
                {
          "под_действие": "удалить_купон",
          "версия": "1.0",
          "данные":
              {
          "order_details":
                  {
          "reference_id": "abc.123_xyz-1",
          "тип": «материальные товары»,
          "валюта": "INR",
          "shipping_info":
                      {
          "страна": "В",
          "адреса":
                          [
                              {
          "имя": «Нидхи Трипати»,
          "номер телефона": "919000090000",
          "адрес": «Комплекс Бандра Курла»,
          "город": «Мумбаи»,
          "состояние": «Махараштра»,
          "in_pin_code": "400051",
          "номер_дома": "12",
          "номер_башни": "5",
          "building_name": «Один БКК»,
          "достопримечательная_зона": «Рядом с BKC Circle»
                              }
                          ]
                      },
          "заказ":
                      {
          "предметы":
                          [
                              {
          "количество":
                                  {
          "компенсировать": 100,
          "ценить": 200000
                                  },
          "sale_amount":
                                  {
          "компенсировать": 100,
          "ценить": 150000
                                  },
          "имя": «Алоэ синего эльфа»,
          "количество": 1,
          "страна происхождения": "Индия",
          "импортер_имя": Компания «Lucky Shrub Imports and Exports»,
          "importer_address":
                                  {
          "Адресная строка 1": «Один БКК»,
          "address_line2": «Комплекс Бандра Курла»,
          "город": «Мумбаи»,
          "zone_code": "МХ",
          "Почтовый индекс": "400051",
          "country_code": "В"
                                  }
                              }
                          ],
          «Итого»:
                          {
          "компенсировать": 100,
          "ценить": 150000
                          },
          "перевозки":
                          {
          "компенсировать": 100,
          "ценить": 20000
                          },
          "налог":
                          {
          "компенсировать": 100,
          "ценить": 10000
                          },
          "скидка":
                          {
          "компенсировать": 100,
          "ценить": 15000,
          "описание": Дополнительная скидка 10%
                          },
          «статус»: "в ожидании",
          "срок действия":
                          {
          "временная метка": "1726627150",
          "описание": "Срок действия заказа истекает через 5 минут"
                          }
                      },
          "Общая сумма":
                      {
          "компенсировать": 100,
          "ценить": 165000
                      }
                  }
              }
          }
          Применение доставки - запрос образца конечной точки
                {
          "данные":
              {
          "order_details":
                  {
          "reference_id": "abc.123_xyz-1",
          "тип": «материальные товары»,
          "валюта": "INR",
          "shipping_info":
                      {
          "страна": "В",
          "адреса":
                          [
                              {
          "имя": «Нидхи Трипати»,
          "номер телефона": "919000090000",
          "адрес": «Комплекс Бандра Курла»,
          "город": «Мумбаи»,
          "состояние": «Махараштра»,
          "in_pin_code": "400051",
          "номер_дома": "12",
          "номер_башни": "5",
          "building_name": «Один БКК»,
          "достопримечательная_зона": «Рядом с BKC Circle»
                              }
                          ]
                      },
          "заказ":
                      {
          "предметы":
                          [
                              {
          "количество":
                                  {
          "компенсировать": 100,
          "ценить": 200000
                                  },
          "sale_amount":
                                  {
          "компенсировать": 100,
          "ценить": 150000
                                  },
          "имя": «Алоэ синего эльфа»,
          "количество": 1,
          "страна происхождения": "Индия",
          "импортер_имя": Компания «Lucky Shrub Imports and Exports»,
          "importer_address":
                                  {
          "Адресная строка 1": «Один БКК»,
          "address_line2": «Комплекс Бандра Курла»,
          "город": «Мумбаи»,
          "zone_code": "МХ",
          "Почтовый индекс": "400051",
          "country_code": "В"
                                  }
                              }
                          ],
          «Итого»:
                          {
          "компенсировать": 100,
          "ценить": 150000
                          },
          "перевозки":
                          {
          "компенсировать": 100,
          "ценить": 20000
                          },
          "налог":
                          {
          "компенсировать": 100,
          "ценить": 10000
                          },
          "скидка":
                          {
          "компенсировать": 100,
          "ценить": 15000,
          "описание": Дополнительная скидка 10%
                          },
          «статус»: "в ожидании",
          "срок действия":
                          {
          "временная метка": "1726627150",
          "описание": "Срок действия заказа истекает через 5 минут"
                          }
                      },
          "купон":
                      {
          "код": "TRYNEW10",
          "скидка":
                          {
          "ценить": 16500,
          "компенсировать": 100
                          }
                      },
          "Общая сумма":
                      {
          "компенсировать": 100,
          "ценить": 148500
                      }
                  },
          "вход":
                  {
          "ID пользователя": "919000090000",
          "selected_address":
                      {
          "имя": «Нидхи Трипати»,
          "номер телефона": "919000090000",
          "адрес": «Комплекс Бандра Курла»,
          "город": «Мумбаи»,
          "состояние": «Махараштра»,
          "in_pin_code": "400051",
          "номер_дома": "12",
          "номер_башни": "5",
          "building_name": «Один БКК»,
          "достопримечательная_зона": «Рядом с BKC Circle»
                      }
                  }
              },
          "действие": "data_exchange",
          "под_действие": "apply_shipping",
          "версия": "1.0"
          }
          Применение доставки - пример ответа конечной точки
                {
          "под_действие": "apply_shipping",
          "версия": "1.0",
          "данные":
              {
          "order_details":
                  {
          "reference_id": "abc.123_xyz-1",
          "тип": «материальные товары»,
          "валюта": "INR",
          "shipping_info":
                      {
          "страна": "В",
          "адреса":
                          [
                              {
          "имя": «Нидхи Трипати»,
          "номер телефона": "919000090000",
          "адрес": «Комплекс Бандра Курла»,
          "город": «Мумбаи»,
          "состояние": «Махараштра»,
          "in_pin_code": "400051",
          "номер_дома": "12",
          "номер_башни": "5",
          "building_name": «Один БКК»,
          "достопримечательная_зона": «Рядом с BKC Circle»
                              }
                          ],
          "selected_address":
                          {
          "имя": «Нидхи Трипати»,
          "номер телефона": "919000090000",
          "адрес": «Комплекс Бандра Курла»,
          "город": «Мумбаи»,
          "состояние": «Махараштра»,
          "in_pin_code": "400051",
          "номер_дома": "12",
          "номер_башни": "5",
          "building_name": «Один БКК»,
          "достопримечательная_зона": «Рядом с BKC Circle»
                          }
                      },
          "заказ":
                      {
          "предметы":
                          [
                              {
          "количество":
                                  {
          "компенсировать": 100,
          "ценить": 200000
                                  },
          "sale_amount":
                                  {
          "компенсировать": 100,
          "ценить": 150000
                                  },
          "имя": «Алоэ синего эльфа»,
          "количество": 1,
          "страна происхождения": "Индия",
          "импортер_имя": Компания «Lucky Shrub Imports and Exports»,
          "importer_address":
                                  {
          "Адресная строка 1": «Один БКК»,
          "address_line2": «Комплекс Бандра Курла»,
          "город": «Мумбаи»,
          "zone_code": "МХ",
          "Почтовый индекс": "400051",
          "country_code": "В"
                                  }
                              }
                          ],
          «Итого»:
                          {
          "компенсировать": 100,
          "ценить": 150000
                          },
          "перевозки":
                          {
          "компенсировать": 100,
          "ценить": 40000
                          },
          "налог":
                          {
          "компенсировать": 100,
          "ценить": 10000
                          },
          "скидка":
                          {
          "компенсировать": 100,
          "ценить": 15000,
          "описание": Дополнительная скидка 10%
                          },
          «статус»: "в ожидании",
          "срок действия":
                          {
          "временная метка": "1726627150",
          "описание": "Срок действия заказа истекает через 5 минут"
                          }
                      },
          "купон":
                      {
          "код": "TRYNEW10",
          "скидка":
                          {
          "ценить": 16500,
          "компенсировать": 100
                          }
                      },
          "Общая сумма":
                      {
          "компенсировать": 100,
          "ценить": 168500
                      }
                  }
              }
          }
          
    
                  
          
    
          

            
          
        
          
    
          

    
          

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