API WhatsApp et les rate limits : guide pour les logiciels RH

Les rate limits de l'API WhatsApp Business définissent le nombre de conversations uniques qu'un numéro peut ouvrir par tranche de 24 heures. Pour un logiciel RH qui automatise des notifications de recrutement, des envois d'onboarding ou des rappels de formation, ces limites conditionnent directement la capacité à passer à l'échelle. Les ignorer au moment de l'intégration, c'est découvrir en production que vos clients ne peuvent pas notifier 500 candidats d'un coup.

Le système de niveaux de messagerie WhatsApp

Meta organise les limites d'envoi en quatre paliers cumulatifs, appelés messaging tiers. Chaque numéro commence au niveau 1 après son activation et monte automatiquement si le quality rating reste vert.

Tier	Conversations uniques / 24h	Condition de montée
Tier 1	1 000	Départ par défaut
Tier 2	10 000	1 000 conversations + quality rating High 7 jours
Tier 3	100 000	10 000 conversations + quality rating High 7 jours
Tier 4	Illimité	100 000 conversations + quality rating High 7 jours

Point crucial : ces limites comptent les conversations initiées par l'entreprise (business-initiated), pas le volume de messages par conversation. Une conversation = une fenêtre de 24 heures avec un numéro de destinataire unique. Si vous envoyez 3 messages à la même personne dans la même fenêtre, cela compte pour une seule conversation.

Les messages de service (utility, authentication) déclenchés dans une fenêtre de conversation déjà ouverte par l'utilisateur ne consomment pas le quota — seules les nouvelles conversations business-initiated l'entament.

Impact concret sur les flux RH

Pour un logiciel RH, le tier de départ (1 000 conversations/jour) est souvent suffisant pour les premiers clients. Mais certains cas d'usage exigent une anticipation :

• Campagnes de recrutement saisonnières : un acteur de la grande distribution qui notifie 8 000 candidats en 24 heures dépasse le tier 1 et le tier 2.
• Onboarding massif : un logiciel de gestion de personnel intérimaire qui intègre 5 000 collaborateurs en une semaine doit être en tier 3 ou 4.
• Rappels de formation obligatoire : les envois annuels à l'ensemble des collaborateurs d'un groupe peuvent représenter des dizaines de milliers de messages sur une courte fenêtre.

La solution : préparer la montée en tier avant les pics, pas pendant. Un numéro activé la veille d'une campagne RH restera bloqué en tier 1.

Architecture recommandée pour les logiciels RH multi-clients

Dans une architecture multi-tenant (un numéro WhatsApp par client RH), chaque client a ses propres limites et sa propre progression de tier. Ce cloisonnement est un avantage : un client qui sature son quota n'impacte pas les autres.

Recommandations d'architecture :

• File d'attente par numéro : implémenter une queue (Redis, RabbitMQ, SQS…) qui contrôle le débit d'envoi par phone_number_id. Ne jamais appeler l'API WhatsApp directement depuis un trigger synchrone.
• Monitoring des limites : l'endpoint GET /{phone-number-id}?fields=messaging_limit_tier retourne le tier actuel. Exposer cette information dans le tableau de bord client.
• Gestion des erreurs 429 : l'API retourne un code 130429 (rate limit atteint) ou 131056 (quota journalier dépassé). Votre file d'attente doit gérer le retry avec backoff exponentiel.
• Étalement des envois : pour les campagnes importantes, envoyer sur plusieurs créneaux horaires plutôt qu'en burst. Cela préserve aussi le quality rating.

// Exemple de gestion d'erreur rate limit
{
  "error": {
    "code": 130429,
    "message": "Rate limit hit",
    "error_data": {
      "messaging_product": "whatsapp",
      "details": "Message failed to send because there were too many messages sent from this phone number in a short period of time"
    }
  }
}

Accélérer la montée en tier pour vos clients RH

La progression de tier est automatique mais pas instantanée. Voici comment l'accélérer de façon légitime :

1. Envoyer des messages à haute valeur ajoutée dès le départ : les premiers envois d'un numéro sont déterminants pour le quality rating. Commencer avec des messages utility (notifications de statut, confirmations) plutôt que des campagnes marketing.
2. Ne pas envoyer en masse immédiatement : monter progressivement en volume — 200 messages le jour 1, 500 le jour 3, 1 000 le jour 7. Cette approche de "warm-up" est documentée par Meta.
3. Surveiller le quality rating en continu : la montée en tier est annulée si le score passe en yellow ou red pendant la fenêtre de 7 jours. Voir notre article sur le quality rating WhatsApp pour logiciels RH.

Pour un client RH qui a besoin de tier 3 ou 4 rapidement, Whakup peut accompagner la stratégie de warm-up dans le cadre de l'intégration.

Retrouvez l'ensemble des paramètres techniques dans notre guide complet de l'API WhatsApp Business et consultez les tarifs de l'API WhatsApp 2026 pour dimensionner vos coûts selon les volumes visés.

FAQ

Les rate limits s'appliquent-ils aussi aux messages reçus ?

Non. Il n'y a pas de limite sur les messages entrants (messages envoyés par les utilisateurs vers votre numéro). Les rate limits ne concernent que les messages business-initiated, c'est-à-dire les messages que vous envoyez en premier.

Un logiciel RH peut-il utiliser plusieurs numéros pour contourner les limites ?

Techniquement oui : plusieurs numéros sous le même WABA peuvent être utilisés. Mais Meta pénalise les architectures conçues explicitement pour contourner les limites. La bonne approche est d'attribuer un numéro par marque ou par entité légale distincte, pas de multiplier les numéros pour un même client.

Les messages dans une conversation ouverte comptent-ils dans le quota ?

Seule l'ouverture d'une nouvelle conversation business-initiated consomme le quota. Les messages envoyés dans une fenêtre de conversation déjà active (déclenchée par un message entrant de l'utilisateur dans les 24 dernières heures) ne consomment pas le quota journalier.

Que se passe-t-il si un client RH dépasse son quota en cours d'envoi ?

L'API retourne une erreur 131056. Les messages en attente ne sont pas envoyés automatiquement le lendemain — votre système doit les reprendre manuellement ou via la file d'attente avec retry. Un message non envoyé reste en attente dans votre queue jusqu'à ce que le quota se réinitialise à minuit UTC.

---

Les rate limits ne sont pas un obstacle : ils sont une mécanique de réputation que vous devez piloter pour vos clients RH. En intégrant la surveillance des tiers et une architecture de queue dès le départ, vous offrez une plateforme WhatsApp fiable et scalable. Démarrez avec l'API WhatsApp Whakup et disposez d'une infrastructure multi-tenant prête pour la montée en charge.