Aller au contenu principal
Technique WhatsApp API 5 min de lecture

API WhatsApp et le quality rating : guide pour les agences de communication

Le quality rating WhatsApp mesure la qualité d'envoi de votre numéro. Pour une agence de communication, le comprendre et le protéger conditionne la délivrabilité de tous ses clients.

Le quality rating WhatsApp est un score attribué par Meta à chaque numéro connecté à l'API WhatsApp Business. Il reflète la façon dont les destinataires réagissent à vos messages : signalements comme spam, blocages, taux de lecture faible. Un score dégradé réduit vos limites d'envoi. Un score en rouge peut entraîner la suspension du numéro. Pour une agence de communication qui gère plusieurs comptes annonceurs, surveiller ce score n'est pas optionnel.

Les trois niveaux du quality rating et leurs effets

Meta affiche le quality rating dans le Meta Business Manager, sous trois états :

Score Couleur Effet sur les envois
Élevé Vert Aucune restriction, montée en charge possible
Moyen Jaune Limite d'envoi gelée, pas d'augmentation possible
Faible Rouge Limite d'envoi réduite au palier inférieur

Le score est calculé sur une fenêtre glissante des 7 derniers jours. Il tient compte principalement des signalements spam et des blocages de la part des destinataires. Un seul envoi massif mal ciblé peut faire basculer un numéro du vert au rouge en quelques heures.

Si le score reste en rouge au-delà d'un certain seuil, Meta peut restreindre le numéro en mode FLAGGED : vous pouvez encore envoyer, mais vous ne pouvez plus augmenter votre tier de messagerie. Si le score ne remonte pas sous 7 jours, Meta peut passer le numéro en RESTRICTED — seules les conversations initiées par les utilisateurs (réponses entrantes) restent possibles.

Ce qui dégrade le quality rating

Les causes les plus fréquentes dans un contexte agence :

  • Templates marketing trop génériques : envoyer la même promotion à toute une base sans segmentation génère des signalements.
  • Fréquence d'envoi excessive : solliciter le même numéro plusieurs fois par semaine augmente les blocages.
  • Opt-in mal collecté : des destinataires qui ne se souviennent pas avoir consenti bloquent dès le premier message.
  • Absence de bouton de désabonnement : les utilisateurs qui ne peuvent pas se désinscrire facilement appuient sur "Signaler comme spam".
  • Contenu en décalage avec les attentes : un destinataire inscrit pour des alertes de livraison qui reçoit une promo commerciale non sollicitée.

Pour les agences qui mutualisent un même numéro entre plusieurs campagnes ou plusieurs clients, le risque de contamination est réel : une campagne mal optimisée plombe le score du numéro partagé et impacte toutes les autres campagnes.

Comment protéger et améliorer le score de qualité

Segmentez avant d'envoyer. N'envoyez pas à toute la base en une seule fois. Commencez par les segments les plus engagés, observez le score, puis élargissez progressivement.

Nettoyez votre liste régulièrement. Supprimez les numéros qui n'ont pas ouvert ou répondu depuis 90 jours. Une base fraîche et qualifiée vaut mieux qu'une base volumineuse et inerte.

Ajoutez systématiquement un CTA de désabonnement. Meta le recommande explicitement. Un "Répondre STOP pour se désabonner" réduit les signalements et vous met en conformité RGPD en un coup.

Espacez les campagnes. Pour un même destinataire, respectez au minimum 72h entre deux messages marketing. Meta impose de ne pas envoyer plus d'un message marketing par jour et par utilisateur.

Testez vos templates avant un envoi massif. Envoyez à un échantillon de 500 à 1 000 contacts, surveillez le score pendant 24h, puis décidez du déploiement total.

Consultez aussi notre article sur les limites de messagerie et tiers de débit WhatsApp pour comprendre comment le quality rating interagit avec les paliers d'envoi.

Architecture multi-numéros pour isoler les risques

La meilleure protection pour une agence qui gère plusieurs clients est d'attribuer un numéro dédié par annonceur. Ainsi, une campagne dégradée chez le client A n'impacte pas le client B. C'est l'architecture recommandée par Meta et celle que Whakup facilite avec son approche multi-tenant et multi-numéros.

Si vous devez partager un numéro entre plusieurs campagnes pour un même annonceur, segmentez strictement les templates et les audiences. Ne mélangez jamais des campagnes de nature différente (transactionnel vs marketing) sur le même template ou la même liste.

Pour aller plus loin sur la sélection et la gestion des numéros, notre guide choisir le meilleur BSP WhatsApp en France compare les approches des principaux fournisseurs.

FAQ

Le quality rating est-il visible en temps réel dans l'API ?

Oui. Meta expose un endpoint GET /{phone-number-id} qui retourne le champ quality_rating avec les valeurs GREEN, YELLOW ou RED. Vous pouvez automatiser une alerte dans votre plateforme dès que le score descend sous GREEN.

Un numéro en rouge peut-il revenir en vert ?

Oui. Le score est calculé sur une fenêtre de 7 jours. Si vous suspendez les envois ou améliorez significativement vos pratiques, le score peut remonter naturellement. En revanche, un numéro suspendu par Meta nécessite une action manuelle de réactivation.

Le quality rating affecte-t-il les messages transactionnels (utility) ?

Le score est global pour le numéro, mais Meta tient compte de la nature des messages. Les messages transactionnels (confirmations de commande, alertes de livraison) génèrent très peu de signalements. Si votre numéro envoie à la fois du transactionnel et du marketing, c'est le marketing qui dégrade le score. Séparez les numéros si le volume le justifie.

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

Meta envoie des notifications dans le Meta Business Manager et peut envoyer des webhooks de type phone_number_quality_update. Configurez ces webhooks dans votre infrastructure pour réagir automatiquement, sans attendre qu'un collaborateur détecte la dégradation manuellement.


Le quality rating n'est pas un détail technique : c'est l'indicateur de santé de votre activité WhatsApp. Une agence qui ne le surveille pas expose ses clients à des restrictions d'envoi sans préavis. Whakup intègre le monitoring du score directement dans son API et vous remonte les alertes via webhooks. Accédez à l'API WhatsApp Whakup et construisez une infrastructure d'envoi fiable pour tous vos annonceurs.

#technique api whatsapp#quality rating whatsapp#agence communication
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