API WhatsApp et les rate limits : guide pour les intégrateurs

Les rate limits de l'API WhatsApp Business sont un système de régulation à plusieurs niveaux que Meta impose à chaque numéro de téléphone enregistré. Contrairement à de nombreuses APIs qui limitent les appels par seconde, WhatsApp régule le volume de conversations uniques qu'un numéro peut initier sur une fenêtre de 24 heures glissantes. Pour un intégrateur gérant des campagnes à fort volume ou plusieurs clients en simultané, comprendre ce mécanisme en détail est indispensable pour éviter les blocages en production.

Le système de tiers (messaging tiers)

Meta organise les rate limits autour de quatre paliers appelés "messaging tiers". Ces tiers s'appliquent uniquement aux messages template initiés par l'entreprise (catégories Marketing, Utility, Authentication). Les messages en réponse à une conversation ouverte par l'utilisateur (service window 24h) ne sont pas soumis à ces limites.

Tier	Conversations uniques / 24h	Condition d'accès
Tier 1	1 000	Par défaut à l'activation du numéro
Tier 2	10 000	Atteint automatiquement après envoi soutenu en Tier 1
Tier 3	100 000	Atteint automatiquement après envoi soutenu en Tier 2
Tier 4	Illimité	Sur demande auprès de Meta (volumes très élevés)

Note importante : Meta a révisé ses paliers en 2024. Les valeurs historiques (250 / 1 000 / 10 000 / 100 000) ont été remplacées par le tableau ci-dessus pour la majorité des comptes. Vérifiez toujours le tier actuel via l'API ou le Business Manager, car des exceptions existent selon l'ancienneté du compte.

La montée en tier est automatique et se déclenche quand un numéro envoie un volume suffisant de messages avec un quality rating "High" ou "Medium" maintenu pendant 7 jours consécutifs. Il n'y a pas de démarche manuelle à faire.

Ce qui compte comme "conversation unique"

C'est le point le plus mal compris des rate limits WhatsApp. La limite de tier s'applique au nombre de destinataires uniques contactés via un message template sur une fenêtre de 24h — et non au nombre de messages envoyés.

Implications concrètes :

• Envoyer 5 messages templates à 1 000 contacts distincts = 1 000 conversations comptabilisées (pas 5 000).
• Envoyer 1 message template à 1 000 contacts puis une relance à 500 d'entre eux dans la même fenêtre = 1 000 conversations (la relance réutilise les conversations déjà ouvertes si elles sont dans la fenêtre de 24h).
• Les messages en réponse à un utilisateur qui vous a écrit en premier = 0 conversation comptabilisée dans les rate limits.

Pour un intégrateur, cette distinction est fondamentale pour dimensionner les files d'attente et planifier les campagnes. Une campagne de 8 000 contacts sur un numéro en Tier 1 (1 000/24h) doit être étalée sur 8 jours minimum — ou répartie sur plusieurs numéros.

Retrouvez les détails sur le conversation pricing WhatsApp pour comprendre comment ces fenêtres impactent également la facturation.

Gestion technique des rate limits dans votre intégration

Une intégration robuste ne doit jamais atteindre le rate limit de manière "brute". Voici les mécanismes à implémenter.

File d'attente avec régulation :

• Maintenez un compteur de conversations initiées dans les dernières 24h, par numéro.
• Avant chaque envoi de template, vérifiez que le compteur est sous le seuil du tier actuel.
• Si le seuil est atteint, mettez les messages en file d'attente avec une fenêtre d'envoi différée.

Gestion des erreurs API :

• 131026 : "Message Undeliverable" (souvent lié au rate limit ou au quality rating).
• 131056 : "Account has reached its messaging limit for the day".
• 130429 : "Rate limit hit" au niveau de l'API (trop d'appels HTTP simultanés, distinct du tier limit).

