API WhatsApp et les rate limits : guide pour les agences push notifications

Les rate limits de l'API WhatsApp Business définissent le nombre maximum de conversations que vous pouvez initier par numéro sur une période de 24 heures. Pour une agence push notifications qui gère des campagnes à volume, comprendre ces limites et savoir comment les faire évoluer est une compétence opérationnelle de base.

La structure des tiers d'envoi WhatsApp

Meta organise les capacités d'envoi en quatre niveaux progressifs, appelés tiers ou "Message Sending Limits". Ces tiers s'appliquent par numéro d'expéditeur (Phone Number ID) et par fenêtre glissante de 24 heures.

Tier	Conversations initiées par 24h	Condition d'accès
Tier 1	1 000	État initial après activation
Tier 2	10 000	Automatique selon usage et qualité
Tier 3	100 000	Automatique selon usage et qualité
Tier 4	Illimité	Sur demande auprès de Meta

Point clé : ces limites s'appliquent aux conversations initiées par l'entreprise (business-initiated), c'est-à-dire les messages marketing, utility ou authentication envoyés en premier. Les conversations initiées par les utilisateurs (qui répondent à votre message ou vous contactent eux-mêmes) ne comptent pas dans ce quota.

Pour une campagne push notifications touchant 50 000 contacts en une journée, vous avez besoin d'être au minimum en Tier 3 sur le numéro concerné.

Comment progresser automatiquement dans les tiers

La montée en tier est automatique et basée sur deux conditions combinées :

1. Volume d'envoi : vous devez atteindre un certain nombre de conversations uniques sur la période glissante précédente.
2. Quality rating : votre numéro doit maintenir un score vert ou jaune. Un score rouge bloque toute progression et peut provoquer une régression.

La progression se fait par paliers : un numéro en Tier 1 passe en Tier 2 après avoir atteint 1 000 conversations uniques en 7 jours avec un bon score. La progression de Tier 2 vers Tier 3 suit la même logique mais avec un seuil plus élevé.

Conséquence pratique pour les agences : vous ne pouvez pas mettre un numéro neuf à la production à pleine capacité dès le premier jour. Prévoyez une phase de chauffe (ramp-up) d'une à deux semaines sur chaque numéro avant de lancer vos campagnes à plein volume.

Les autres limites techniques à connaître

Au-delà des tiers de conversation, l'API WhatsApp impose d'autres contraintes de débit :

Limite de débit API : l'API Cloud de Meta accepte environ 80 requêtes par seconde par numéro de téléphone. En pratique, pour des messages non-HSM (réponses dans une conversation ouverte), la limite est encore plus basse. Si vous dépassez ce seuil, Meta renvoie une erreur de rate limiting et vous devez mettre en place un système de retry avec backoff exponentiel.

Limite de 30 messages par seconde : pour les envois de templates HSM (campagnes), la limite effective est de 30 messages par seconde par numéro. Pour envoyer 100 000 messages en une heure, vous avez besoin soit de plusieurs numéros, soit de 55 minutes de flux continu.

Limite des sessions API : les tokens d'accès ont une durée de validité. Un token expiré provoque des erreurs silencieuses si votre système ne gère pas le rafraîchissement automatique.

Pour les agences push qui gèrent des volumes importants, la documentation technique de l'API Whakup détaille la gestion du débit et des queues d'envoi.

Stratégies pour gérer les volumes dans votre infrastructure

Plusieurs approches permettent d'optimiser l'utilisation des rate limits :

Multi-numéros : la solution la plus simple pour augmenter le débit total. Si un numéro est limité à 30 messages/seconde, dix numéros vous donnent 300 messages/seconde. Cela nécessite une architecture multi-tenant et une répartition intelligente de la charge entre numéros.

File d'attente avec throttling : ne jamais envoyer directement depuis votre application vers l'API Meta. Passez par une file d'attente (RabbitMQ, SQS, Redis Queue) qui régule le débit et gère les retries automatiques en cas d'erreur de rate limiting.

Fenêtrage temporel : si vous n'avez qu'un seul numéro et que votre campagne ne nécessite pas d'envoi immédiat, étalez les envois sur plusieurs heures plutôt que de saturer le quota en quelques minutes.

Monitoring en temps réel : suivez le nombre de conversations initiées par numéro via l'API Graph ou les webhooks. Déclenchez une alerte automatique si vous approchez du seuil du tier actuel.

Le guide build vs buy pour l'API WhatsApp analyse en détail la complexité de développer cette infrastructure en interne versus l'externaliser à un BSP.

FAQ

Les rate limits s'appliquent-ils aussi aux messages transactionnels ?

Oui. Les tiers s'appliquent à toutes les conversations business-initiated, quelle que soit la catégorie (marketing, utility, authentication). En revanche, les conversations user-initiated (le client vous écrit en premier) ne sont pas comptées dans le quota.

Que se passe-t-il si je dépasse le seuil du tier en cours ?

Meta refuse les envois supplémentaires avec une erreur spécifique (code 131056 ou similaire). Les messages en attente ne sont pas perdus si vous avez une queue : ils seront envoyés à la prochaine fenêtre de 24 heures. Sans queue, ils sont perdus.

Peut-on demander manuellement une montée en tier ?

Le Tier 4 (illimité) peut être demandé directement à Meta via un formulaire dédié. Pour les Tiers 2 et 3, la progression est entièrement automatique et ne peut pas être accélérée manuellement, même avec le support Meta.

Les rate limits sont-ils identiques pour l'API Cloud et l'API On-Premise ?

Les tiers de conversation sont les mêmes. En revanche, les limites de débit API (requêtes par seconde) peuvent différer légèrement entre les deux versions. Pour les agences qui n'hébergent pas leur propre infrastructure, l'API Cloud (gérée par Meta) est la solution recommandée.

---

Maîtriser les rate limits est une condition non négociable pour opérer des campagnes push WhatsApp à l'échelle. Planifiez le ramp-up de vos numéros, mettez en place des queues robustes et surveillez vos tiers en continu. Pour démarrer avec une infrastructure déjà calibrée pour les volumes, découvrez l'API WhatsApp Whakup et consultez notre comparatif des BSP WhatsApp en France.