API WhatsApp et le quality rating : guide pour les logiciels RH

Le quality rating WhatsApp est le score de réputation attribué par Meta à chaque numéro WhatsApp Business. Il détermine directement la capacité de votre logiciel RH à envoyer des messages : un score dégradé réduit les limites d'envoi, un score bas bloqué suspend temporairement le numéro. Pour un éditeur de SIRH ou de plateforme de recrutement, comprendre ce mécanisme est indispensable avant de passer en production.

Comment Meta calcule le quality rating

Meta mesure la satisfaction des destinataires sur les 7 derniers jours glissants. Trois signaux négatifs font baisser le score :

1. Blocages : l'utilisateur bloque le numéro expéditeur après avoir reçu un message.
2. Signalements "spam" : l'utilisateur utilise le bouton "Signaler" dans WhatsApp.
3. Désabonnements massifs via les boutons opt-out intégrés aux templates.

Le score s'affiche sur trois niveaux dans le Meta Business Manager :

Niveau	Couleur	Signification
High	Vert	Score sain, limites d'envoi maximales actives
Medium	Jaune	Dégradation détectée, surveiller les envois
Low	Rouge	Suspension temporaire possible, limites réduites

Le quality rating est lié au numéro, pas au compte WABA dans son ensemble. Dans une architecture multi-tenant comme celle que propose Whakup, chaque client RH dispose de son propre numéro — un problème de score chez un client n'affecte pas les autres.

Les risques spécifiques aux logiciels RH

Les logiciels RH présentent des patterns d'envoi qui peuvent fragiliser le quality rating si la stratégie n'est pas maîtrisée :

• Campagnes de recrutement en masse : envoyer des offres d'emploi non sollicitées à des candidats qui n'ont pas explicitement opté pour WhatsApp génère des blocages.
• Messages d'onboarding automatiques envoyés trop tôt, avant que le collaborateur ait donné son consentement WhatsApp, produisent des signalements.
• Fréquence excessive : multiplier les relances sur un même candidat inactif dégrade rapidement le score.
• Contenu générique : un message perçu comme non pertinent (mauvaise segmentation) incite au blocage même si l'opt-in est en règle.

La bonne pratique : traiter WhatsApp comme un canal premium, à réserver aux communications à forte valeur ajoutée — pas comme un substitut à l'email de masse.

Surveiller et améliorer le quality rating

Surveillance :

• L'API WhatsApp expose un webhook phone_number_quality_update qui envoie une notification en temps réel dès que le score change. Votre logiciel RH doit écouter cet événement et alerter le client concerné.
• Le score est également consultable via l'endpoint GET /{phone-number-id}?fields=quality_rating.

Actions correctives immédiates :

• Identifier et stopper la campagne ou le template qui génère les blocages.
• Mettre en pause les envois marketing pendant 24-48 heures pour laisser le score se stabiliser.
• Analyser le taux de blocage par template : si un message précis concentre les signalements, le modifier ou le désactiver.

Actions préventives :

• N'envoyer des messages marketing qu'aux contacts ayant donné un opt-in explicite sur WhatsApp (voir notre guide sur l'opt-in RGPD WhatsApp).
• Inclure systématiquement un bouton de désabonnement dans les templates marketing.
• Segmenter finement : un candidat actif dans les 30 derniers jours n'a pas le même profil de risque qu'un candidat dormant depuis 6 mois.
• Échelonner les envois dans le temps plutôt que d'envoyer en un seul burst.

Ce que votre logiciel RH doit exposer à vos clients

En tant qu'éditeur, vous êtes responsable de la visibilité du quality rating pour vos clients. Voici les éléments à intégrer dans votre interface :

• Indicateur de score en temps réel : afficher le niveau High / Medium / Low avec un code couleur dans le tableau de bord du client.
• Historique des événements quality : permettre au DRH de voir quand le score a changé et à la suite de quel envoi.
• Alertes proactives : notifier le client dès que le score passe en Yellow ou Red, avant que les limites d'envoi ne soient réduites.
• Recommandations contextuelles : si le score est dégradé, afficher un message d'aide avec les actions correctives suggérées.

Ces fonctionnalités sont facilitées par l'architecture de Whakup : l'API WhatsApp Whakup expose les webhooks de qualité et les endpoints de monitoring sans configuration supplémentaire de votre côté.

Pour comprendre comment les limites d'envoi s'articulent avec le quality rating, consultez notre article sur les rate limits WhatsApp API pour logiciels RH.

Pour aller plus loin sur la politique de qualité Meta dans son ensemble, référez-vous à notre article sur la politique qualité Meta et son impact sur le score.

FAQ

Un quality rating bas bloque-t-il définitivement le numéro ?

Non. Meta distingue une dégradation temporaire (score Medium ou Low avec envois réduits) d'une suspension formelle. La suspension intervient seulement si le score reste Low trop longtemps sans action corrective. Dans la plupart des cas, stopper les envois problématiques et laisser passer 7 jours suffit à remonter le score.

Le quality rating est-il visible par les destinataires ?

Non, il est entièrement interne à Meta. Les destinataires ne voient pas ce score. Seuls vous (l'éditeur) et votre client (le compte WABA) y avez accès via le Business Manager ou l'API.

Un template refusé par Meta affecte-t-il le quality rating ?

Non directement. Un template refusé lors de la soumission n'est simplement pas approuvé — il ne peut pas être envoyé. C'est l'envoi de messages qui déclenchent des blocages ou des signalements qui impacte le score, pas la soumission de templates.

Combien de temps faut-il pour que le score remonte de Low à High ?

Le score est calculé sur une fenêtre glissante de 7 jours. Si vous cessez les envois problématiques, le score peut remonter en 7 à 14 jours. Des envois continus de haute qualité accélèrent la remontée.

---

Le quality rating n'est pas un détail technique : c'est le mécanisme central qui protège la délivrabilité de vos clients RH sur WhatsApp. Intégrez sa surveillance dans votre produit dès le départ, et appuyez-vous sur une infrastructure solide. Découvrez l'API WhatsApp Whakup pour déployer WhatsApp dans votre logiciel RH avec toutes les garanties de conformité et de performance.