Справочник по веб-перехватчику message_template_status_update | Документация для разработчиков
ссылка на веб-перехватчик message_template_status_update
Обновлено: 14 ноября 2025 г
бизнес-аккаунта WhatsApp
message_template_status_update .Веб message_template_status_update уведомляет вас об изменениях статуса существующего шаблона.
Триггеры
Синтаксис
{
"entry": [
{
"id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
"time": <WEBHOOK_TRIGGER_TIMESTAMP>,
"changes": [
{
"value": {
"event": "<EVENT>",
"message_template_id": <TEMPLATE_ID>,
"message_template_name": "<TEMPLATE_NAME>",
"message_template_language": "<TEMPLATE_LANGUAGE_AND_LOCALE_CODE>",
"reason": "<REASON>",
"message_template_category": "<TEMPLATE_CATEGORY>",
<!-- only included if template disabled -->
"disable_info": {
"disable_date": "<DISABLE_TIMESTAMP>"
},
<!-- only included if template locked or unlocked -->
"другая_информация": {
"заголовок": "<ЗАГОЛОВОК>",
"описание": "<ОПИСАНИЕ>"
},
<!-- only included if template rejected with INVALID_FORMAT reason -->
"rejection_info": {
"reason": "<REASON_INFO>",
"recommendation": "<RECOMMENDATION_INFO>"
}
},
"field": "message_template_status_update"
}
]
}
],
"object": "whatsapp_business_account"
}
Параметры
| Заполнитель | Описание | Пример значения |
|---|---|---|
<DESCRIPTION>Нить | Строка, описывающая причину блокировки или разблокировки шаблона. | Ваш шаблон сообщения WhatsApp разблокирован. |
<DISABLE_TIMESTAMP>Целое число | Временная метка Unix, указывающая на момент отключения шаблона. | 1751234563 |
<EVENT>Нить | Событие статуса шаблона. Возможные значения: ОДОБРЕНО — Означает, что шаблон одобрен и теперь может быть использован в шаблонных сообщениях.АРХИВИРОВАНО: Указывает на то, что шаблон был заархивирован для поддержания чистоты списка шаблонов в менеджере WhatsApp.
УДАЛЕНО : Указывает на то, что шаблон был удален.ОТКЛЮЧЕНО — Указывает на то, что шаблон был отключен в связи с отзывами.ПОМЕЧЕНО — Указывает на то, что шаблон получил негативные отзывы и находится под угрозой отключения.IN_APPEAL — Указывает, что шаблон находится в обжалования .LIMIT_EXCEEDED — Указывает на то, что шаблон бизнес-аккаунта WhatsApp достиг своего предела.ЗАБЛОКИРОВАНО — Указывает на то, что шаблон заблокирован и не может быть отредактирован.ПАУЗА — Указывает на то, что шаблон приостановлен.ОЖИДАЕТСЯ — Указывает на то, что шаблон находится на стадии проверки.ВОССТАНОВЛЕНО — Это означает, что шаблон больше не помечен как заблокированный или отключенный и может снова использоваться в шаблонных сообщениях.PENDING_DELETION — Указывает на то, что шаблон был удален через WhatsApp Manager.ОТКЛОНЕНО — Это означает, что шаблон был отклонен. Вы можете отредактировать шаблон , чтобы он прошел повторную проверку, или обжаловать отказ. | ОДОБРЕННЫЙ |
<TEMPLATE_ID>Целое число | Идентификатор шаблона. | 1689556908129832 |
<TEMPLATE_NAME>Нить | Название шаблона. | подтверждение заказа |
<TEMPLATE_LANGUAGE_AND_LOCALE_CODE>Нить | шаблона локали код | en-US |
<REASON>Нить | Причина отклонения шаблона, если шаблон отклонен. Если шаблон запланирован к удалению, значение будет равно null, а не строке. В противном случае значения могут быть следующими:ABUSIVE_CONTENT — Указывает на то, что шаблон содержит контент, нарушающий наши правила.CATEGORY_NOT_AVAILABLE — (Устарело) Указывает на шаблон аутентификации для неподдерживаемого региона.INCORRECT_CATEGORY — Указывает, что содержимое шаблона не соответствует категории, указанной при создании шаблона.INVALID_FORMAT — Указывает на недопустимый формат шаблона.NONE: Указывает на приостановку работы шаблона.РЕКЛАМНЫЙ МАТЕРИАЛ — Этот шаблон содержит контент, нарушающий наши правила.МОШЕННИЧЕСТВО — Указывает на то, что шаблон содержит контент, нарушающий наши правила.TAG_CONTENT_MISMATCH — Указывает, что содержимое шаблона не соответствует категории, указанной при создании шаблона. | INVALID_FORMAT |
<TITLE>Нить | Заголовок события паузы или возобновления работы шаблона. Возможные значения: FIRST_PAUSE — Указывает на то, что выполнение шаблона было приостановлено впервые.SECOND_PAUSE — Указывает на то, что шаблон был приостановлен во второй раз.RATE_LIMITING_PAUSE — Указывает на приостановку работы шаблона из-за ограничения скорости запросов.ОТМЕНА ПАУЗЫ — Указывает на то, что шаблон был возобновлен.ОТКЛЮЧЕНО — Указывает на то, что шаблон отключен. | ПЕРВАЯ ПАУЗА |
<WEBHOOK_TRIGGER_TIMESTAMP>Целое число | Временная метка Unix, указывающая на момент срабатывания веб-перехватчика. | 1739321024 |
<WHATSAPP_BUSINESS_ACCOUNT_ID>Нить | Идентификатор бизнес-аккаунта WhatsApp. | 102290129340398 |
<MESSAGE_TEMPLATE_CATEGORY>Нить | Категория шаблонов. Возможные значения: МАРКЕТИНГ — Указывает на то, что шаблон относится к категории МАРКЕТИНГ.UTILITY — Указывает, что шаблон относится к категории UTILITY.Аутентификация — указывает, что шаблон относится к категории «Аутентификация». | МАРКЕТИНГ |
<REASON_INFO>Нить | Предоставляет подробное объяснение причин отклонения шаблона. В этом поле описывается конкретная проблема, обнаруженная в содержимом шаблона. | В вашем шаблоне параметры расположены рядом друг с другом (например, {{1}}{{2}}) без текста или знаков препинания между ними. |
<RECOMMENDATION_INFO>Нить | Предлагает практические рекомендации по изменению шаблона для устранения причины отклонения. В этом поле представлены рекомендации по редактированию содержимого шаблона. | Разделите параметры описательным текстом и убедитесь, что каждый параметр четко контекстуализирован. |
Пример
В этом примере веб-перехватчика описывается утвержденный шаблон.
{
"entry": [
{
"id": "102290129340398",
"time": 1751247548,
"changes": [
{
"value": {
"event": "APPROVED",
"message_template_id": 1689556908129832,
"message_template_name": "order_confirmation",
"message_template_language": "en-US",
"reason": "NONE",
"message_template_category": "UTILITY"
},
"field": "message_template_status_update"
}
]
}
],
"object": "whatsapp_business_account"
}
В этом примере веб-перехватчика описывается шаблон, который был отклонен с ошибкой INVALID_FORMAT.
{
"entry": [
{
"id": "102290129340398",
"time": 1751247548,
"changes": [
{
"value": {
"event": "REJECTED",
"message_template_id": 1689556908129835,
"message_template_name": "abandoned_cart",
"message_template_language": "en",
"reason": "INVALID_FORMAT",
"message_template_category": "MARKETING",
"rejection_info": {
"reason": "В вашем шаблоне параметры расположены рядом друг с другом (например, {{1}}{{2}}) без текста или знаков препинаниямежду ними.",
"recommendation": "Разделите параметры описательным текстом и убедитесь, что каждый параметр четко контекстуализирован."
}
},
"field": "message_template_status_update"
}
]
}
],
"object": "whatsapp_business_account"
}