Le webhook phone_number_quality_update
phone_number_quality_update signale les changements de débit et de limite de messagerie d’un numéro. En 2026, il ne contient pas la note de qualité verte, jaune ou rouge malgré son nom : celle-ci doit être lue directement sur le numéro.
L’année où le contenu de ce champ a cessé d’indiquer la note par couleur.
Les notes de qualité possibles pour un numéro : verte, jaune et rouge, dont aucune n’arrive ici.
L’erreur renvoyée par un numéro une fois la limitation liée à la qualité activée.
Que contient réellement ce webhook ?
Des informations sur le débit et la limite de messagerie, transmises comme valeur d’événement avec des champs indiquant la limite actuelle.
Concrètement, cela signifie que la capacité d’un numéro a changé : il est passé à un autre niveau de messagerie ou son débit a été ajusté. Il est utile d’enregistrer ces changements, car ils modifient ce qu’une intégration peut faire et parce qu’une baisse de niveau constitue un signal précoce.
En revanche, la note de qualité n’y figure pas malgré le nom du champ. Un gestionnaire fondé sur une ancienne documentation cherchera GREEN, YELLOW ou RED ici et ne trouvera rien, puis conclura à tort que la qualité ne change jamais.
D’où vient alors la note par couleur ?
Elle vient d’une lecture directe du numéro, effectuée selon un calendrier.
Le champ quality_rating se trouve sur l’objet du numéro dans la Graph API et doit être lu périodiquement plutôt qu’attendu. C’est pourquoi une surveillance correcte d’une connexion nécessite à la fois un mécanisme d’interrogation et un récepteur de webhook : les deux transportent des informations différentes et aucun ne suffit seul.
C’est aussi pourquoi une baisse de qualité reste invisible pour la plupart des intégrations. Rien ne la transmet, l’application WhatsApp Business ne l’affiche pas et, lorsqu’elle produit enfin l’erreur 131048, les envois concernés ont déjà échoué.
Erreurs courantes
- Chercher GREEN, YELLOW ou RED dans ce payload. En 2026, ils n’y figurent pas.
- Construire la surveillance uniquement avec des webhooks. La note de qualité doit être lue périodiquement.
- Ignorer une baisse de niveau. C’est généralement le premier signe visible d’un problème.
EasyCoexistence lit périodiquement la note de qualité, le niveau de messagerie et le débit de chaque numéro connecté, puis enregistre chaque contrôle afin qu’une baisse soit visible avant de faire échouer un envoi.
Questions fréquemment posées
Pourquoi le champ porte-t-il le nom de la qualité ?
Il date d’avant le changement. Le nom est resté tandis que le contenu a évolué, ce qui explique cette confusion.
À quelle fréquence faut-il lire la note ?
Assez souvent pour détecter une baisse avant qu’elle ne devienne une limite. Nous effectuons ces lectures selon un calendrier plutôt qu’à la demande.
L’application affiche-t-elle la note ?
Non. Rien ne l’affiche dans l’application WhatsApp Business du téléphone.
L’erreur 131048 est-elle liée ?
Oui. C’est l’erreur qu’un numéro commence à renvoyer lorsqu’une note faible entraîne une limitation.
Poursuivre la lecture
Prêt à commencer ?
Configurez WhatsApp Coexistence en quelques minutes, pas en quelques mois. L’application continue de fonctionner sur le téléphone.
Commencer l'essai gratuitVérifié le