API WhatsApp et le quality rating : guide pour les plateformes no-code

Le quality rating WhatsApp est le score attribué par Meta à chaque numéro de téléphone connecté à l'API WhatsApp Business. Ce score reflète la qualité des interactions entre l'expéditeur et ses destinataires : trop de blocages ou de signalements, et Meta bride automatiquement la capacité d'envoi. Pour les plateformes no-code qui hébergent plusieurs clients, comprendre ce mécanisme est essentiel pour éviter les incidents en cascade.

Comment Meta calcule le quality rating

Meta évalue en continu chaque numéro de téléphone sur une fenêtre glissante de 7 jours. Les signaux négatifs pris en compte sont :

• Blocages : un destinataire bloque l'expéditeur après avoir reçu un message
• Signalements "spam" : un destinataire signale le message comme indésirable
• Taux de lecture bas : indicateur indirect d'un manque d'engagement

Le score résultant se traduit en trois niveaux :

Score	Couleur Meta	Signification
Bon	Vert	Envois non limités
Moyen	Jaune	Avertissement, surveillance accrue
Mauvais	Rouge	Limite d'envoi abaissée automatiquement

Quand le score passe en rouge, Meta peut réduire le messaging tier du numéro (le nombre de conversations uniques autorisées par 24h). Si aucune amélioration n'est constatée, le numéro peut être suspendu.

Ce que cela implique pour une plateforme no-code

Si vous proposez WhatsApp à plusieurs clients sur une même infrastructure, le quality rating de chaque client est isolé à son propre numéro de téléphone. Un client en mauvaise posture n'affecte pas les autres — à condition que votre architecture soit correctement multi-tenant.

En revanche, vous devez :

• Exposer le quality rating dans votre interface : vos clients doivent voir leur score en temps réel, pas seulement au moment d'un incident.
• Déclencher des alertes automatiques : quand le score passe en jaune ou rouge, votre plateforme doit notifier le client sans attendre.
• Documenter les bonnes pratiques : les clients qui ne comprennent pas les règles d'opt-in ou de fréquence d'envoi dégradent leur score rapidement.

Sur une plateforme no-code, ces informations sont disponibles via les webhooks Meta (phone_number_quality_update) ou via l'API Graph (GET /{phone-number-id}). Un BSP bien intégré expose ces données dans un tableau de bord et via des webhooks vers votre backend, sans que vous ayez à appeler Meta directement.

Les causes les plus fréquentes de dégradation du score

D'après les patterns observés sur les déploiements WhatsApp Business :

1. Envoi sans opt-in explicite C'est la cause numéro un. Des contacts qui reçoivent un message WhatsApp sans y avoir consenti bloquent ou signalent systématiquement. L'opt-in doit être explicite, documenté, et facilement révocable.

2. Fréquence d'envoi excessive Plusieurs messages marketing par semaine sur le même contact déclenchent de la fatigue. Contrairement à l'email, WhatsApp est perçu comme un canal intime. Une fréquence hebdomadaire est généralement le maximum acceptable pour les messages promotionnels.

3. Contenu non pertinent ou trompeur Un message dont le contenu ne correspond pas à ce pour quoi le contact a consenti génère des blocages. La cohérence entre le moment de l'opt-in et le contenu envoyé est critique.

4. Mauvaise gestion des désinscriptions Si un contact répond "STOP" et continue de recevoir des messages, le risque de signalement monte fortement. Votre plateforme doit gérer les désinscriptions en temps réel.

Pour aller plus loin sur les règles d'opt-in conformes RGPD, consultez notre article sur l'opt-in WhatsApp et le RGPD pour les plateformes no-code.

Comment surveiller le quality rating sans code complexe

Via l'API WhatsApp de Whakup, le quality rating est exposé de deux façons :

Via l'interface : chaque numéro géré dans le dashboard affiche son score en temps réel avec un historique sur 30 jours.

Via webhook : Whakup transmet l'événement phone_number_quality_update à l'URL de votre choix dès qu'un changement de score est détecté. Sur une plateforme no-code (Bubble, Make, Zapier), vous créez un webhook entrant qui déclenche :

• Un email ou une notification Slack à l'équipe interne
• Un message dans l'espace client concerné
• Un flag dans votre CRM ou base de données

Aucune ligne de code backend n'est requise — juste la configuration d'un flux no-code sur réception du webhook.

Pour mieux comprendre comment le quality rating interagit avec les limites d'envoi, lisez aussi notre guide complet de l'API WhatsApp Business.

FAQ

Le quality rating est-il partagé entre plusieurs numéros du même WABA ?

Non. Chaque numéro de téléphone a son propre quality rating, indépendamment des autres numéros rattachés au même WABA. Un client avec deux numéros peut avoir un bon score sur l'un et un mauvais score sur l'autre.

Comment remonter un quality rating passé en rouge ?

La seule façon est d'améliorer la qualité des envois : réduire la fréquence, nettoyer la liste de contacts, s'assurer que tous les destinataires ont donné un opt-in explicite. Meta réévalue le score sur une fenêtre de 7 jours. Il n'existe pas de mécanisme de contestation directe.

Est-ce que Whakup m'alerte automatiquement si le score d'un de mes clients baisse ?

Oui. Whakup transmet les webhooks phone_number_quality_update en temps réel vers l'URL configurée dans votre compte. Vous pouvez brancher ces événements directement dans votre plateforme no-code pour déclencher des alertes.

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

Le quality rating s'applique à tous les types de messages. Cependant, les messages utility et authentication (confirmations de commande, codes OTP) génèrent très rarement des blocages car les destinataires les ont explicitement sollicités. Le risque de dégradation du score concerne principalement les messages marketing non ciblés.

---

Protéger le quality rating de vos clients, c'est protéger la délivrabilité de votre plateforme entière. Avec Whakup — Meta Tech Provider certifié — vous disposez des outils de monitoring en temps réel et d'une architecture multi-tenant qui isole chaque compte client. Parlez-nous de votre projet pour voir comment intégrer ces alertes dans votre plateforme.