Aller au contenu principal
Technique WhatsApp API 6 min de lecture

API WhatsApp et le quality rating : guide pour les SaaS e-commerce

Quality rating WhatsApp pour les SaaS e-commerce : comprendre le score qualité Meta, ses impacts sur l'envoi de messages et comment le piloter depuis votre plateforme.

Le quality rating WhatsApp est le score qu'attribue Meta à chaque numéro de téléphone actif sur l'API WhatsApp Business. Il reflète la satisfaction des destinataires : si vos clients e-commerce bloquent vos messages ou les signalent comme spam, ce score chute. Et quand il chute suffisamment, Meta réduit automatiquement votre volume d'envoi jusqu'à suspendre le numéro. Pour un SaaS e-commerce qui envoie des confirmations de commande ou des relances panier, c'est un risque opérationnel direct.

Comment fonctionne le quality rating

Meta calcule ce score en temps réel à partir des signaux collectés auprès des destinataires WhatsApp. Il est visible dans le Meta Business Manager sous trois états :

  • Vert (High) : les destinataires engagent positivement, peu de blocages
  • Jaune (Medium) : signaux négatifs en hausse, surveillance accrue
  • Rouge (Low) : trop de blocages ou signalements, restrictions imminentes

Le score est propre à chaque numéro de téléphone WhatsApp Business. Dans un SaaS e-commerce multi-marchands, chaque client a son propre numéro et donc son propre quality rating. La bonne pratique est d'isoler chaque marchand sur son WABA dédié pour que la mauvaise hygiène d'envoi de l'un ne contamine pas les autres.

Niveau Couleur Conséquence immédiate
High Vert Aucune restriction
Medium Jaune Avertissement, surveillance
Low Rouge Tier de messagerie abaissé
Suspendu - Envoi bloqué, appel en cours

Le quality rating est lié aux messaging tiers : Meta plafonne le volume journalier d'un numéro selon son niveau (1K, 10K, 100K conversations par jour). Une dégradation du score peut faire rétrograder un numéro du tier 100K au tier 1K, ce qui bloque les campagnes en cours.

Ce qui dégrade le score qualité

Les comportements qui font baisser le quality rating sont documentés par Meta et prévisibles.

Les messages non sollicités. Envoyer un message WhatsApp à un contact qui n'a pas explicitement opté pour ce canal est la cause principale de dégradation. Un opt-in email ne vaut pas un opt-in WhatsApp. Votre plateforme doit gérer ces consentements de manière distincte.

Les templates mal ciblés. Un template de relance panier envoyé 72 h après l'abandon génère moins d'irritation qu'un template envoyé 5 minutes après une commande finalisée. Le timing et la pertinence du contenu influent directement sur le taux de blocage.

La fréquence excessive. Un même destinataire qui reçoit trois messages marketing dans la même semaine est plus enclin à bloquer l'expéditeur. Votre SaaS doit exposer des règles de pression commerciale que le marchand configure.

Les templates non conformes. Meta peut rejeter ou désactiver un template après approbation si des destinataires le signalent massivement. Un template désactivé cesse d'être envoyé, mais les tentatives d'envoi continuent à dégrader le score.

Pour comprendre comment les templates sont catégorisés par Meta, consultez notre guide sur les catégories de templates WhatsApp.

Comment monitorer et protéger le score depuis votre SaaS

Un éditeur de SaaS e-commerce responsable expose à ses marchands des indicateurs de qualité en temps réel. Voici ce que votre tableau de bord doit remonter.

Via l'API WhatsApp Cloud :

  • L'endpoint GET /phone_number_id retourne le champ quality_rating : GREEN, YELLOW ou RED
  • Le champ messaging_limit_tier indique le plafond journalier actuel
  • Les webhooks de type phone_number_quality_update envoient un événement dès que le score change

Actions correctives à automatiser dans votre plateforme :

  • Alerte email/Slack au marchand dès passage en jaune
  • Suspension automatique des campagnes marketing si le score passe en rouge
  • Conservation des messages utilitaires (confirmations, tracking) même en score dégradé
  • Rapport hebdomadaire sur le taux de blocage par template

Découvrez comment structurer votre intégration API en lisant notre guide complet de l'API WhatsApp Business.

Récupérer un score dégradé

Si le quality rating d'un marchand tombe en rouge, la marche à suivre est précise.

  1. Stopper immédiatement les envois marketing. Ne pas continuer à envoyer pendant la dégradation aggrave la situation.
  2. Identifier les templates problématiques. Dans le Business Manager, les templates signalés sont visibles. Désactiver ceux qui accumulent les signalements.
  3. Nettoyer la liste de contacts. Supprimer les contacts qui n'ont pas interagi depuis plus de 90 jours réduit mécaniquement le risque futur.
  4. Attendre la fenêtre de réévaluation. Meta réévalue le score sur une fenêtre glissante. En l'absence de nouveaux signaux négatifs, le score remonte naturellement en quelques jours.
  5. Reprendre les envois progressivement. Commencer par les messages transactionnels (confirmations, livraisons) avant de relancer les campagnes marketing.

Pour les numéros suspendus, Meta propose un processus d'appel via le Business Manager. Ce processus prend entre 24 h et 72 h et n'est pas garanti. La prévention reste la seule vraie protection.

Si vous cherchez à comparer les options d'intégration disponibles, notre analyse API WhatsApp : construire ou acheter détaille les arbitrages pour les éditeurs SaaS.

FAQ

Le quality rating est-il partagé entre plusieurs numéros d'un même compte ?

Non. Chaque numéro de téléphone a son propre quality rating. C'est pourquoi il est important d'isoler chaque marchand de votre SaaS sur un numéro dédié : la dégradation de l'un n'impacte pas les autres.

Peut-on voir les raisons exactes pour lesquelles les destinataires bloquent nos messages ?

Non. Meta ne fournit pas d'informations individuelles sur les blocages pour des raisons de confidentialité. Vous voyez le score agrégé et les templates signalés, pas les identités des destinataires.

Un template approuvé peut-il être désactivé après coup ?

Oui. Meta surveille les templates en production. Si un template génère un volume anormal de signalements après activation, Meta peut le désactiver. Votre webhook message_template_status_update vous en informe avec le statut PAUSED ou DISABLED.

Quelle fréquence d'envoi est recommandée pour ne pas dégrader le score ?

Il n'y a pas de règle universelle. La clé est la pertinence : un message attendu et utile ne sera pas bloqué même s'il arrive souvent. Un message non sollicité sera bloqué même s'il est rare. Focalisez-vous sur la qualité du consentement et la pertinence du contenu, pas sur la fréquence brute.


Le quality rating est un indicateur que vos marchands e-commerce ne pilotent pas naturellement. C'est à votre SaaS de l'exposer et d'automatiser les actions de protection. Whakup fournit les webhooks temps réel et l'API REST pour que vous puissiez construire ces alertes et automatisations sans gérer vous-même l'infrastructure Meta. Contactez notre équipe pour voir comment intégrer le monitoring qualité dans votre plateforme.

#technique api whatsapp#quality rating whatsapp#saas e-commerce
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