whatsapp.template.category_updated

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

Триггеры

Происходит при обновлении категории шаблона WhatsApp. Подпишитесь на whatsapp.template.category_updated, когда будете настраивать конечную точку вебхука. Сравните previousCategory с category, чтобы определить изменение категории.

Синтаксис

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

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

Параметры

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

Оболочка события

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

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

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

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

whatsappTemplate

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

Пример

Следующий JSON представляет собой тело запроса, доставленное на ваш приемник. Идентификаторы, номера телефонов и другие значения учетных записей приведены в качестве примера.

{
  "id": "evt_example_whatsapp_template_category_updated",
  "type": "whatsapp.template.category_updated",
  "apiVersion": "v2",
  "createTime": "2026-05-26T12:00:00.000Z",
  "whatsappTemplate": {
    "officialTemplateId": "official-template-id",
    "wabaId": "whatsapp-business-account-id",
    "name": "order_update",
    "language": "en_US",
    "previousCategory": "UTILITY",
    "category": "MARKETING"
  }
}

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

HTTP/1.1 200 OK

Разборы сценариев см. в разделе аннотированные примеры.

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

Руководства

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

Webhook reference

whatsapp.template.category_updated

Триггеры

Синтаксис

Параметры

Оболочка события

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

whatsappTemplate

Пример

​Триггеры

​Синтаксис

​Параметры

​Оболочка события

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

​whatsappTemplate

​Пример

Триггеры

Синтаксис

Параметры

Оболочка события

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

whatsappTemplate

Пример