Aller au contenu principal
Technique WhatsApp API 6 min de lecture

API WhatsApp et le quality rating : guide pour les CRM

Comprenez le quality rating WhatsApp et protégez vos clients CRM : comment il fonctionne, ce qui le dégrade et comment le maintenir au vert en production.

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é perçue des messages envoyés par ce numéro, mesurée à travers les signalements et les blocages de la part des destinataires. Pour les éditeurs de CRM qui gèrent les envois de dizaines de clients en multi-tenant, comprendre et surveiller ce score est une responsabilité opérationnelle directe : un quality rating dégradé limite les volumes d'envoi, puis bloque le numéro.

Comment Meta calcule le quality rating

Meta évalue le quality rating sur une fenêtre glissante de 7 jours. Le calcul combine principalement :

  • Le taux de signalement : nombre de fois où des destinataires ont bloqué le numéro ou signalé un message comme spam
  • Le taux de lecture et d'engagement (signal indirect) : un faible taux de lecture sur des messages marketing peut indiquer une audience mal ciblée
  • La vélocité d'envoi : des pics soudains de volume non justifiés alertent les algorithmes Meta

Le rating est affiché dans le Business Manager et accessible via l'API Graph sur l'endpoint /{phone-number-id} dans le champ quality_rating. Les valeurs possibles sont GREEN, YELLOW et RED.

Niveau Signification Conséquence immédiate
GREEN Qualité satisfaisante Aucune restriction
YELLOW Qualité dégradée Avertissement, risque de passage en RED sous 7 jours
RED Qualité insuffisante Tier de messaging abaissé ou numéro suspendu

Ce qui dégrade le quality rating en contexte CRM

En CRM, plusieurs pratiques récurrentes font chuter le quality rating sans que l'éditeur s'en rende compte immédiatement :

Segmentation trop large. Un client CRM qui envoie une campagne marketing à toute sa base de contacts — y compris des contacts inactifs depuis 12 mois — génère mécaniquement un fort taux de blocage. L'API WhatsApp n'est pas un canal de masse indifférencié.

Templates mal formulés. Un template approuvé par Meta peut quand même générer des signalements si son contenu est perçu comme intrusif une fois reçu. L'approbation Meta porte sur la conformité formelle, pas sur la pertinence marketing.

Absence d'opt-out clairement affiché. Les destinataires qui ne trouvent pas comment se désabonner utilisent le bouton "Bloquer" à la place. Chaque blocage pèse sur le quality rating.

Fréquence d'envoi non maîtrisée. Plusieurs messages marketing dans une même journée au même contact déclenchent des signalements, même si le contenu est pertinent.

Contacts non opt-in. L'utilisation de listes de contacts qui n'ont pas explicitement consenti à recevoir des messages WhatsApp est la cause la plus fréquente de dégradation rapide du quality rating.

Comment monitorer et protéger le quality rating depuis votre CRM

Surveillance via l'API et les webhooks

Meta envoie un webhook phone_number_quality_update dès qu'un changement de quality rating survient. Votre CRM doit :

  1. Écouter cet événement sur chaque tenant
  2. Alerter immédiatement le client concerné via l'interface
  3. Suspendre automatiquement les campagnes marketing en cours si le rating passe en RED

Via l'API Graph, vous pouvez interroger le quality rating en temps réel :

GET /{phone-number-id}?fields=quality_rating,status

Règles de bonne hygiène à exposer dans votre UI CRM

Exposez des guardrails directement dans l'interface d'envoi de vos clients :

  • Bloquer l'envoi vers des contacts inactifs depuis plus de 90 jours
  • Forcer un délai minimum de 24 heures entre deux messages marketing au même contact
  • Afficher le quality rating courant sur le tableau de bord, avec un code couleur
  • Proposer une vérification de liste avant chaque campagne (doublons, opt-out déjà enregistrés)

Réagir à une dégradation

Si un numéro client passe en YELLOW ou RED :

  • Suspendez les campagnes marketing immédiatement
  • Analysez les 48 dernières heures d'envoi pour identifier le template ou la liste en cause
  • Attendez que le rating remonte avant de reprendre (Meta réévalue toutes les 24 heures)
  • Ne tentez pas de contourner en changeant de numéro : Meta trace les patterns par WABA, pas seulement par numéro

Obligations de l'éditeur CRM vis-à-vis de ses clients

En tant qu'éditeur de CRM intégrant l'API WhatsApp via un Meta Tech Provider, vous avez une responsabilité partagée sur le quality rating de vos clients :

  • Documentation claire sur les règles d'usage acceptables (AUP WhatsApp)
  • Alertes automatiques dès qu'un quality rating se dégrade
  • Mécanismes de protection pour éviter les envois abusifs involontaires
  • Processus de réintégration documenté pour les numéros suspendus

Meta peut suspendre un WABA entier si plusieurs numéros sur le même compte affichent des quality ratings RED simultanément. En multi-tenant, cela peut impacter tous vos clients hébergés sous le même WABA partagé — un argument fort pour l'architecture WABA-par-client.

FAQ

Un quality rating GREEN garantit-il qu'aucun message ne sera bloqué ?

Non. Le quality rating mesure l'historique récent, pas l'avenir. Un envoi mal ciblé peut faire chuter un rating GREEN en YELLOW en quelques heures si le taux de signalement dépasse le seuil Meta sur la fenêtre de 7 jours. La surveillance continue est indispensable.

Le quality rating affecte-t-il les messages de type utility ou authentication ?

Les messages utility et authentication (OTP, confirmations de commande, alertes transactionnelles) sont beaucoup moins exposés à la dégradation du quality rating que les messages marketing. Les destinataires les signalent rarement, car ils les ont explicitement sollicités. Cela dit, un numéro en RED sera restreint pour tous les types de messages.

Peut-on récupérer un numéro suspendu suite à un quality rating RED ?

Oui, Meta prévoit un processus d'appel via le Business Manager. Il faut démontrer que les pratiques d'envoi ont été corrigées. La suspension est généralement temporaire (24 à 72 heures) pour un premier incident. Une récidive peut conduire à une suspension permanente du numéro.

Comment isoler les quality ratings en architecture multi-tenant ?

La meilleure pratique est d'attribuer un WABA distinct et un numéro dédié à chaque client final. Ainsi, la dégradation du quality rating d'un client n'affecte pas les autres. Si vous utilisez un WABA mutualisé avec plusieurs numéros, les numéros sont bien isolés entre eux en termes de quality rating — mais le WABA global peut être impacté si plusieurs numéros posent problème simultanément.


Le quality rating n'est pas un détail technique : c'est un indicateur de santé de la relation que vos clients entretiennent avec leurs contacts WhatsApp. L'intégrer comme une métrique de premier plan dans votre CRM protège vos clients et votre réputation en tant qu'éditeur.

Whakup fournit aux éditeurs de CRM une API WhatsApp Business avec monitoring du quality rating intégré, webhooks en temps réel et architecture multi-tenant isolée. Pour aller plus loin, consultez notre guide sur les templates WhatsApp et leurs catégories et notre article sur le statut de Meta Tech Provider.

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