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

Справочник по веб-перехватчику 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"
    }