Aller au contenu principal
Technique WhatsApp API 5 min de lecture

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

Le quality rating WhatsApp conditionne vos limites d'envoi et la réputation de vos numéros. Comprendre ce score est essentiel pour les plateformes SMS multi-tenant.

Le quality rating WhatsApp est une note attribuée par Meta à chaque numéro de téléphone enregistré sur l'API WhatsApp Business. Il reflète la qualité des interactions entre ce numéro et ses destinataires au cours des 7 derniers jours glissants. Pour une plateforme SMS qui gère des dizaines de numéros clients, comprendre et surveiller ce score est une responsabilité opérationnelle centrale — pas une option.

Comment fonctionne le quality rating

Meta calcule le quality rating en analysant les signaux négatifs des utilisateurs finaux :

  • Blocages : l'utilisateur bloque le numéro expéditeur
  • Signalements spam : l'utilisateur signale le message comme indésirable
  • Opt-outs massifs : taux de désinscription anormalement élevé sur une courte période

Le score est exprimé en trois niveaux :

Niveau Label Meta Signification
Vert High Qualité élevée, aucune restriction
Jaune Medium Signal d'alerte, risque de dégradation
Rouge Low Qualité dégradée, restrictions actives ou imminentes

Un numéro qui passe en rouge déclenche automatiquement une baisse du messaging tier (limite quotidienne de contacts uniques). Si la note ne remonte pas, Meta peut suspendre le numéro.

L'impact direct sur les limites d'envoi (messaging tiers)

Les tiers d'envoi WhatsApp définissent combien de contacts uniques vous pouvez contacter par période de 24 heures :

  • Tier 1 : 1 000 contacts uniques/jour
  • Tier 2 : 10 000 contacts uniques/jour
  • Tier 3 : 100 000 contacts uniques/jour
  • Tier 4 (non officiel) : illimité pour les volumes très élevés

La montée en tier est conditionnée à deux critères : le volume de messages envoyés et le quality rating. Un numéro en rouge ne peut pas progresser vers un tier supérieur. Pire, un numéro en tier 3 qui descend en rouge peut être rétrogradé au tier 2.

Pour une plateforme SMS qui onboarde de nouveaux clients avec des attentes de volume importantes dès le lancement, cette mécanique impose une stratégie de montée en charge progressive — ce que Meta appelle le "warming up" des numéros.

Surveiller le quality rating en production : stratégie pour les plateformes multi-tenant

En mode multi-tenant, chaque client a son propre waba_id et son propre numéro. Surveiller le quality rating de l'ensemble du parc implique :

Webhooks account_update

Meta envoie des événements account_update avec le champ phone_number_quality_update lorsque la note change. Abonnez-vous à ce webhook pour détecter en temps réel les dégradations, sans polling.

Dashboard de supervision centralisée

Chaque plateforme mature implémente un tableau de bord interne qui agrège :

  • Le quality rating courant par numéro
  • L'évolution sur 7 jours
  • Les alertes automatiques quand un numéro passe en jaune

Seuils d'alerte proactifs

N'attendez pas le rouge. Quand un numéro passe en jaune, déclenchez une analyse des envois récents : quels templates ont été envoyés ? À quels segments ? Quel taux de blocage ? La plupart des dégradations sont évitables si on intervient au stade jaune.

Whakup expose ces métriques via son API, ce qui permet aux plateformes clientes de les intégrer directement dans leur propre reporting. Pour un aperçu des capacités techniques disponibles, consultez notre guide complet de l'API WhatsApp Business.

Bonnes pratiques pour maintenir un quality rating élevé

Les plateformes SMS les plus performantes partagent les mêmes pratiques :

Côté templates

  • N'envoyer que des messages avec une valeur réelle pour le destinataire
  • Personnaliser les variables dynamiques pour éviter l'effet "envoi de masse"
  • Limiter la pression marketing : un message non sollicité sur WhatsApp est bien plus mal perçu que sur email
  • Respecter les catégories Meta (marketing, utility, authentication) — un mauvais classement entraîne des coûts supplémentaires et des signalements

Côté segmentation

  • Travailler uniquement sur des listes opt-in explicites
  • Exclure les contacts inactifs depuis plus de 90 jours
  • Ne pas réenvoyer un message à un contact qui n'a pas répondu aux deux derniers envois

Côté timing

  • Éviter les envois entre 20h et 8h
  • Espacer les campagnes marketing d'au moins 5 jours sur les mêmes segments

Pour comprendre comment les catégories de templates influencent à la fois le quality rating et la tarification, consultez notre article sur les catégories de templates WhatsApp.

FAQ

Un quality rating dégradé se rétablit-il automatiquement ?

Oui, si les signaux négatifs cessent. Meta réévalue le score sur une fenêtre glissante de 7 jours. Un numéro qui passe en rouge peut remonter en vert en une semaine si les mauvaises pratiques sont corrigées. La suspension, elle, nécessite une action manuelle via Meta Business Support.

Est-ce que le quality rating s'applique par numéro ou par compte WhatsApp Business ?

Par numéro de téléphone. Un compte WhatsApp Business Account (WABA) peut avoir plusieurs numéros associés, chacun avec son propre quality rating indépendant.

Comment savoir si un message a déclenché des signalements spam ?

Meta ne communique pas les signalements individuels pour des raisons de confidentialité. En revanche, la dégradation du quality rating est le signal indirect. Les webhooks phone_number_quality_update permettent de corréler temporellement une baisse avec les envois récents.

Les messages de service (utility) impactent-ils le quality rating de la même façon que les messages marketing ?

Non. Les messages utility (confirmations de commande, notifications transactionnelles) génèrent en général beaucoup moins de blocages que les messages marketing. C'est une des raisons pour lesquelles il est recommandé de ne pas mélanger les usages sur un même numéro.


Le quality rating est le baromètre de santé de votre canal WhatsApp. Pour une plateforme SMS, le superviser au niveau du parc entier n'est pas une complexité optionnelle — c'est une condition pour tenir ses engagements SLA clients. Whakup, en tant que Meta Tech Provider certifié, vous fournit les outils de supervision et les bonnes pratiques pour protéger vos numéros. Explorez toutes les capacités disponibles sur notre page API WhatsApp Business.

#technique api whatsapp#quality rating whatsapp#plateforme sms
Arthur Lyonnet
Arthur LyonnetCo-fondateur & CEO

Co-fondateur de Whakup, Arthur accompagne les entreprises africaines dans leur transformation digitale via WhatsApp depuis 2022. Passionné par le growth marketing et l'entrepreneuriat en Afrique francophone.

🚀

Prêt à passer à l'action ?

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

Démarrer l'essai gratuit