API WhatsApp et le quality rating : guide pour les intégrateurs

Le quality rating WhatsApp est un indicateur calculé par Meta au niveau de 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 au cours des 7 derniers jours glissants, en se basant principalement sur les signalements et blocages des destinataires. Pour un intégrateur gérant plusieurs clients, ce score est un levier opérationnel critique : un quality rating dégradé déclenche automatiquement une réduction des rate limits, et dans les cas graves, une suspension du numéro.

Comment Meta calcule le quality rating

Meta ne publie pas sa formule exacte, mais les facteurs déterminants sont documentés :

Signaux négatifs pris en compte :

• Taux de signalement "Spam" par les destinataires (bouton "Signaler" dans WhatsApp).
• Taux de blocage du numéro par les destinataires.
• Taux de désabonnement explicite ("Stop" ou équivalent).
• Ratio de messages non lus sur les messages marketing envoyés (signal indirect).

Signaux positifs :

• Taux de réponse aux messages initiés par l'entreprise.
• Engagement global avec les templates (ouverture, clic sur CTA).
• Ancienneté du numéro et historique propre.

Le score est affiché dans le Meta Business Manager avec trois niveaux :

Niveau	Couleur	Impact
High	Vert	Rate limits maximaux, numéro stable
Medium	Jaune	Alerte, surveillance renforcée
Low	Rouge	Rate limits réduits, risque de suspension

Quand le score passe en "Low" pendant une période prolongée, Meta peut suspendre le numéro. La suspension est récupérable, mais elle interrompt tous les envois — y compris les messages utility et authentication de vos clients.

Impact direct sur les rate limits

Le quality rating est directement couplé au tier de messaging (niveau de débit) du numéro. Un numéro commence en Tier 1 (250 conversations uniques par 24h) et monte automatiquement en Tier 2 (1 000), Tier 3 (10 000) puis Tier 4 (100 000) à mesure qu'il envoie des volumes croissants avec un bon quality rating.

La relation est asymétrique :

• La montée en tier est progressive et automatique (quelques jours d'envois soutenus avec bon score).
• La descente est immédiate quand le quality rating passe en "Low".

Pour un intégrateur, cela signifie qu'un client dont le numéro vient d'atteindre Tier 3 peut se retrouver bloqué à Tier 1 en 24h si sa dernière campagne marketing a généré trop de signalements. Prévoyez ce scénario dans votre architecture : les appels API en erreur 131026 (rate limit dépassé) doivent déclencher une vérification du quality rating, pas seulement une logique de retry.

Consultez notre guide sur les rate limits WhatsApp pour les intégrateurs pour comprendre comment dimensionner vos files d'attente en fonction du tier actuel.

Bonnes pratiques pour maintenir un score élevé

En tant qu'intégrateur, vous êtes responsable de la qualité des envois de vos clients. Ces pratiques doivent faire partie de votre offre de service.

Sur la segmentation et le ciblage :

• N'envoyez des messages marketing qu'aux contacts ayant donné un opt-in explicite et récent (moins de 6 mois idéalement).
• Supprimez automatiquement les contacts qui ont bloqué ou signalé le numéro (récupéré via webhooks).
• Évitez les envois massifs vers des listes froides ou achetées.

Sur le contenu des templates :

• Les templates marketing doivent apporter une valeur réelle : offre exclusive, information pertinente, pas de répétition.
• Respectez la fréquence d'envoi : un contact qui reçoit 3 messages promotionnels par semaine est susceptible de bloquer le numéro.
• Personnalisez au maximum (prénom, historique d'achat) pour augmenter la pertinence perçue.

Sur le monitoring :

• Abonnez-vous au webhook message_status pour surveiller les taux de livraison et d'échec.
• Mettez en place une alerte automatique quand le quality rating passe en "Medium" — n'attendez pas le "Low".
• Exposez le quality rating dans le tableau de bord de votre plateforme pour que vos clients puissent agir.

Pour une vision complète de la structure de tarification liée aux catégories de messages, le guide tarifs API WhatsApp Business 2026 détaille les coûts par type de conversation.

Gestion des incidents quality rating pour vos clients

Quand un client passe en "Low", voici le protocole recommandé :

1. Arrêt immédiat des campagnes marketing : ne pas envoyer de nouveaux messages proactifs tant que le score ne remonte pas.
2. Analyse de la dernière campagne : identifier quel segment a généré les signalements (via les statistiques de livraison).
3. Nettoyage de la liste : retirer les contacts inactifs (non-ouverture sur les 3 derniers envois).
4. Reprise progressive : commencer par des messages utility ou authentication pour "réchauffer" le numéro.
5. Surveillance renforcée pendant 7 jours : le quality rating est calculé sur une fenêtre glissante.

Si le numéro est suspendu, la procédure de réactivation passe par une demande de révision dans le Business Manager. Meta examine le cas sous 24-48h. Pendant ce délai, prévoyez un numéro de secours si le client a des flux critiques (authentification, notifications transactionnelles).

L'API WhatsApp Business de Whakup inclut un dashboard de monitoring du quality rating par numéro, avec alertes configurables, pour que vous n'ayez pas à surveiller manuellement chaque compte client.

FAQ

Le quality rating d'un client peut-il affecter les autres clients sur ma plateforme ?

Non. Le quality rating est calculé au niveau du numéro de téléphone, pas au niveau de votre application Meta ou de votre WABA. Si chaque client dispose de son propre numéro (ce qui est la bonne pratique), un score dégradé n'a aucun impact sur les autres clients de votre plateforme.

Est-il possible de contester un signalement "Spam" auprès de Meta ?

Pas individuellement. Meta agrège les signalements de manière anonyme et ne fournit pas de détail par message. En revanche, si vous estimez que le score est anormal, vous pouvez contacter le support Meta Business via le Business Manager pour signaler une anomalie — sans garantie de résultat.

Les messages utility et authentication dégradent-ils aussi le quality rating ?

Beaucoup moins. Les signalements de spam concernent quasi-exclusivement les messages marketing (templates de catégorie Marketing). Les messages utility (confirmations, mises à jour de commande) et authentication (OTP) génèrent très peu de signalements car les destinataires les attendent. Maintenir un bon ratio utility/marketing dans vos envois protège naturellement le score.

À quelle fréquence le quality rating est-il mis à jour ?

Meta met à jour le quality rating en quasi-temps réel, mais l'affichage dans le Business Manager peut avoir un décalage de quelques heures. Le webhook phone_number_quality_update vous notifie dès qu'un changement de statut est détecté — c'est ce webhook qu'il faut exploiter pour vos alertes automatiques.

---

Maintenir un quality rating élevé pour tous vos clients est l'une des responsabilités les moins visibles mais les plus critiques d'un intégrateur WhatsApp sérieux. Whakup met à disposition de ses partenaires des outils de monitoring et des guides opérationnels pour gérer ce risque à l'échelle. Découvrez notre offre API WhatsApp pour intégrateurs et les outils inclus dans le partenariat.