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

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

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

Обновлено: 4 ноября 2025 г

Обзор

Шаблон сообщения с подробной информацией о заказе — это шаблон с интерактивными компонентами , который расширяет возможности кнопки призыва к действию, позволяя отправлять подробную информацию о заказе и обеспечивая более удобное взаимодействие по сравнению с шаблонами, содержащими только текстовые компоненты.
После того как шаблоны сообщений с подробной информацией о заказе будут созданы и утверждены, вы можете использовать утвержденный шаблон для отправки сообщения с информацией о заказе или счете, чтобы побудить клиентов произвести оплату.
Перед отправкой шаблонного сообщения с подробной информацией о заказе компаниям необходимо создать шаблон с кнопкой призыва к действию «Подробная информация о заказе». Дополнительную информацию о необходимых условиях и способах создания шаблона см. «Создание шаблонов сообщений для вашего бизнес-аккаунта WhatsApp» .

Создание шаблона сведений о заказе в WhatsApp Manager

Для создания шаблона с подробной информацией о заказе компании необходимо бизнес-портфолио с бизнес-аккаунтом WhatsApp.
В WhatsApp Manager > Инструменты учетной записи :
    Нажмите « Создать шаблон» Выберите «Услуги» или «Маркетинг» , чтобы увидеть сведений о заказе .Выберите сведений о заказе и нажмите «Далее».Введите желаемое название шаблона и поддерживаемые языковые настройки.
      В зависимости от количества языковых версий будет доступно равное количество вариантов шаблонов, и компаниям необходимо будет заполнить данные шаблона в соответствующей языковой версии.Заполните компоненты шаблона, такие как заголовок , основной текст и, при необходимости, текст нижнего колонтитула
        Для заголовка вы можете выбрать один из трех типов носителей: Текст , Изображение или Документ . Выберите «Документ», если хотите отправлять PDF-файлы в заголовок этого шаблона.Нажмите «Отправить».После отправки шаблоны будут классифицированы в соответствии с рекомендациями и пройдут процесс утверждения .Шаблон будет утвержден или отклонен после проверки его компонентов системой.
          Если вы считаете, что определенная категория не соответствует нашим рекомендациям по категориям шаблонов, пожалуйста, подтвердите отсутствие распространенных проблем , приводящих к отклонению заявок. Если вам требуется дополнительное разъяснение, вы можете запросить проверку шаблона через службу поддержки бизнеса .После утверждения статус изменится на АКТИВНЫЙ.
            Обращаем ваше внимание на то, что статус шаблона может автоматически меняться с «АКТИВНЫЙ» на «ПРИОСТАНОВЛЕННЫЙ» или «ОТКЛЮЧЕННЫЙ» в зависимости от отзывов и активности клиентов. Рекомендуем отслеживать изменения статуса и принимать соответствующие меры при каждом таком изменении.

            Создание шаблон сведений о заказе с использованием API для создания шаблонов

            Для создания шаблона через API и ознакомления с общим синтаксисом, необходимыми категориями и компонентами, пожалуйста, обратитесь к следующему разделу API шаблоновВсе описанные выше рекомендации по созданию шаблонов применимы и при использовании API.
            Шаблон сведений о заказе можно отнести к категории «Утилитарный» или «Маркетинговый» шаблон, и помимо «названия» и «языка» на выбор, он содержит общие компоненты шаблона, такие как ЗАГОЛОВОК, ОСНОВНОЙ ЧАСТЬ, НИЖНИЙ КОЛОНТАЖ и фиксированную КНОПКУ типа «ПОДРОБНОСТИ ЗАКАЗА».
            Он категория должно быть КОММУНАЛЬНЫЕ УСЛУГИ или МАРКЕТИНГи заголовок формат должно быть ТЕКСТ, ИЗОБРАЖЕНИЕ, или ДОКУМЕНТ.
            Конечная точка
            ПОЧТА /{Идентификатор бизнес-аккаунта WhatsApp}/шаблоны сообщений
            Текст запроса
            { "имя": "<TEMPLATE_NAME> ", "язык": "<LANGUAGE_CODE> ”, “категория”: “<CATEGORY> ”, “display_format”: “ORDER_DETAILS”, “components”: [ { “type”: “HEADER”, “format”: “<FORMAT> ”, “текст”: “<HEADER_TEXT> ” }, { "type": "BODY", "text": "<BODY_TEXT> " }, { "type": "FOOTER", "text": "<FOOTER_TEXT> " }, { "type": "BUTTONS", "buttons": [ { "type": "ORDER_DETAILS", "text": "<COPY_PIX_CODE> " } ] } ] }
            Отправка шаблона сообщения с подробной информацией о заказе
            

            Шаблон сообщения с подробной информацией о заказе позволяет компаниям отправлять сообщение счета-фактуры (order_details) в качестве предопределенных  сведений о заказе . Он поддерживает отправку всех интеграций платежных систем (таких как динамический код Pix , платежные ссылки , Boleto и т. д.) в качестве параметров кнопки.
            

            Чтобы отправить шаблонное сообщение с подробной информацией о заказе, выполните POST- запрос к  /PHONE_NUMBER_ID/messages и прикрепите объект сообщения с типом=template . Затем добавьте объект шаблона с предопределенной кнопкой призыва к действию для получения подробной информации о заказе 
            

            При желании вы можете добавить PDF-файл в качестве вложения в  заголовка шаблона сообщения. Для этого используйте параметр `type=document` в объекте параметра  заголовка , как описано в нашем  «Компоненты» .
            

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

            

            

            Конечная точка
            ПОЧТА
/{НОМЕР_ТЕЛЕФОНА_ИДЕНТИФИКАТОР}/сообщения
            Текст запроса
            

            

            {
            
"messaging_product": "whatsapp", "recipient_type": "individual", "to": "<PHONE_NUMBER> ", "type": "template", "template": { "name": "<TEMPLATE_NAME> ", "language": { "policy": "deterministic", "code": "<LANGUAGE_AND_LOCALE_CODE> " }, "components": [ { "type": "button", "sub_type": "order_details", "index": 0, "parameters": [ { "type": "action", "action": { "order_details": { "reference_id": "<UNIQUE_REFERENCE_ID> ", "type": "digital-goods", "payment_type": "br", "payment_settings": [ { "type": "pix_dynamic_code", "pix_dynamic_code": { "code": "00020101021226700014br.gov.bcb.pix2548pix.example.com...", "merchant_name": "Имя владельца счета", "key": "39580525000189", "key_type": "CNPJ" } } ], "currency": "BRL", "total_amount": { "value": 50000, "offset": 100 }, "order": { "status": "pending", "tax": { "value": 0, "offset": 100, "description": "optional text" }, "items": [ { "retailer_id": "1234567", "name": "Cake", "amount": { "value": 50000, "offset": 100 }, "quantity": 1 } ], "subtotal": { "value": 50000, "offset": 100 } } } } } ] } ] } }
            После отправки шаблонного сообщения с подробной информацией о заказе, в случае успеха будет отправлен объект с идентификатором, начинающимся с wamid. Используйте идентификатор, указанный после wamid, для отслеживания статуса вашего сообщения.
            

            

            {
            
"messaging_product":
            
"WhatsApp",
            
"контакты":
            
[ { "вход": "<PHONE_NUMBER> ", "wa_id": "<WHATSAPP_ID> " } ], "messages": [ { "id": "wamid.ID" } ] }
            Шаблон сообщения для отправки сведений о заказе
            

            После отправки шаблонного сообщения с подробной информацией о заказе остальная часть процесса оплаты аналогична «Отправке счета в окне сессии клиента» и зависит от выбранных параметров обработки заказа в рамках интеграции платежных 
            
    
                    
            
    
            

            
            
        
            
    
            

    
            

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