whatsapp.phone_number.quality_updated

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

Триггеры

Происходит при обновлении показателя качества, лимита на отправку сообщений или состояния подключения бизнес-номера WhatsApp. Подпишитесь на whatsapp.phone_number.quality_updated, когда настраиваете конечную точку Webhook. Не путайте messagingLimit телефонного номера с whatsappBusinessManagerMessagingLimit, который описывает общий лимит бизнес-портфолио владельца. Примеры уровней не являются значениями по умолчанию для аккаунта. Смотрите qualityUpdateEvent для отслеживания изменений качества или уровня. Когда это событие инициируется обновлением аккаунта, updateEvent идентифицирует ACCOUNT_OFFBOARDED или ACCOUNT_RECONNECTED.

Синтаксис

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

{
  "id": "<ID>",
  "type": "whatsapp.phone_number.quality_updated",
  "apiVersion": "<API_VERSION>",
  "createTime": "<CREATE_TIME>",
  "whatsappPhoneNumber": {
    "id": "<ID>",
    "phoneNumber": "<PHONE_NUMBER>",
    "displayPhoneNumber": "<DISPLAY_PHONE_NUMBER>",
    "wabaId": "<WABA_ID>",
    "qualityRating": "<QUALITY_RATING>",
    "messagingLimit": "<MESSAGING_LIMIT>",
    "whatsappBusinessManagerMessagingLimit": "<WHATSAPP_BUSINESS_MANAGER_MESSAGING_LIMIT>",
    "qualityUpdateEvent": "<QUALITY_UPDATE_EVENT>"
  }
}

Параметры

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

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

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

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

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

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

whatsappPhoneNumber

Параметр	Тип	Обязательный	Описание
`id`	string	Нет	Идентификатор телефонного номера.
`phoneNumber`	string	Нет	Телефонный номер в формате E.164.
`displayPhoneNumber`	string	Нет	Отображаемый телефонный номер.
`wabaId`	string	Нет	Идентификатор WhatsApp Business Account.
`qualityRating`	string	Нет	Оценка качества. Одно из следующих значений: `GREEN`, `YELLOW`, `RED` или `UNKNOWN`. См. также Phone Number Quality Rating. `GREEN`: высокое качество. `YELLOW`: среднее качество. `RED`: низкое качество. `UNKNOWN`: неизвестное качество.
`messagingLimit`	string	Нет	Ограничения на отправку сообщений определяют максимальное количество начатых компанией переписок, которое каждый номер телефона может начать за скользящий 24-часовой период. См. также Ограничения на отправку сообщений. `TIER_NOT_SET`: неизвестный лимит. `TIER_50`: 50 начатых компанией переписок за скользящий 24-часовой период. `TIER_250`: 250 начатых компанией переписок за скользящий 24-часовой период. `TIER_1K`: 1 тыс. начатых компанией переписок с уникальными клиентами за скользящий 24-часовой период. `TIER_10K`: 10 тыс. начатых компанией переписок с уникальными клиентами за скользящий 24-часовой период. `TIER_100K`: 100 тыс. начатых компанией переписок с уникальными клиентами за скользящий 24-часовой период. `TIER_UNLIMITED`: неограниченное количество начатых компанией переписок за скользящий 24-часовой период.
`whatsappBusinessManagerMessagingLimit`	string	Нет	Ограничение на отправку сообщений бизнес-портфолио владельца. Начиная с 7 октября 2025 года, лимиты на отправку сообщений будут рассчитываться и устанавливаться для каждого бизнес-портфолио и будут общими для всех рабочих телефонных номеров в рамках каждого портфолио. См. также phone_number_quality_справочник по Webhook. `TIER_NOT_SET`: номер телефона компании еще не использовался для отправки сообщений. `TIER_50`: лимит на отправку 50 начатых компанией переписок за скользящий 24-часовой период. `TIER_250`: лимит на отправку 250 начатых компанией переписок за скользящий 24-часовой период. `TIER_2K`: лимит на отправку 2 000 начатых компанией переписок за скользящий 24-часовой период. `TIER_10K`: лимит на отправку 10 000 начатых компанией переписок за скользящий 24-часовой период. `TIER_100K`: лимит на отправку 100 000 начатых компанией переписок за скользящий 24-часовой период. `TIER_UNLIMITED`: рабочий номер телефона имеет более высокую пропускную способность с неограниченным количеством начатых компанией переписок.
`qualityUpdateEvent`	string	Нет	Указывает тип события обновления качества телефонного номера WhatsApp при отправке вам уведомления. `ONBOARDING`: обычно при смене лимита сообщений с `TIER_NOT_SET` на другой уровень. `UPGRADE`: уровень лимита на отправку сообщений повышен. `DOWNGRADE`: уровень лимита на отправку сообщений понижен. `FLAGGED`: статус Flagged присваивается, когда рейтинг качества переходит в состояние «Низкое». Если качество сообщений повысится до высокого или среднего состояния и останется на этом уровне в течение 7 дней, статус снова изменится на Connected. Если рейтинг качества не улучшится, статус также вернется на Connected, но вы будете переведены на более низкий уровень лимита сообщений. Подробнее см. в документации по Phone Number Quality Rating. `UNFLAGGED`: статус номера телефона меняется с `FLAGGED` на `CONNECTED`.
`updateEvent`	string	Нет	Обновление аккаунта, вызвавшее изменение телефонного номера. Известные значения: `ACCOUNT_OFFBOARDED` и `ACCOUNT_RECONNECTED`.

Пример

Следующий JSON представляет собой тело запроса, доставленное вашему получателю. Идентификаторы, номера телефонов и другие значения аккаунта приведены для наглядности. Считывайте qualityRating и qualityUpdateEvent из whatsappPhoneNumber. messagingLimit описывает уровень телефонного номера; whatsappBusinessManagerMessagingLimit описывает ограничение бизнес-портфолио владельца.

{
  "id": "evt_phone_number_quality_updated_123",
  "type": "whatsapp.phone_number.quality_updated",
  "apiVersion": "v2",
  "createTime": "2026-05-26T12:00:00.000Z",
  "whatsappPhoneNumber": {
    "id": "1234567890123456",
    "phoneNumber": "+12025550124",
    "displayPhoneNumber": "+1 631-555-1111",
    "wabaId": "whatsapp-business-account-id",
    "qualityRating": "GREEN",
    "messagingLimit": "TIER_1K",
    "whatsappBusinessManagerMessagingLimit": "TIER_2K",
    "qualityUpdateEvent": "ONBOARDING"
  }
}

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

HTTP/1.1 200 OK

Пошаговый разбор сценариев см. в примерах с пояснениями.

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

Руководства

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

Webhook reference

whatsapp.phone_number.quality_updated

Триггеры

Синтаксис

Параметры

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

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

whatsappPhoneNumber

Пример

​Триггеры

​Синтаксис

​Параметры

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

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

​whatsappPhoneNumber

​Пример

Триггеры

Синтаксис

Параметры

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

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

whatsappPhoneNumber

Пример