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

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

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

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

Обзор

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

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

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

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

          Для создания шаблона через API и ознакомления с общим синтаксисом, необходимыми категориями и компонентами, пожалуйста, обратитесь к нашей документации Шаблоны Документ. Все изложенные выше рекомендации по созданию шаблонов применимы и при использовании API.
          Шаблон статуса заказа относится к категории «Вспомогательные шаблоны» и, помимо выбора «названия» и «языка», содержит общие компоненты шаблона, такие как BODY, FOOTER, а также подкатегорию «ORDER_STATUS».
          ПОСТ https://graph.facebook.com/<API_VERSION>/<WHATSAPP_BUSINESS_BUSINESS_ID>/message_templates
          {
            "имя": "<ИМЯ_ШАБЛОНА>",
            "язык": "<КОД_ЯЗЫКА_И_ЛОКАЛИ>",
            "категория": "ПОЛЕЗНОСТЬ",
            "sub_category": "ORDER_STATUS",
            "компоненты": [
              {
                "тип": "ТЕЛО",
                "текст": "<TEMPLATE_BODY_TEXT>"
              },
              {
                "type": "FOOTTER",
                "текст": "<TEMPLATE_FOOTER_TEXT>"
              }
            ]
          }
          Отправка шаблонного сообщения о статусе заказа
          

          Шаблон сообщения о статусе заказа позволяет компаниям отправлять обновления о статусе заказа в качестве параметров компонента шаблона.
          

          Для отправки шаблонного сообщения о статусе заказа выполните POST- запрос к /  /messages , прикрепите объект сообщения с типом=template . После этого добавьте объект шаблона с  order_status и параметрами, содержащими последний статус заказа с идентификатором ссылки  .
          

          Например, в следующем примере описано, как отправить  "отправлен" для размещенного заказа.
          

          

          
curl -X POST \
            'https://graph.facebook.com/<API_VERSION>/<ИДЕНТИФИКАТОР НОМЕРА ТЕЛЕФОНА ОТ>/messages' \
           -H 'Авторизация: Предъявитель' <ТОКЕН ДОСТУПА>' \
           -H 'Content-Type: application/json' \
           -d '{
              "messaging_product": "whatsapp",
              "recipient_type": "individual",
              "к": "<НОМЕР ТЕЛЕФОНА>",
              "тип": "шаблон",
              "шаблон":
              {
                  "имя": "<ИМЯ_ШАБЛОНА>",
                  "язык":
                  {
                      "политика": "детерминированная",
                      "код": "<КОД_ЯЗЫКА_И_ЛОКАЛИ>"
                  },
                  "компоненты":
                  [
                      {
                          "type": "order_status",
                          "параметры": [{
                              "type": "order_status",
                              "order_status":
                              {
                                  "reference_id": "reference_id_value",
                                  "заказ":
                                  {
                                      "статус": "обработка" | частично отгружено | отгружено | завершено | отменитьред",
                                      "описание": "<ОПЦИОНАЛЬНОЕ ОПИСАНИЕ>"
                                  }
                              }
                          }]
                      }
                  ]
              }
          }
          При отправке  order_status с некорректным переходом вы получите веб-перехватчик ошибки с кодом 2046 и сообщением " Новый статус заказа не был корректно преобразован" .
          

          

          

          

          Отмена заказа
          

          Заказ можно отменить, отправив  order_status со статусом «отменен» . Клиент не может оплатить отмененный заказ. Клиент получает  order_status , и страница с подробной информацией о заказе обновляется, показывая, что заказ отменен, а  «Продолжить» удалена. Дополнительный текст, отображаемый под надписью «Заказ отменен» на странице с подробной информацией о заказе, можно указать в поле описания  order_status .
          

          Отменить заказ можно только в том случае, если пользователь еще не оплатил его. Если пользователь оплатил заказ, и компания отправляет сообщение order_status со статусом «отменен», будет получен веб-хук с ошибкой 2047 и сообщением « Не удалось изменить статус заказа на 'отменен'» .
          
    
                  
          
    
          

            
          
        
          
    
          

    
          

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