API WhatsApp et les rate limits : guide pour les plateformes SMS

Les rate limits de l'API WhatsApp Business sont l'ensemble des contraintes que Meta impose sur le volume et la cadence des messages envoyés par un numéro de téléphone. Ils opèrent à deux niveaux : le messaging tier (limite quotidienne de contacts uniques) et les limites d'appels API (requêtes par seconde). Pour une plateforme SMS qui pilote des envois en masse pour plusieurs clients, ignorer ces limites se traduit directement par des erreurs 429, des messages non délivrés et des régressions de quality rating.

Les deux types de limites à distinguer

1. Le messaging tier : limite de contacts uniques par 24 h

Le tier définit combien de contacts uniques distincts un numéro peut contacter dans une fenêtre glissante de 24 heures. Ce n'est pas une limite de messages, mais de destinataires uniques.

Tier	Contacts uniques / 24 h
Tier 1	1 000
Tier 2	10 000
Tier 3	100 000
Tier 4+	Illimité (sur validation Meta)

Un numéro commence en tier 1 lors de son activation. La montée en tier est automatique si deux conditions sont remplies : envoyer un volume suffisant de messages vers des numéros non contactés récemment, et maintenir un quality rating vert ou jaune. La dégradation, elle, peut être instantanée en cas de chute du quality rating.

2. Les limites API : requêtes par seconde

Indépendamment du tier, l'API Cloud impose des limites sur le nombre d'appels API par seconde :

• 80 messages/seconde par numéro de téléphone pour l'envoi (endpoint /messages)
• 250 requêtes API/seconde par application Meta, toutes opérations confondues

Ces limites sont distinctes du tier. Un numéro en tier 3 peut théoriquement envoyer 100 000 messages par jour mais pas plus de 80 par seconde. Sur 24 heures, 80 messages/seconde représente bien plus de 100 000 — les limites API ne sont donc contraignantes qu'en cas de pic très court.

Architecture d'envoi pour plateformes multi-tenant

Pour une plateforme SMS gérant plusieurs dizaines de clients, la gestion des rate limits impose une architecture spécifique :

File d'attente par numéro

Chaque numéro doit avoir sa propre file d'attente de messages avec un débit contrôlé. Un worker par numéro respecte les 80 msg/s sans risquer de polluer les autres numéros en cas de pic.

Retry avec backoff exponentiel sur erreur 429

Quand Meta retourne une erreur 429 (too many requests), la réponse inclut un header Retry-After. Implémentez un retry automatique avec backoff exponentiel : attendez 1 s, puis 2 s, puis 4 s, etc., jusqu'à 5 tentatives maximum.

Suivi du tier en temps réel

Interrogez l'endpoint /phone_numbers/{phone-number-id} régulièrement pour surveiller les champs messaging_limit_tier et quality_rating. Adaptez les capacités d'envoi affichées à vos clients en conséquence.

Séparation trafic marketing vs utility

Les messages marketing et les messages utility/authentication consomment le même tier. Une bonne pratique consiste à réserver de la capacité pour les messages transactionnels (utility) qui ont un impact client immédiat, et à limiter les campagnes marketing si le tier est proche de la limite.

Pour comprendre pourquoi la distinction marketing/utility dépasse le simple rate limiting et affecte aussi la tarification, lisez notre article sur les catégories de templates WhatsApp.

Montée en tier : stratégie de warm-up

Un numéro nouvellement activé en tier 1 ne peut pas envoyer 10 000 messages dès le premier jour. Le warm-up est une phase indispensable :

• Semaine 1 : rester en dessous de 500 contacts/jour, messages utiles uniquement
• Semaine 2-3 : augmenter progressivement vers 800, puis 1 000 contacts/jour
• Validation du tier 2 : après avoir atteint 1 000 contacts/jour avec un quality rating vert pendant 7 jours consécutifs, Meta monte automatiquement en tier 2

Les mêmes principes s'appliquent pour la montée du tier 2 au tier 3. L'erreur la plus courante : lancer une grosse campagne dès l'activation d'un numéro, déclencher des signalements spam, et se retrouver bloqué en tier 1 avec un quality rating rouge.

Whakup accompagne les plateformes dans la définition de leur stratégie de warm-up et fournit les métriques nécessaires pour suivre la progression du tier en temps réel. Pour en savoir plus sur le choix entre développer l'intégration soi-même ou passer par un provider, consultez notre analyse build vs buy WhatsApp API.

Gestion des erreurs liées aux rate limits

Les codes d'erreur à traiter en priorité :

Code	Message	Action recommandée
131048	Message volume exceeded	Quota tier dépassé — attendre le reset (fenêtre 24 h glissante)
131056	Too many requests	Limite API 80 msg/s atteinte — backoff exponentiel
131042	Business account locked	Quality rating trop bas + tentatives répétées — contacter Meta Support
130472	User number not on WhatsApp	Numéro invalide — retirer de la liste

L'erreur 131048 mérite une attention particulière : contrairement à une idée reçue, la fenêtre de 24 heures est glissante, pas réinitialisée à minuit. Si vous avez contacté 10 000 utilisateurs entre 14h et 15h le lundi, cette capacité sera à nouveau disponible entre 14h et 15h le mardi.

FAQ

Est-ce que le tier s'applique au WABA ou au numéro de téléphone ?

Au numéro de téléphone. Chaque numéro a son propre tier indépendamment. Un compte WABA avec 3 numéros associés dispose de 3 tiers distincts, cumulables pour répartir les envois.

Les messages entrants (réponses des clients) consomment-ils le tier ?

Non. Le tier ne s'applique qu'aux messages sortants initiés par l'entreprise (Business-Initiated Conversations). Les messages entrants et les réponses dans une fenêtre de conversation ouverte (User-Initiated) ne sont pas limités par le tier.

Peut-on demander à Meta de passer directement en tier 3 sans warm-up ?

Non. La montée en tier est automatique et liée au comportement réel du numéro sur la plateforme. Meta ne propose pas de processus de validation manuelle pour accélérer la montée en tier, même pour les grands comptes.

Un numéro suspendu peut-il récupérer son tier ?

Après une suspension, le numéro repart généralement au tier 1 lors de sa réactivation. Le warm-up est à recommencer depuis le début.

---

Maîtriser les rate limits WhatsApp, c'est protéger la délivrabilité de l'ensemble de votre parc clients. Une architecture d'envoi bien conçue dès le départ évite les mauvaises surprises en production. Whakup, Meta Tech Provider certifié, vous fournit une API REST documentée avec les limites explicites par endpoint et un support technique pour dimensionner correctement votre intégration. Consultez notre page API WhatsApp Business pour démarrer.