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

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

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

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

Обзор

Шаблон статуса заказа — это шаблон с интерактивными компонентами , который расширяет возможности кнопки призыва к действию, позволяя обновлять статус заказа через шаблон. Он позволяет компаниям обновлять статус заказа вне окна сессии клиента , например, при списании средств с карты за предыдущие заказы или при обновлении информации о доставке заказа, размещенного ранее.
После получения подтверждения оплаты компании должны обновить статус заказа, чтобы пользователь был в курсе. В настоящее время мы поддерживаем следующие значения статуса заказа
Ценить Описание
в ожидании
Пользователь еще не оплатил заказ успешно
обработка
Оплата пользователем авторизована, продавец/партнер выполняет заказ, оказывает услугу и т. д.
частично отгружено
Часть товаров из заказа уже отправлена ​​продавцом
отправленный
Все товары в заказе были отправлены продавцом
завершенный
Заказ выполнен, и от пользователя или партнера/продавца дальнейших действий не требуется
отменено
Партнер/продавец хочет отменить order_details для заказа/счета. Обновление статуса не удастся, если успешный или ожидающий по этому order_details сообщению

Создание шаблона статуса заказа

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

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

          Чтобы создать шаблон через API и ознакомиться с общим синтаксисом, необходимыми категориями и компонентами, обратитесь к нашему «Шаблоны» . Все описанные выше рекомендации по созданию шаблонов применимы и при использовании API.
          Шаблон статуса заказа относится к категории «Вспомогательные шаблоны» и, помимо выбора «названия» и «языка», содержит общие компоненты шаблона, такие как BODY, FOOTER, а также подкатегорию «ORDER_STATUS».
          POST https://graph.facebook.com/<API_VERSION>/<WHATSAPP_BUSINESS_BUSINESS_ID>/message_templates
          {
            "name": "<TEMPLATE_NAME>",
            "language": "<LANGUAGE_AND_LOCALE_CODE>",
            "category": "UTILITY",
            "sub_category": "ORDER_STATUS",
            "components": [
              {
                "type": "BODY",
                "text": "<TEMPLATE_BODY_TEXT>"
              },
              {
                "type": "FOOTER",
                "text": "<TEMPLATE_FOOTER_TEXT>"
              }
            ]
          }
          Отправка шаблонного сообщения о статусе заказа
          Шаблон сообщения о статусе заказа позволяет компаниям отправлять обновления о статусе заказа в качестве параметров компонента шаблона.
          Для отправки шаблонного сообщения о статусе заказа выполните POST- запрос к /
добавьте конечную точку и прикрепите объект сообщения с типом=template. После этого добавьте объект шаблона с
order_status и параметрами, содержащими последний статус заказа с идентификатором ссылки на.
          Например, в следующем примере описано, как отправить "отправлен" для размещенного заказа.
            curl -X POST \
            'https://graph.facebook.com/<API_VERSION>/<FROM_PHONE_NUMBER_ID>/messages' \
           -H 'Authorization: Bearer <ACCESS_TOKEN>' \
           -H 'Content-Type: application/json' \
           -d '{
              "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": "order_status",
                          "parameters": [{
                              "type": "order_status",
                              "order_status":
                              {
                                  "reference_id": "reference_id_value",
                                  "order":
                                  {
                                      "status": "processing | partially_shipped | shipped | completed | canceled",
                                      "description": "<OPTIONAL_DESCRIPTION>"
                                  }
                              } }
                          ]
                      }
                  ]
              }
          }
          При отправке order_status с некорректным переходом вы получите веб-перехватчик ошибки с кодом 2046 и сообщением " Новый статус заказа не был корректно преобразован".
          Отмена заказа
          Заказ можно отменить, отправив order_status со статусом «отменен». Клиент не может оплатить отмененный заказ. Клиент получает order_status , и страница с подробной информацией о заказе обновляется, показывая, что заказ отменен, а «Продолжить» удалена. Дополнительный текст, отображаемый под надписью «Заказ отменен» на странице с подробной информацией о заказе, можно указать в поле описания order_status .
          Отменить заказ можно только в том случае, если пользователь еще не оплатил его. Если пользователь оплатил заказ, и компания отправляет сообщение order_status со статусом «отменен», будет получен веб-хук с ошибкой 2047 и сообщением « Не удалось изменить статус заказа на 'отменен'».
          
    
                  
          
    
          

            
          
        
          
    
          

    
          

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