Meta Tech Provider

Вебхук phone_number_quality_update

phone_number_quality_update сообщает об изменениях пропускной способности и лимита сообщений для номера. В 2026 году он не передаёт зелёный, жёлтый или красный рейтинг качества, несмотря на название. Рейтинг нужно получать опросом номера.

2026

Год, когда содержимое этого поля перестало отражать цветовой рейтинг.

Рейтинги качества номера: зелёный, жёлтый и красный. Ни один из них здесь не передаётся.

131048

Ошибка, которую номер возвращает после введения ограничения из-за качества.

Что на самом деле содержит этот вебхук?

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

На практике это означает, что ёмкость номера изменилась: он перешёл на другой уровень сообщений или для него скорректировали пропускную способность. Это важно записывать, поскольку такие изменения влияют на возможности интеграции, а снижение уровня служит ранним сигналом.

Несмотря на имя поля, рейтинга качества здесь нет. Обработчик, написанный по старой документации, будет искать здесь GREEN, YELLOW или RED, ничего не найдёт и решит, что качество никогда не меняется.

Откуда тогда берётся цветовой рейтинг?

Его нужно регулярно получать напрямую из номера.

Поле quality_rating находится в объекте номера телефона в Graph API. Его нужно получать опросом, а не ждать события. Поэтому для полноценного мониторинга подключения нужны и опрос, и приём вебхуков: они передают разные данные, и по отдельности недостаточны.

По этой же причине падение качества незаметно для большинства интеграций. Оно не отправляется автоматически, в приложении WhatsApp Business на телефоне его не видно, а когда появляется ошибка 131048, затронутые отправки уже завершились с ошибкой.

Распространённые ошибки

Искать GREEN, YELLOW или RED в этом теле запроса. В 2026 году их там нет.
Строить мониторинг только на вебхуках. Рейтинг качества нужно получать опросом.
Игнорировать снижение уровня. Обычно это первый заметный признак проблемы.

Настройка с EasyCoexistence

EasyCoexistence получает рейтинг качества, уровень сообщений и пропускную способность каждого подключённого номера по расписанию и записывает каждую проверку. Поэтому снижение видно до того, как оно приведёт к сбою отправки.

Часто задаваемые вопросы

Почему поле называется по рейтингу качества?

Оно появилось до изменения. Название сохранилось, а содержимое изменилось, поэтому оно вводит в заблуждение.

Как часто нужно получать рейтинг опросом?

Достаточно часто, чтобы заметить снижение до введения ограничения. Мы опрашиваем номера по расписанию, а не по запросу.

Показывает ли рейтинг приложение?

Нет. В приложении WhatsApp Business на телефоне рейтинг не отображается.

Связана ли с этим ошибка 131048?

Да. Номер начинает возвращать эту ошибку, когда низкий рейтинг приводит к ограничению.

Читайте дальше

The phone_number_name_update webhookMeta reports display name approvals and rejections here. It is the only place the decision appears, and nothing shows it in the app.The message_template_status_update webhookMeta reports template approvals, rejections and disabling here. What each status means and why it removes the need to poll.WhatsApp error 131048: spam rate limit hitError 131048 means the number's quality has dropped far enough that Meta is limiting sends. What causes the drop and how a number recovers.A number stopped working: how to find out whyA checklist in the order these failures actually happen: token, webhook override, inactivity disconnection, quality, and account restriction.

Готовы начать?

Настройте WhatsApp Coexistence за несколько минут, а не месяцев. Приложение продолжит работать на телефоне.

Начать бесплатный пробный период

Проверено по состоянию на 2026-09-22