Aller au contenu principal
Technique WhatsApp API 5 min de lecture

API WhatsApp et le quality rating : guide pour les agences push notifications

Comprendre et piloter le quality rating WhatsApp est crucial pour les agences push notifications : découvrez comment maintenir un score élevé et éviter les blocages.

Le quality rating WhatsApp est la note attribuée par Meta à chaque numéro d'expéditeur en fonction des retours des destinataires — signalements, blocages, taux de lecture. Pour une agence push notifications, ce score détermine directement votre capacité à envoyer des campagnes à volume. Un score dégradé entraîne des limitations progressives qui peuvent aller jusqu'à la suspension du numéro.

Comment Meta calcule le quality rating

Meta évalue la qualité de votre numéro sur une fenêtre glissante de 7 jours. Le score repose sur des signaux négatifs remontés par les destinataires :

  • Signalement comme spam (bouton "Signaler" dans WhatsApp)
  • Blocage du numéro par le destinataire
  • Taux de non-lecture sur les messages marketing (signal indirect)

Le score s'affiche dans le Meta WhatsApp Manager avec trois niveaux :

Couleur Signification Impact opérationnel
Vert Haute qualité Aucune restriction
Jaune Qualité moyenne Avertissement Meta, surveillance accrue
Rouge Basse qualité Limitation des envois, risque de suspension

Le passage en rouge déclenche une alerte Meta. Si la situation ne s'améliore pas, Meta abaisse votre tier d'envoi (Message Sending Limit), réduisant mécaniquement votre capacité journalière.

Les causes les plus fréquentes de dégradation du score

Pour les agences push notifications, les problèmes de quality rating ont presque toujours la même origine :

Opt-in insuffisant ou mal qualifié. Des contacts qui ne se souviennent pas avoir accepté de recevoir des messages WhatsApp de votre client vont signaler dès le premier envoi. Un opt-in explicite, récent et documenté est non négociable.

Fréquence d'envoi trop élevée. WhatsApp n'est pas l'email. Envoyer une campagne marketing chaque semaine à la même liste provoque de la fatigue et des signalements. Les agences qui transposent leurs pratiques email/SMS sans ajustement dégradent rapidement leur score.

Contenu peu pertinent ou générique. Un message non personnalisé, sans valeur perçue immédiate, génère plus de blocages qu'un message ciblé et contextualisé.

Heure d'envoi inadaptée. Des messages reçus tard le soir ou très tôt le matin, surtout pour des campagnes marketing, augmentent les signalements.

Listes non nettoyées. Des numéros inactifs ou inexistants génèrent des erreurs et des comportements imprévisibles.

Gérer le quality rating en contexte multi-clients

Une agence push notifications gère plusieurs clients, chacun avec son propre numéro WhatsApp et son propre WABA. Le quality rating est attaché au numéro, pas au WABA ou à l'agence. Cela signifie :

  • Un client avec des pratiques d'envoi médiocres ne dégrade pas le score des autres clients.
  • Vous devez surveiller le score de chaque numéro individuellement.
  • Mettre en place des alertes automatiques (via webhook Meta ou via l'API Graph) dès qu'un score passe en jaune est fortement recommandé.

Pour une surveillance proactive, l'API WhatsApp de Whakup expose les événements de changement de qualité via webhooks, ce qui permet de créer des alertes automatiques dans votre dashboard. Vous n'avez pas à aller vérifier manuellement dans la console Meta.

Les webhooks de changement d'état qualité sont documentés dans notre guide technique des webhooks WhatsApp.

Comment améliorer un score dégradé

Si un numéro passe en rouge, voici les actions prioritaires :

  1. Suspendre immédiatement les envois marketing sur ce numéro. Continuer à envoyer aggrave la situation.
  2. Auditer la liste : supprimer les contacts qui ont bloqué ou signalé, nettoyer les numéros invalides.
  3. Revoir le process d'opt-in du client : s'assurer que chaque contact a donné un consentement explicite et récent.
  4. Réduire la fréquence et augmenter la pertinence des messages avant de reprendre les envois.
  5. Attendre : le score se recalcule sur 7 jours. Avec zéro envoi pendant cette période, le compteur de signalements récents diminue mécaniquement.

Meta propose également un mécanisme d'appel (contestation) si vous estimez que le score est injustifié — par exemple suite à une campagne concurrente ou à un problème de spam par un tiers. Ce processus est manuel et sans garantie de résultat.

FAQ

Un quality rating rouge bloque-t-il immédiatement tous les envois ?

Non, pas immédiatement. Le passage en rouge déclenche d'abord un abaissement du tier d'envoi. Le Tier 1 autorise environ 1 000 conversations par 24h. Si la situation se dégrade encore, Meta peut suspendre le numéro. La suspension complète est rare et généralement précédée de plusieurs avertissements.

Le quality rating impacte-t-il les messages utility et authentication ?

Le score est calculé principalement sur les retours liés aux messages marketing. Les messages utility (confirmations de commande, alertes de livraison) et authentication (OTP) génèrent beaucoup moins de signalements car ils sont attendus par les destinataires. Cependant, un score global rouge peut affecter tous les types d'envois.

Peut-on avoir plusieurs numéros pour diluer les risques ?

Oui. C'est une stratégie utilisée par certaines agences : dédier un numéro aux envois marketing à forte fréquence et un autre aux messages transactionnels. Cela isole le risque. La gestion multi-numéros est supportée nativement par les BSP qui offrent une architecture multi-tenant.

Meta notifie-t-il automatiquement les dégradations de score ?

Meta envoie des emails aux administrateurs du WABA lors des changements de score significatifs. Mais pour une agence qui gère de nombreux clients, s'appuyer sur les emails Meta n'est pas scalable. La solution est de s'abonner aux webhooks de changement de qualité et de les centraliser dans votre propre système d'alerte.


Le quality rating est le baromètre de santé de votre infrastructure push WhatsApp. Ignorer ce score, c'est risquer une interruption de service pour vos clients. Mettez en place la surveillance dès le démarrage, pas après la première dégradation. Pour découvrir comment Whakup vous aide à monitorer vos numéros et à maintenir des scores élevés, consultez notre page API WhatsApp.

#technique api whatsapp#quality rating whatsapp#push notifications
Pablo Lenormand
Pablo LenormandCo-fondateur & CPO

Co-fondateur et Chief Product Officer de Whakup, Pablo conçoit les fonctionnalités qui permettent aux marques africaines de maximiser leur impact sur WhatsApp.

🚀

Prêt à passer à l'action ?

Essayez Whakup gratuitement pendant 15 jours. Aucune carte bancaire requise.

Démarrer l'essai gratuit