Отправить шаблон сообщения о статусе заказа | Документация для разработчиков
Отправить сообщение с шаблоном статуса заказа
Обновлено: 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- запрос к / /messages , прикрепите объект сообщения с типом=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 | cancel ed", "description": "
< OPTIONAL_DESCRIPTION > " }
} }
]
}
]
}
}
При отправке
order_status с некорректным переходом вы получите веб-перехватчик ошибки с кодом 2046 и сообщением " Новый статус заказа не был корректно преобразован" .Отмена заказа
Заказ можно отменить, отправив
order_status со статусом «отменен» . Клиент не может оплатить отмененный заказ. Клиент получает order_status , и страница с подробной информацией о заказе обновляется, показывая, что заказ отменен, а «Продолжить» удалена. Дополнительный текст, отображаемый под надписью «Заказ отменен» на странице с подробной информацией о заказе, можно указать в поле описания order_status .Отменить заказ можно только в том случае, если пользователь еще не оплатил его. Если пользователь оплатил заказ, и компания отправляет сообщение order_status со статусом «отменен», будет получен веб-хук с ошибкой
2047 и сообщением « Не удалось изменить статус заказа на 'отменен'» .
Комментарии отсутствуют
Комментарии отсутствуют