whatsapp.template.quality_updated

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

Триггеры

Происходит при обновлении рейтинга качества шаблона WhatsApp. Подпишитесь на whatsapp.template.quality_updated, когда будете настраивать свою конечную точку Webhook.

Синтаксис

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

{
  "id": "<ID>",
  "type": "whatsapp.template.quality_updated",
  "apiVersion": "<API_VERSION>",
  "createTime": "<CREATE_TIME>",
  "whatsappTemplate": {
    "officialTemplateId": "<OFFICIAL_TEMPLATE_ID>",
    "wabaId": "<WABA_ID>",
    "name": "<NAME>",
    "language": "<LANGUAGE>",
    "qualityRating": "<QUALITY_RATING>"
  }
}

Параметры

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

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

Параметр	Тип	Обязательный	Описание
`id`	string	Да	Уникальный идентификатор события. Минимальная длина: `6`. Максимальная длина: `128`.
`type`	string	Да	Всегда `whatsapp.template.quality_updated`.
`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	Да	Код языка шаблона. Все коды см. в разделе Поддерживаемые языки.
`qualityRating`	string	Нет	Рейтинг качества шаблона WhatsApp. Одно из значений: `GREEN`, `YELLOW`, `RED` или `UNKNOWN`. См. также Рейтинг качества шаблона. `GREEN`: высокое качество. `YELLOW`: среднее качество. `RED`: низкое качество. `UNKNOWN`: неизвестное качество.

Пример

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

{
  "id": "evt_example_whatsapp_template_quality_updated",
  "type": "whatsapp.template.quality_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",
    "qualityRating": "GREEN"
  }
}

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

HTTP/1.1 200 OK

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

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

Руководства

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

Webhook reference

whatsapp.template.quality_updated

Триггеры

Синтаксис

Параметры

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

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

whatsappTemplate

Пример

​Триггеры

​Синтаксис

​Параметры

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

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

​whatsappTemplate

​Пример

Триггеры

Синтаксис

Параметры

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

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

whatsappTemplate

Пример