API WhatsApp et le quality rating : guide pour les plateformes de fidélité

Le quality rating WhatsApp est un indicateur calculé par Meta à partir des signaux négatifs reçus sur un numéro : blocages, signalements comme spam, désabonnements. Pour une plateforme de fidélité qui envoie des messages marketing pour le compte de dizaines d'enseignes, ce score conditionne directement la capacité d'envoi. Un numéro dégradé peut voir ses limites de messagerie réduites ou être suspendu. Comprendre et piloter ce score fait partie des responsabilités techniques de l'éditeur de plateforme.

Comment Meta calcule le quality rating

Meta évalue chaque numéro de téléphone Business sur une fenêtre glissante de 7 jours. Trois niveaux de score existent :

Score	Couleur Meta	Conséquence
Élevé	Vert	Aucune restriction
Moyen	Jaune	Avertissement, surveillance renforcée
Faible	Rouge	Réduction des limites ou suspension possible

Les signaux qui dégradent le score :

• Blocages : l'utilisateur bloque le numéro après avoir reçu un message.
• Signalements spam : l'utilisateur signale le message comme indésirable.
• Désabonnements : réponses type "STOP" ou "Désabonner".

Les signaux positifs (lectures, réponses, interactions) ne font pas remonter le score directement, mais leur présence relative dilue l'impact des signaux négatifs.

Pour comprendre comment les templates influencent ces signaux, consultez notre guide sur les templates WhatsApp et leurs catégories.

Pourquoi ce sujet est particulièrement sensible en fidélité

Les plateformes de fidélité envoient des messages récurrents à des bases de contacts larges : rappels de points, offres personnalisées, alertes d'expiration de récompenses. Ce sont des cas d'usage à haute fréquence d'envoi, avec des bases qui peuvent comporter des contacts inactifs ou des numéros qui ont changé de mains.

Risques spécifiques à surveiller :

• Bases non nettoyées. Des numéros désactivés ou réattribués reçoivent des messages destinés à un autre contact. Le nouveau propriétaire du numéro bloque immédiatement.
• Fréquence trop élevée. Un client qui reçoit cinq messages promotionnels en une semaine est plus susceptible de bloquer le numéro.
• Manque de contextualisation. Si le message n'indique pas clairement de quelle enseigne il provient, le destinataire ne reconnaît pas l'expéditeur et signale en spam.

Pour un éditeur de plateforme multi-tenant, un seul marchand qui envoie des campagnes mal ciblées peut dégrader le quality rating de son numéro — et si l'architecture n'est pas bien isolée, cela peut avoir des effets de bord sur d'autres tenants.

Surveiller et réagir : ce que doit faire votre plateforme

Votre plateforme doit exposer aux marchands un tableau de bord du quality rating en temps réel. Meta transmet les changements de score via des webhooks d'événement phone_number_quality_update. Votre système doit :

1. Écouter ces webhooks et stocker l'historique du score par numéro.
2. Alerter le marchand dès le passage en jaune, avant que le score ne tombe en rouge.
3. Proposer des actions correctives : pause des campagnes, nettoyage de liste, révision de la fréquence.

Actions recommandées selon le niveau de score :

• Jaune : réduire la fréquence d'envoi de 30 à 50 %, analyser les templates avec le plus fort taux de blocage.
• Rouge : suspendre les campagnes marketing, ne conserver que les messages transactionnels (utility), soumettre une demande de révision à Meta si le numéro est suspendu.

Sur la différence entre messages marketing et utility, et leurs coûts respectifs, référez-vous à notre article sur le prix de l'API WhatsApp Business en 2026.

Bonnes pratiques pour maintenir un score élevé durablement

Le quality rating est une conséquence des pratiques d'envoi. Votre plateforme peut l'influencer en amont en guidant les marchands vers les bonnes pratiques.

Gestion des opt-ins :

• Ne jamais envoyer de message marketing sans opt-in explicite WhatsApp.
• Stocker la preuve de l'opt-in (date, source, texte exact du consentement).
• Proposer un mécanisme de désabonnement simple dans chaque message.

Qualité des templates :

• Chaque template doit indiquer clairement le nom de l'enseigne.
• Éviter les formulations trop commerciales dans les messages utility.
• Tester les templates sur un sous-ensemble avant un envoi de masse.

Hygiène des listes :

• Supprimer automatiquement les numéros qui ont répondu "STOP".
• Détecter les hard bounces (numéros inexistants) et les retirer.
• Appliquer une fenêtre d'inactivité : si un contact n'a pas interagi depuis 6 mois, le sortir des campagnes marketing.

Whakup expose ces signaux via son API REST et ses webhooks, ce qui permet à votre plateforme d'automatiser ces actions sans passer par l'interface Meta. L'architecture multi-tenant de Whakup isole les quality ratings par numéro, de sorte qu'un marchand en difficulté n'affecte pas les autres.

Pour explorer toutes les capacités techniques disponibles, consultez la page d'intégration de l'API WhatsApp Whakup.

FAQ

Le quality rating est-il partagé entre tous les numéros d'un WABA ?

Non. Le quality rating est calculé au niveau du numéro de téléphone, pas du WABA. Si un marchand a deux numéros sur le même WABA, chaque numéro a son propre score. C'est pourquoi la séparation des numéros par usage (marketing vs. service client) peut limiter les risques.

Peut-on demander une révision du score à Meta si le numéro est suspendu ?

Oui, Meta propose un processus d'appel. Il faut démontrer que les pratiques d'envoi ont été corrigées : nettoyage des listes, réduction de la fréquence, révision des templates. La décision revient à Meta et peut prendre plusieurs jours.

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

Un score faible réduit les limites de messagerie globales du numéro, ce qui peut affecter tous les types d'envoi, y compris les messages utility. C'est une raison supplémentaire d'isoler les numéros dédiés aux envois critiques (confirmations, alertes) des numéros utilisés pour les campagnes marketing.

Comment éviter que les messages de fidélité soient perçus comme du spam ?

La pertinence est la meilleure protection. Un message personnalisé ("Bonjour Marie, vos 500 points expirent dans 3 jours") est beaucoup moins susceptible d'être signalé qu'un message générique. Utilisez les variables de template pour personnaliser chaque envoi avec le prénom, le solde de points ou l'offre spécifique au profil du client.