API WhatsApp et le quality rating : guide pour les outils de marketing automation

Le quality rating WhatsApp est le score attribué par Meta à chaque numéro de téléphone enregistré sur l'API WhatsApp Business. Il reflète la qualité perçue des messages envoyés, mesurée principalement par les signalements et les blocages des destinataires. Pour une plateforme de marketing automation, ce score conditionne directement la capacité d'envoi de chaque client — l'ignorer dans votre architecture, c'est exposer vos clients à des coupures sans préavis.

Comment Meta calcule le quality rating

Meta évalue le quality rating sur une fenêtre glissante de 7 jours. Le score s'appuie sur :

• Le taux de blocage : proportion de destinataires qui bloquent l'expéditeur après réception d'un message.
• Le taux de signalement : messages signalés comme spam ou non désirés via l'interface WhatsApp.
• Le feedback implicite : absence de réponse et faible engagement, moins pondéré mais présent.

Meta ne communique pas l'algorithme exact. Ce qui est certain : les actions négatives des destinataires (bloquer, signaler) dégradent le score, les actions positives (répondre, cliquer) l'améliorent ou le stabilisent.

Le score est affiché dans le Meta WhatsApp Manager avec trois états :

Score	Couleur	Conséquence
Élevé	Vert	Envoi normal, limite de messagerie maximale
Moyen	Jaune	Surveillance, limite de messagerie peut diminuer
Faible	Rouge	Limitation immédiate, risque de suspension du numéro

Un numéro en rouge pendant 7 jours consécutifs est suspendu. La réactivation est possible mais prend du temps et nécessite une intervention dans le Meta Business Manager.

Pourquoi les plateformes de marketing automation sont particulièrement exposées

Les outils de marketing automation sont, par nature, des plateformes d'envoi en volume. C'est précisément ce qui les rend vulnérables :

• Les campagnes broadcast touchent des bases larges, parfois mal segmentées.
• Le canal WhatsApp est perçu par les utilisateurs comme personnel : un message non sollicité génère plus de blocages qu'un email.
• Les clients moins expérimentés ont tendance à importer des bases sans double opt-in, augmentant mécaniquement le taux de plainte.

Conséquence pour votre plateforme : si un client dégrade son quality rating, cela n'affecte que son numéro (le score est par numéro, pas par plateforme). Mais si votre plateforme ne surveille pas et n'alerte pas, vous découvrez le problème quand le client ouvre un ticket de support en urgence.

Ce que votre plateforme doit exposer nativement :

• Le quality rating en temps réel pour chaque numéro du tenant.
• Une alerte automatique dès le passage en jaune.
• Un blocage optionnel des campagnes quand le score est rouge (avec validation manuelle pour forcer l'envoi).

Ces données sont accessibles via l'API Graph de Meta (/phone_number_id/health_status) et doivent être rafraîchies toutes les heures minimum.

Pratiques à implémenter pour maintenir un score élevé

Le quality rating n'est pas une fatalité. Les plateformes qui intègrent les bonnes pratiques dans leur UX protègent leurs clients :

Sur la gestion des listes :

• Forcer la collecte d'un opt-in explicite avant tout envoi (case à cocher, formulaire double opt-in).
• Proposer un champ "source de la liste" lors de l'import pour responsabiliser le client.
• Bloquer l'envoi vers des numéros qui ont déjà bloqué l'expéditeur (la liste noire doit être maintenue par numéro source).

Sur la fréquence et le contenu :

• Intégrer un gestionnaire de pression marketing : limiter le nombre de messages envoyés à un même contact sur 7 jours.
• Proposer des prévisualisations de template réalistes avant envoi.
• Signaler dans l'interface quand un template a un historique de faible engagement.

Sur le traitement des événements webhook :

• Écouter l'événement message_status avec statut read pour mesurer l'engagement.
• Détecter les erreurs 131026 (message non délivré, numéro bloqué) et exclure automatiquement ces contacts.

Pour approfondir la question des templates et leur impact sur le quality rating, lisez notre guide sur les templates WhatsApp par catégorie.

Intégrer le quality rating dans le reporting de votre plateforme

Le quality rating doit être visible, pas enterré dans un sous-menu. Voici comment structurer son exposition :

• Dashboard principal : badge coloré (vert/jaune/rouge) par numéro actif.
• Historique de score : graphe sur 30 jours pour identifier les corrélations entre campagnes et dégradations.
• Rapport de campagne : taux de blocage estimé (nombre d'erreurs 131026 / messages envoyés).
• Alertes configurables : email ou webhook sortant quand le score change d'état.

Ce niveau de visibilité transforme le quality rating d'une contrainte subie en levier de qualité de données. Vos clients les plus exigeants vous en remercieront.

Whakup expose ces métriques via son API REST et ses webhooks, avec rafraîchissement en temps réel. Consultez notre API WhatsApp Business pour éditeurs pour voir comment intégrer ces données dans votre interface. Retrouvez aussi notre guide complet sur le meilleur BSP WhatsApp en France et notre analyse des prix de l'API WhatsApp Business en 2026.

FAQ

Le quality rating d'un client peut-il affecter d'autres clients sur la même plateforme ?

Non. Le quality rating est attaché au numéro de téléphone WhatsApp, pas à la plateforme ou au BSP. Un client avec un score rouge n'impacte pas les autres numéros hébergés sur la même infrastructure. Chaque WABA est isolé.

Est-il possible de "réinitialiser" un quality rating faible ?

Non, il n'existe pas de réinitialisation manuelle. Le score remonte naturellement si les envois suivants génèrent peu de blocages et si le volume d'envoi est réduit temporairement. Meta recommande d'attendre 7 jours sans envois agressifs pour observer une remontée.

À quelle fréquence faut-il interroger l'API pour récupérer le quality rating ?

Meta met à jour le score toutes les 24 heures environ, mais les changements d'état (passage en rouge) peuvent survenir plus rapidement lors d'une campagne en cours. Une interrogation toutes les heures est un bon compromis. Pour les plateformes à fort volume, brancher les webhooks Meta sur les événements account_update permet une détection quasi temps réel.

Quels sont les codes d'erreur liés au quality rating à surveiller dans les webhooks ?

Les codes les plus critiques : 131026 (message non délivré car bloqué par le destinataire), 131047 (limite de messagerie atteinte suite à dégradation du score), 131048 (envoi suspendu pour spam détecté). Ces codes doivent déclencher des alertes dans votre système de monitoring.

---

Le quality rating est l'un des signaux les plus importants pour la délivrabilité WhatsApp. En l'intégrant dans votre plateforme de marketing automation, vous passez d'un outil d'envoi à un outil de qualité. Whakup fournit les métriques, les webhooks et l'infrastructure pour que vous puissiez construire cette couche sans effort. Parlez à notre équipe.