Chaque erreur doit être traitée différemment. L'erreur 130429 demande un backoff exponentiel sur l'appel API. L'erreur 131056 indique que le tier est épuisé pour 24h — inutile de retenter, il faut attendre.

Monitoring en temps réel :

• Exposez le tier actuel et le volume restant dans votre dashboard.
• Mettez en place une alerte à 80% du quota journalier pour permettre à vos clients d'anticiper.
• Le webhook phone_number_quality_update notifie les changements de tier — abonnez-vous dessus.

Stratégies pour les intégrateurs gérant de forts volumes

Quand les volumes d'un client dépassent les capacités d'un seul numéro, plusieurs stratégies s'offrent à vous.

Multi-numéros sur le même WABA : Un WABA peut héberger plusieurs numéros de téléphone. Chaque numéro dispose de son propre tier indépendant. Vous pouvez donc répartir une campagne entre plusieurs numéros pour multiplier le débit effectif. Attention : chaque numéro doit être distinct (pas de numéro partagé) et les contacts doivent être répartis sans doublon pour éviter les signalements de duplication.

Priorisation par catégorie : Les messages Authentication (OTP, codes de vérification) ont une priorité critique. Dans votre file d'attente, isolez ces messages dans une voie dédiée qui ne dépend pas du même quota que les campagnes marketing. Un blocage de campagne ne doit jamais retarder l'envoi d'un OTP.

Montée en tier anticipée : Si un client prévoit une campagne de volume dans 30 jours, commencez à "réchauffer" le numéro dès maintenant avec des envois utility réguliers pour atteindre le Tier 2 ou 3 avant la campagne. Cette anticipation est souvent négligée et coûte cher le jour J.

Pour comprendre comment structurer vos templates selon les catégories Meta afin d'optimiser à la fois les coûts et les rate limits, consultez notre guide sur les catégories de templates WhatsApp.

L'API WhatsApp Business de Whakup expose le tier actuel et le quota restant directement dans les métadonnées de réponse API, sans appel supplémentaire au Business Manager.

FAQ

Les rate limits s'appliquent-ils aux messages entrants (réponses des utilisateurs) ?

Non. Les rate limits de tier concernent uniquement les messages templates initiés par votre entreprise (Business-Initiated Messages). Les messages entrants et les réponses dans une conversation service window (24h après le dernier message de l'utilisateur) ne sont pas soumis à ces limites.

Peut-on demander une augmentation de tier manuellement avant d'avoir atteint les conditions automatiques ?

Pour les tiers 1 à 3, la progression est strictement automatique — il n'est pas possible de demander une accélération. Pour le Tier 4 (illimité), une demande manuelle auprès de Meta est nécessaire, généralement accompagnée d'une justification de volume et d'un historique propre. Les Meta Tech Providers comme Whakup peuvent faciliter cette démarche.

Que se passe-t-il si j'envoie un message template à un contact déjà dans une conversation ouverte ?

Si une conversation a été initiée dans les dernières 24h (par un message template de n'importe quelle catégorie), les messages suivants vers ce même contact ne consomment pas de quota supplémentaire dans la fenêtre. En revanche, si la fenêtre de 24h est expirée, un nouveau message template rouvre une nouvelle conversation et consomme 1 unité du quota.

Le rate limit est-il remis à zéro à minuit ?

Non. La fenêtre de 24h est glissante à partir du premier envoi, pas réinitialisée à une heure fixe. Si vous envoyez 1 000 messages (Tier 1) à 14h, le quota se renouvelle progressivement à partir de 14h le lendemain, au fil des conversations qui arrivent à expiration.

---

Les rate limits WhatsApp sont gérables avec la bonne architecture, mais ils nécessitent une implémentation rigoureuse dès le départ. Whakup fournit à ses partenaires intégrateurs des outils de monitoring du tier, des webhooks de quota et une infrastructure multi-numéros native. Découvrez notre solution API WhatsApp pour intégrateurs et comment nous gérons la montée en charge pour vous.