Meta Tech Provider

Webhook phone_number_quality_update

phone_number_quality_update prijavljuje promjene propusnosti i limita slanja poruka za broj. Od 2026. ne nosi zelenu, žutu ni crvenu ocjenu kvalitete, unatoč nazivu, pa se ocjena mora dohvaćati izravno s telefonskog broja.

2026

Godina u kojoj se sadržaj ovog polja promijenio i više ne prikazuje ocjenu označenu bojom.

Ocjene kvalitete koje broj može imati: zelena, žuta i crvena, a nijedna od njih ne stiže ovdje.

131048

Pogreška koju broj vraća nakon aktiviranja ograničenja zbog kvalitete.

Što ovaj webhook zapravo sadrži?

Informacije o propusnosti i limitu slanja poruka, isporučene kao vrijednost događaja i polja koja nose trenutačni limit.

Praktično, sadržaj znači da se kapacitet broja promijenio: prešao je na drugu razinu slanja poruka ili mu je prilagođena razina propusnosti. To je korisno bilježiti jer mijenja mogućnosti integracije, a spuštanje razine rani je signal problema.

Ono što nije u njemu, unatoč nazivu polja, jest ocjena kvalitete. Obrađivač napisan prema starijoj dokumentaciji ovdje će tražiti GREEN, YELLOW ili RED i neće pronaći ništa, pa će zaključiti da se kvaliteta nikad ne mijenja.

Odakle onda dolazi ocjena označena bojom?

Izravnim očitavanjem telefonskog broja prema rasporedu.

Polje quality_rating nalazi se na objektu telefonskog broja u Graph API-ju i mora se periodično dohvaćati, a ne čekati. Zato pravilno praćenje veze treba i mehanizam za periodično dohvaćanje i prijamnik webhooka: oni nose različite podatke i nijedan sam nije dovoljan.

Zato je pad kvalitete nevidljiv većini integracija. Ništa ga ne šalje, aplikacija WhatsApp Business na telefonu ne prikazuje nikakav znak, a kada se pojavi error 131048, neuspjela slanja već su se dogodila.

Uobičajene pogreške

Traženje GREEN, YELLOW ili RED u ovom payloadu. Od 2026. toga ovdje nema.
Izrada praćenja samo na temelju webhookova. Ocjenu kvalitete treba periodično dohvaćati.
Zanemarivanje smanjenja razine. To je obično prvi vidljivi znak problema.

Radite ovo uz EasyCoexistence

EasyCoexistence provjerava ocjenu kvalitete, razinu slanja poruka i propusnost svakog povezanog broja te bilježi svaku provjeru, pa je pad vidljiv prije nego što uzrokuje neuspjelo slanje.

Često postavljana pitanja

Zašto je polje nazvano prema kvaliteti?

Naziv potječe iz vremena prije promjene. Ostao je isti dok se sadržaj promijenio, pa to često zbunjuje korisnike.

Koliko često treba dohvaćati ocjenu?

Dovoljno često da se pad uoči prije nego što postane ograničenje. Mi je dohvaćamo prema rasporedu, a ne na zahtjev.

Prikazuje li aplikacija ocjenu?

Ne. Aplikacija WhatsApp Business na telefonu ne prikazuje nikakve podatke o njoj.

Je li 131048 povezan s tim?

Da. To je pogreška koju broj počinje vraćati kada niska ocjena uzrokuje ograničenje.

Nastavite čitati

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.

Spremni za početak?

Postavite WhatsApp Coexistence u nekoliko minuta, a ne mjeseci. Aplikacija i dalje radi na telefonu.

Započnite besplatno probno razdoblje

Provjereno na 2026-09-22