De phone_number_quality_update-webhook
phone_number_quality_update meldt wijzigingen in throughput en berichtlimiet voor een nummer. In 2026 bevat deze ondanks de naam niet de groene, gele of rode kwaliteitsbeoordeling. Die moet je rechtstreeks op het telefoonnummer opvragen.
Het jaar waarin de inhoud van dit veld veranderde en niet langer de kleurbeoordeling bevatte.
De kwaliteitsbeoordelingen die een nummer kan hebben: groen, geel en rood; geen daarvan komt hier aan.
De fout die een nummer retourneert zodra kwaliteitsbeperking actief wordt.
Wat bevat deze webhook echt?
Informatie over throughput en berichtlimieten, afgeleverd als eventwaarde met velden die de huidige limiet bevatten.
In de praktijk betekent dit dat de capaciteit van een nummer is veranderd: het is naar een andere berichtentier gegaan of het throughputniveau is aangepast. Het is nuttig om dit vast te leggen, omdat het bepaalt wat een integratie kan doen en een dalende tier een vroeg signaal is.
Wat er ondanks de veldnaam niet in staat, is de kwaliteitsbeoordeling. Een handler die op oudere documentatie is gebaseerd, zoekt hier naar GREEN, YELLOW of RED en vindt niets. Daarna concludeert die ten onrechte dat de kwaliteit nooit verandert.
Waar komt de kleurbeoordeling dan vandaan?
Door het telefoonnummer rechtstreeks en volgens een schema te lezen.
Het veld quality_rating staat op het telefoonnummerobject in de Graph API en moet worden gepolld. Daarom heeft goede monitoring van een verbinding zowel een poller als een webhookontvanger nodig: de twee bevatten verschillende gegevens en geen van beide is op zichzelf voldoende.
Daarom blijft een kwaliteitsdaling voor de meeste integraties onzichtbaar. Er wordt niets naartoe gestuurd, de WhatsApp Business-app toont geen aanwijzing en tegen de tijd dat fout 131048 verschijnt, zijn de betreffende verzendpogingen al mislukt.
Veelgemaakte fouten
- GREEN, YELLOW of RED zoeken in deze payload. In 2026 staan die er niet in.
- Monitoring alleen op webhooks baseren. De kwaliteitsbeoordeling moet je pollen.
- Een dalende tier negeren. Dat is meestal het eerste zichtbare teken van een probleem.
EasyCoexistence polt de kwaliteitsbeoordeling, berichtentier en het throughputniveau van elk verbonden nummer en legt elke controle vast, zodat een daling zichtbaar is voordat die een verzending kost.
Veelgestelde vragen
Waarom heet het veld dan naar kwaliteit?
De naam dateert van vóór de wijziging. De naam bleef behouden terwijl de inhoud veranderde, waardoor dit vaak verwarrend is.
Hoe vaak moet ik de beoordeling pollen?
Vaak genoeg om een daling te zien voordat die tot een beperking leidt. We pollen volgens een schema en niet op aanvraag.
Toont de app de beoordeling?
Nee. In de WhatsApp Business-app op de telefoon is hierover niets zichtbaar.
Heeft 131048 hiermee te maken?
Ja. Dat is de fout die een nummer begint te retourneren zodra een lage beoordeling tot een beperking leidt.
Lees verder
Klaar om te beginnen?
Stel WhatsApp Coexistence in enkele minuten in, niet maanden. De app blijft op je telefoon werken.
Start je gratis proefperiodeGeverifieerd op