Meta Tech Provider

Webhook phone_number_quality_update

phone_number_quality_update zgłasza zmiany przepustowości i limitu wiadomości dla numeru. W 2026 roku nie zawiera zielonej, żółtej ani czerwonej oceny jakości, mimo swojej nazwy. Ocenę trzeba odczytać bezpośrednio z numeru telefonu.

2026

Rok, w którym zawartość tego pola przestała dotyczyć oceny kolorystycznej.

Oceny jakości numeru: zielona, żółta i czerwona. Żadna z nich nie jest tutaj przekazywana.

131048

Błąd zwracany przez numer po rozpoczęciu ograniczania z powodu jakości.

Co naprawdę zawiera ten webhook?

Informacje o przepustowości i limicie wiadomości, przekazane jako wartość zdarzenia oraz pola zawierające bieżący limit.

W praktyce oznacza to, że zmieniła się przepustowość numeru: przeszedł on na inny poziom wiadomości albo zmieniono jego poziom przepustowości. Warto to zapisywać, ponieważ wpływa na możliwości integracji, a obniżenie poziomu jest wczesnym sygnałem problemu.

Mimo nazwy pola nie ma tu oceny jakości. Obsługa napisana na podstawie starszej dokumentacji będzie szukać tutaj wartości GREEN, YELLOW lub RED, niczego nie znajdzie i uzna, że jakość nigdy się nie zmienia.

Skąd w takim razie pochodzi ocena kolorystyczna?

Z bezpośredniego odczytu numeru telefonu wykonywanego według harmonogramu.

Pole quality_rating znajduje się w obiekcie numeru telefonu w Graph API i trzeba je odpytywać, zamiast czekać na zdarzenie. Dlatego prawidłowe monitorowanie połączenia wymaga zarówno modułu odpytywania, jak i odbiornika webhooków: oba przekazują różne informacje i żaden nie wystarcza samodzielnie.

Dlatego spadek jakości jest niewidoczny dla większości integracji. Nic go nie wysyła, aplikacja WhatsApp Business nie pokazuje żadnego sygnału, a gdy pojawia się błąd 131048, wysyłane wiadomości już wcześniej zakończyły się niepowodzeniem.

Typowe błędy

Szukanie GREEN, YELLOW lub RED w tym payloadzie. W 2026 roku ich tu nie ma.
Budowanie monitorowania wyłącznie na webhookach. Ocenę jakości trzeba odpytywać.
Ignorowanie spadku poziomu. Zwykle jest to pierwszy widoczny sygnał problemu.

Z EasyCoexistence zrobisz to

EasyCoexistence odpytywań ocenę jakości, poziom wiadomości i przepustowość każdego połączonego numeru oraz zapisuje każdą kontrolę, dzięki czemu spadek widać, zanim kosztuje Cię wysłaną wiadomość.

Najczęściej zadawane pytania

Dlaczego pole nosi nazwę związaną z jakością?

Nazwa pochodzi sprzed zmiany. Pozostała taka sama, choć zawartość się zmieniła, dlatego to pole wprowadza wiele osób w błąd.

Jak często odpytywać ocenę?

Wystarczająco często, aby wykryć spadek, zanim przerodzi się w ograniczenie. Odpytywanie odbywa się według harmonogramu, a nie na żądanie.

Czy aplikacja pokazuje ocenę?

Nie. Aplikacja WhatsApp Business na telefonie nie pokazuje żadnych informacji na jej temat.

Czy 131048 ma z tym związek?

Tak. To błąd zwracany przez numer, gdy niska ocena prowadzi do ograniczenia.

Czytaj dalej

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.

Gotowy, aby zacząć?

Skonfiguruj WhatsApp Coexistence w kilka minut, nie miesięcy. Aplikacja nadal działa na telefonie.

Rozpocznij bezpłatny okres próbny

Zweryfikowano w 2026-09-22