whatsapp.template.correct_category_detection

Используйте whatsapp.template.correct_category_detection для обработки этого события на вашей конечной точке Webhook.

Триггеры

Происходит, когда Meta обнаруживает неслужебный контент в Utility Direct Send. Подпишитесь через API конечных точек Webhook. Подпишитесь на whatsapp.template.correct_category_detection, когда будете настраивать свою конечную точку Webhook. Подпишитесь на это событие через API конечных точек Webhook. Это событие сообщает об определении категории для Utility Direct Send; используйте whatsapp.business_account.updated для отслеживания ограничений аккаунта.

Синтаксис

YCloud отправляет HTTP-запрос POST на ваш настроенный URL-адрес Webhook. Ниже показан один из вариантов полезной нагрузки. Значения в угловых скобках являются плейсхолдерами; их типы перечислены в разделе Параметры. Необязательные поля и другие варианты описаны ниже.

{
  "id": "<ID>",
  "type": "whatsapp.template.correct_category_detection",
  "apiVersion": "<API_VERSION>",
  "createTime": "<CREATE_TIME>",
  "whatsappTemplate": {
    "officialTemplateId": "<OFFICIAL_TEMPLATE_ID>",
    "wabaId": "<WABA_ID>",
    "name": "<NAME>",
    "language": "<LANGUAGE>",
    "category": "<CATEGORY>",
    "previousCategory": "<PREVIOUS_CATEGORY>"
  }
}

Параметры

Проверьте HTTP-заголовок YCloud-Signature перед обработкой тела JSON. См. раздел проверка подписи.

Конверт события

Параметр	Тип	Обязательный	Описание
`id`	string	Да	Уникальный идентификатор события. Минимальная длина: `6`. Максимальная длина: `128`.
`type`	string	Да	Всегда `whatsapp.template.correct_category_detection`.
`apiVersion`	string	Да	Версия API, используемая для формирования этого события.
`createTime`	string (date-time)	Да	Время создания этого события в формате RFC 3339. Например, `2022-06-01T12:00:00.000Z`.

Полезная нагрузка события

Параметр	Тип	Обязательный	Описание
`whatsappTemplate`	object	Нет	Полезная нагрузка `whatsappTemplate`, специфичная для события.

Четыре общих поля конверта обязательны. Поля полезной нагрузки зависят от варианта события. В каждой таблице объекта статус Обязательный действует при наличии родительского объекта. Необязательные поля можно опускать; наличие поля в примере не делает его обязательным.

whatsappTemplate

Параметр	Тип	Обязательный	Описание
`officialTemplateId`	string	Нет	Официальный идентификатор шаблона, присвоенный WhatsApp. Этот идентификатор используется для идентификации шаблона в системе WhatsApp.
`wabaId`	string	Да	Идентификатор WhatsApp Business Account.
`name`	string	Да	Название шаблона. Максимальная длина: `512`. Шаблон: `[a-z0-9]{1,512}`.
`language`	string	Да	Код языка шаблона. Все коды см. в разделе Поддерживаемые языки.
`category`	string	Нет	Категория шаблонов WhatsApp. `AUTHENTICATION`: Позволяет компаниям аутентифицировать пользователей с помощью одноразовых паролей, потенциально на нескольких этапах процесса входа (например, подтверждение аккаунта, восстановление доступа, проверки безопасности). `MARKETING`: Включает рекламные акции или предложения, информационные обновления либо приглашения для клиентов ответить / совершить действие. Любая переписка, не квалифицируемая как служебная (utility) или аутентификационная, считается маркетинговой. `UTILITY`: Содействует выполнению конкретного согласованного запроса или транзакции либо информированию клиента о текущей транзакции, включая уведомления после покупки и регулярные выписки по счету.
`previousCategory`	string	Нет	Это поле указывает предыдущую категорию шаблона (или `null` для шаблонов, созданных после 1 апреля 2023 года). Сравните это значение со значением поля `category` шаблона, которое указывает текущую категорию шаблона.

Пример

Ниже представлен JSON тела запроса, доставленного вашему получателю. Идентификаторы, телефонные номера и другие значения аккаунта приведены для наглядности. Meta обнаружила маркетинговый контент в сообщении Utility Direct Send. Подпишитесь на это событие через API конечных точек Webhook.

{
  "id": "evt_direct_send_category_123",
  "type": "whatsapp.template.correct_category_detection",
  "apiVersion": "v2",
  "createTime": "2026-09-17T08:00:00.000Z",
  "whatsappTemplate": {
    "officialTemplateId": "official-template-id",
    "wabaId": "whatsapp-business-account-id",
    "name": "auto_generated_sample",
    "language": "en_US",
    "category": "MARKETING",
    "previousCategory": "UTILITY"
  }
}

После проверки подписи и надежного принятия события верните ответ 2xx. Длительные операции выполняйте асинхронно.

HTTP/1.1 200 OK

Пошаговые разборы сценариев см. в разделе annotated examples.

Начало работы

Руководства

Конечные точки

Webhook reference

whatsapp.template.correct_category_detection

Триггеры

Синтаксис

Параметры

Конверт события

Полезная нагрузка события

whatsappTemplate

Пример

​Триггеры

​Синтаксис

​Параметры

​Конверт события

​Полезная нагрузка события

​whatsappTemplate

​Пример

Триггеры

Синтаксис

Параметры

Конверт события

Полезная нагрузка события

whatsappTemplate

Пример