Справочник по веб-перехватчику message_template_status_update | Документация для разработчиков

ссылка на веб-перехватчик message_template_status_update

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

message_template_status_update бизнес-аккаунта WhatsApp .

Веб 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 > ",
 "disable_info": {
 "disable_date": "
 < DISABLE_TIMESTAMP > " },

 --> "другая_информация": {
 "заголовок": "
 < ЗАГОЛОВОК > ", "описание": "
 < ОПИСАНИЕ > " },

 ID_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" }