API WhatsApp et le quality rating : guide pour les plateformes emailing

Le quality rating WhatsApp est une note attribuée par Meta à chaque numéro de téléphone enregistré sur l'API WhatsApp Business. Elle reflète la qualité des interactions entre l'expéditeur et ses destinataires sur les 7 derniers jours glissants. Pour une plateforme emailing qui gère des dizaines ou centaines de numéros clients, comprendre et piloter ce score est aussi critique que le taux de désinscription en email.

Comment Meta calcule le quality rating

Meta ne publie pas la formule exacte, mais les signaux négatifs connus sont :

• Les signalements « spam » par les destinataires (bouton "Signaler" dans WhatsApp).
• Les blocages : un utilisateur bloque le numéro expéditeur.
• Les réponses négatives aux messages de template (ex. : tap sur "Arrêter les promotions").

Les signaux positifs incluent les taux de réponse élevés et les interactions positives (clics sur CTA, réponses texte). Meta agrège ces signaux sur 7 jours et attribue une note :

Note	Couleur Meta	Signification opérationnelle
High	Vert	Statut nominal, envois illimités dans les tiers
Medium	Jaune	Signal d'alerte, surveiller
Low	Rouge	Risque de restriction ou de suspension

La note est consultable dans le Meta Business Manager sous "Phone Numbers" ou via l'API Graph (GET /{phone-number-id}, champ quality_rating).

Conséquences d'un mauvais quality rating sur les envois

Un quality rating dégradé a deux effets directs :

1. Baisse du messaging tier. WhatsApp limite le volume d'envois initiés (messages template) par paliers : 1 000, 10 000, 100 000 messages par jour. Si le quality rating reste en rouge trop longtemps, le tier peut être rétrogradé, ce qui plafonne les campagnes de vos clients.

2. Suspension du numéro. Dans les cas extrêmes, Meta peut suspendre le numéro. La réactivation est possible mais prend du temps et nécessite une action de votre équipe support.

Pour une plateforme emailing habituée à gérer des taux de rebond et des désabonnements, la logique est similaire : les signaux négatifs s'accumulent et dégradent la délivrabilité. La différence avec l'email, c'est que WhatsApp agit au niveau du numéro, pas du domaine.

Bonnes pratiques pour maintenir un bon quality rating

La gestion du quality rating commence avant l'envoi :

• Opt-in explicite obligatoire. Ne jamais envoyer à des contacts qui n'ont pas explicitement accepté de recevoir des messages WhatsApp de cette marque. Un contact importé d'une liste email n'est pas un opt-in WhatsApp valide.
• Fréquence maîtrisée. Éviter les envois quotidiens ou les rafales sur des bases entières. La règle d'or : envoyer moins, mais plus pertinent.
• Templates ciblés. Utiliser les variables de personnalisation pour rendre chaque message pertinent. Un message générique sur une large base génère plus de signalements qu'un message contextualisé.
• Gestion des opt-outs. Traiter les demandes de désinscription en temps réel. Si un contact répond "STOP" ou "Arrêter", le retirer immédiatement de la liste active. Ne pas attendre le prochain import.
• Monitoring continu. Intégrer le champ quality_rating dans votre tableau de bord plateforme. Alerter le client dès le passage en jaune, pas seulement en rouge.

Intégrer le quality rating dans votre plateforme emailing

Votre plateforme doit exposer le quality rating de manière proactive :

• Dashboard par numéro : afficher la note courante avec code couleur, l'historique sur 30 jours et les alertes configurables.
• Blocage préventif : si le rating passe en rouge, bloquer les nouveaux envois ou les limiter aux messages utility/auth (moins risqués que le marketing) jusqu'à résolution.
• Recommandations automatisées : si le rating baisse, suggérer des actions correctives dans l'interface (réduire la fréquence, vérifier l'opt-in, nettoyer la liste).
• Webhook phone_number_quality_update : Meta envoie un événement webhook lorsque le quality rating change. Abonnez-vous à cet événement pour déclencher des alertes temps réel.

Pour aller plus loin sur la structure des webhooks, consultez notre article sur la configuration des webhooks WhatsApp API.

FAQ

Le quality rating impacte-t-il les messages entrants (réponses des clients) ?

Non. Le quality rating ne s'applique qu'aux messages initiés par l'entreprise (outbound). Les conversations entrantes et les réponses aux messages ne dégradent pas le score.

Peut-on contester un quality rating bas auprès de Meta ?

Meta ne propose pas de mécanisme de contestation directe du quality rating. La seule façon d'améliorer le score est de cesser les pratiques qui génèrent des signalements et d'attendre que la fenêtre glissante de 7 jours "efface" les signaux négatifs. C'est une raison supplémentaire pour traiter les alertes jaune immédiatement.

Un même expéditeur peut-il avoir des quality ratings différents selon les numéros ?

Oui. Le quality rating est attaché au phone_number_id, pas au WABA ou à l'entreprise. Une même entreprise avec deux numéros (ex. : un pour le marketing, un pour le support) aura deux notes indépendantes. C'est un argument pour séparer les usages sur des numéros distincts.

Comment les plateformes emailing doivent-elles communiquer ce risque à leurs clients ?

De façon préventive, lors de l'onboarding. Expliquer que WhatsApp n'est pas un canal de blast comme l'email, et que la qualité des listes et l'opt-in sont déterminants. Proposer des guides ou des checklists d'hygiène de liste directement dans l'interface.

---

Le quality rating WhatsApp est un indicateur de délivrabilité que toute plateforme emailing doit exposer et piloter pour ses clients. Whakup met à disposition les webhooks, les endpoints API et le support technique nécessaires pour construire ce monitoring. Découvrez l'ensemble de l'offre sur notre page API WhatsApp Business et consultez notre guide sur les tarifs API WhatsApp pour comprendre l'impact financier d'une bonne délivrabilité.