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

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

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

Обновлено: 14 ноября 2025 г
message_template_status_update бизнес-аккаунта WhatsApp .
Веб message_template_status_update уведомляет вас об изменениях статуса существующего шаблона.

Триггеры

    Шаблон утвержден.Шаблон отклонен.Шаблон отключен.

    Синтаксис

    
    
    {
    "вход":
    [
    {
    "идентификатор": "<Идентификатор бизнес-аккаунта WhatsApp>",
          "время": <WEBHOOK_TRIGGER_TIMESTAMP>,
          "изменения": [
            {
              "ценить": {
                "event": "<EVENT>",
                "message_template_id": <TEMPLATE_ID>,
                "message_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 -->
                "other_info": {
                  "заголовок": "<TITLE>",
                  "описание": "<DESCRIPTION>"
                },

    <!-- 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>
    Нить
    Событие статуса шаблона. Возможные значения:
    ОДОБРЕННЫЙ - Indicates the template has been approved and can now be sent in template messages.
    ARCHIVED: Indicates the template has been archived to keep the list of templates in WhatsApp manager clean. DELETED - Indicates the template has been deleted.
    НЕПОЛНОЦЕННЫЙ - Indicates the template has been disabled due to user feedback.
    FLAGGED - Indicates the template has received negative feedback and is at risk of being disabled.
    IN_APPEAL - Indicates the template is in the appeal process.
    LIMIT_EXCEEDED - Indicates the WhatsApp Business Account template is at its template limit.
    LOCKED - Indicates the template has been locked and cannot be edited.
    ПАУЗА - Indicates the template has been paused.
    В ОЖИДАНИИ - Indicates the template is undergoing template review.
    REINSTATED - Indicates the template is no longer flagged or disabled and can be sent in template messages again.
    ОЖИДАЕТ УДАЛЕНИЯ - Indicates template has been deleted via WhatsApp Manager.
    ОТКЛОНЕННЫЙ - Indicates the template has been rejected. You can edit the template to have it undergo template review again or appeal the rejection.
    ОДОБРЕННЫЙ
    <TEMPLATE_ID>
    Целое число
    Идентификатор шаблона.
    1689556908129832
    <TEMPLATE_NAME>
    Нить
    Название шаблона.
    подтверждение заказа
    <TEMPLATE_LANGUAGE_AND_LOCALE_CODE>
    Нить
    шаблона код локали
    en-US
    <REASON>
    Нить
    Причина отклонения шаблона, если шаблон отклонен.
    Если шаблон запланирован к удалению, значение будет равно null, а не строке. В противном случае значения могут быть следующими:
    ABUSIVE_CONTENT - Indicates template contains content that violates our policies.
    CATEGORY_NOT_AVAILABLE - (Deprecated) Indicates an authentication templates for an unsupported region.
    INCORRECT_CATEGORY - Указывает на шаблон'шаблон's content ненеt match the category designated at the time of template creation.
    INVALID_FORMAT - Indicates template has an invalid format.
    NONE : Указывает на приостановку работы шаблона.
    PROMOTIONAL - Indicates template contains content that violates our policies.
    МОШЕННИЧЕСТВО - Indicates template contains content that violates our policies.
    TAG_CONTENT_MISMATCH - Указывает на шаблон'шаблон's content ненеt match the category designated at the time of template creation.
    INVALID_FORMAT
    <TITLE>
    Нить
    Заголовок события паузы или возобновления работы шаблона.
    Возможные значения:
    ПЕРВАЯ ПАУЗА - Indicates template has been paused for the first time.
    SECOND_PAUSE - Indicates the template has been paused a second time.
    RATE_LIMITING_PAUSE - Indicates template has been paused due to rate limiting.
    UNPAUSE - Indicates template has been unpaused.
    НЕПОЛНОЦЕННЫЙ - Indicates template has been disabled.
    ПЕРВАЯ ПАУЗА
    <WEBHOOK_TRIGGER_TIMESTAMP>
    Целое число
    Временная метка Unix, указывающая на момент срабатывания веб-перехватчика.
    1739321024
    <WHATSAPP_BUSINESS_ACCOUNT_ID>
    Нить
    Идентификатор бизнес-аккаунта WhatsApp.
    102290129340398
    <MESSAGE_TEMPLATE_CATEGORY>
    Нить
    Категория шаблонов.
    Возможные значения:
    МАРКЕТИНГ - Indicates template is categorized as MARKETING.
    КОММУНАЛЬНЫЕ УСЛУГИ - Indicates the template is categorized as UTILITY.
    Аутентификация - Indicates template is categorized as AUTHENTICATION.
    МАРКЕТИНГ
    <REASON_INFO>
    Нить
    Предоставляет подробное объяснение причин отклонения шаблона. В этом поле описывается конкретная проблема, обнаруженная в содержимом шаблона.
    В вашем шаблоне параметры расположены рядом друг с другом (например, {{1}}{{2}}) без текста или знаков препинания между ними.
    <RECOMMENDATION_INFO>
    Нить
    Предлагает практические рекомендации по изменению шаблона для устранения причины отклонения. В этом поле представлены рекомендации по редактированию содержимого шаблона.
    Разделите параметры описательным текстом и убедитесь, что каждый параметр четко контекстуализирован.

    Пример

    В этом примере веб-перехватчика описывается утвержденный шаблон.
    
    
    {
    "вход":
    [
        {
    "идентификатор""102290129340398",
    "время"1751247548,
    "изменения": [
            {
    "ценить": {
    "событие""ОДОБРЕННЫЙ",
    "message_template_id"1689556908129832,
    "message_template_name""order_confirmation",
    "message_template_language""en-US",
    "причина""НИКТО",
    "message_template_category""Утилиты"
              },
    "поле""message_template_status_update"
            }
          ]
        }
      ],
    "объект""whatsapp_business_account"
    }
    В этом примере веб-перехватчика описывается шаблон, который был отклонен с ошибкой INVALID_FORMAT.
    
    
    {
    "вход": [
        {
    "идентификатор""102290129340398",
    "время"1751247548,
    "изменения": [
            {
    "ценить": {
    "событие""ОТКЛОНЕННЫЙ",
    "message_template_id"1689556908129835,
    "message_template_name""abandoned_cart",
    "message_template_language""ен",
    "причина""INVALID_FORMAT",
    "message_template_category"«МАРКЕТИНГ»,
    "rejection_info": {
    "причина""Your template has parameters placed next to each other (like {{1}}{{2}}) without text or punctuation between them.",
    "recommendation""Separate parameters with descriptive text and ensure each parameter is clearly contextualized."
                }
              },
    "поле""message_template_status_update"
            }
          ]
        }
      ],
    "объект""whatsapp_business_account"
    }