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

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

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

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

Обзор

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

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

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

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

            Для создания шаблона через API и ознакомления с общим синтаксисом, необходимыми категориями и компонентами, пожалуйста, обратитесь к API шаблонов . Все описанные выше рекомендации по созданию шаблонов также применимы при использовании API.
            Шаблон сведений о заказе можно отнести к категории «Утилитарный» или «Маркетинговый» шаблон, и помимо «названия» и «языка» на выбор, он содержит общие компоненты шаблона, такие как ЗАГОЛОВОК, ОСНОВНОЙ ЧАСТЬ, НИЖНИЙ КОЛОНТАЖ и фиксированную КНОПКУ типа «ПОДРОБНОСТИ ЗАКАЗА».
            Категория должна быть «Утилиты» или «Маркетинг» формат заголовка должен быть «Текст» , «Изображение» или « Документ» .
            Конечная точка
            POST /{ WHATSAPP_BUSINESS_ACCOUNT_ID }/ message_templates
            Текст запроса
            { "имя": "<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 в параметрах сообщения шаблона сведений о заказе, чтобы предложить покупателю произвести оплату.
            Конечная точка
            POST /{ PHONE_NUMBER_ID }/ messages
            Текст запроса
            { "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", "contacts": [ { "input": "<PHONE_NUMBER> ", "wa_id": "<WHATSAPP_ID> " } ], "messages": [ { "id": "wamid.ID" } ] }
            Шаблон сообщения для отправки сведений о заказе
            После отправки шаблонного сообщения с подробной информацией о заказе остальная часть процесса оплаты аналогична «Отправке счета в окне сессии клиента» и зависит от выбранных параметров обработки заказа в рамках интеграции платежных 
            
    
                    
            
    
            

            
            
        
            
    
            

    
            

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