Rate limits API WhatsApp Business : tout ce qu'il faut savoir

Les rate limits de l'API WhatsApp Business définissent le volume de messages que vous pouvez envoyer dans un intervalle de temps donné. Meta impose deux types de limites : les messaging tiers (volume de contacts uniques sur 24 heures) et les limites d'appels API par seconde. Mal dimensionner son architecture par rapport à ces contraintes provoque des erreurs 429 et des files d'attente bloquées — un problème critique pour tout éditeur ou agence gérant des campagnes à grande échelle.

Les messaging tiers : volume par tranche de 24 heures

Le tier d'un numéro de téléphone détermine combien de contacts uniques vous pouvez contacter par fenêtre de 24 heures avec des messages initiés par l'entreprise (templates).

Tier	Contacts uniques / 24h
Tier 1	1 000
Tier 2	10 000
Tier 3	100 000
Tier 4 (non officiel)	Illimité (négocié avec Meta)

Comment progresser. Un numéro débute automatiquement en Tier 1. Pour monter en Tier 2, il faut envoyer 1 000 messages à des contacts uniques en 7 jours consécutifs avec un quality rating maintenu en Vert ou Jaune. Le passage Tier 2 → Tier 3 suit la même logique : 10 000 contacts uniques en 7 jours avec un bon score.

Attention : la progression n'est pas garantie. Si le quality rating passe au Rouge pendant la période de montée, le compteur est remis à zéro. Un quality rating dégradé peut également provoquer une rétrogradation de tier. Pour maîtriser ce score, consultez notre article sur comment améliorer son quality rating WhatsApp.

Limites d'appels API par seconde

Indépendamment des tiers, l'API Cloud de Meta impose des limites au niveau des requêtes HTTP.

Type de limite	Valeur par défaut
Messages par seconde (MPS)	80 messages/seconde par numéro
Requêtes GET sur les métriques	200 req/heure par app
Webhooks reçus	Pas de limite côté Meta

Le seuil de 80 messages/seconde est suffisant pour la majorité des cas. Une campagne de 100 000 messages peut théoriquement être envoyée en 20 minutes si la file d'attente est bien gérée. En pratique, il faut prévoir un buffer pour les retries et la gestion des erreurs.

Pour les volumes très élevés (millions de messages), Meta propose des limites étendues à la demande, avec un numéro de téléphone dédié et un accord contractuel spécifique.

Architecture recommandée pour gérer les rate limits

File d'attente avec backoff exponentiel

Ne jamais appeler l'API WhatsApp en synchrone depuis votre endpoint métier. La bonne pratique est :

Réception de la demande d'envoi dans votre système.
Mise en file (Redis, RabbitMQ, SQS ou équivalent).
Worker dédié qui dépile au rythme autorisé, avec détection des erreurs 429.
Backoff exponentiel sur les 429 : attente de 1s, 2s, 4s, 8s avant chaque retry.
Dead letter queue pour les messages non envoyés après N tentatives.

Gestion multi-numéros pour dépasser les tiers

Pour une plateforme SaaS multi-clients, la solution naturelle est d'attribuer un numéro dédié par client. Chaque numéro dispose de son propre tier, ce qui permet de paralléliser les envois sans impact croisé entre clients.

Whakup propose nativement une architecture multi-numéros et multi-tenant : chaque client de votre plateforme obtient son propre numéro et son propre WABA (WhatsApp Business Account), gérés via une API unifiée.

Surveillance des erreurs 429

Intégrez dans votre monitoring les codes d'erreur Meta suivants :

131042 : Message non envoyé, limite de fréquence atteinte.
130429 : Rate limit côté Meta Cloud API.
80007 : Limite du compte Business Manager.

Ces codes doivent déclencher une alerte immédiate et une mise en pause automatique de la file concernée.

Impact des rate limits sur la planification des campagnes

Pour un éditeur qui gère des campagnes Marketing à J+0, le calcul du timing d'envoi doit intégrer les contraintes de tier.

Exemple concret : une base de 50 000 contacts en Tier 2 (10 000 contacts/24h) nécessite 5 jours d'envoi pour toucher l'ensemble de la base. Si vous avez 5 clients en Tier 2 sur des numéros distincts, vous pouvez envoyer 50 000 messages en 24h en parallélisant.

Ce calcul doit être exposé à vos clients dans votre interface. Un dashboard indiquant le tier actuel, le volume restant sur la fenêtre de 24h et l'heure de réinitialisation évite les tickets de support inutiles.

L'API WhatsApp pour éditeurs et agences Whakup expose ces métriques en temps réel, avec des webhooks déclenchés à chaque changement de tier.

FAQ

Que se passe-t-il si je dépasse mon tier en envoyant plus de messages que prévu ?

L'API renvoie une erreur 131042. Les messages au-delà du quota ne sont pas envoyés et doivent être renvoyés après la réinitialisation de la fenêtre (24h glissantes). Il n'y a pas de file d'attente automatique côté Meta : c'est à votre architecture de gérer le buffering.

Les messages entrants (conversations initiées par l'utilisateur) sont-ils soumis aux rate limits ?

Non. Les messages reçus de la part des utilisateurs ne sont pas soumis aux tiers d'envoi. En revanche, les réponses que vous envoyez dans une fenêtre de 24h ouverte par l'utilisateur (conversations de service) ne consomment pas votre quota de tier — elles sont facturées différemment et ne comptent pas dans le décompte de contacts uniques Marketing.

Comment un éditeur peut-il accélérer la montée en tier pour un nouveau client ?

La progression dépend du quality rating et du volume envoyé. La meilleure stratégie est de commencer par des campagnes Utility (confirmation, notification) qui génèrent peu de blocages, avant de lancer les campagnes Marketing. Cela permet de consolider le quality rating avant d'augmenter les volumes. Consultez notre guide build vs buy pour l'API WhatsApp pour comprendre les implications architecturales.

Les rate limits sont-ils identiques sur l'API on-premise et l'API Cloud ?

L'API on-premise a été officiellement arrêtée par Meta. L'API Cloud est désormais le seul accès standard. Les rate limits décrits dans cet article s'appliquent à l'API Cloud Meta.

Dimensionner correctement son architecture autour des rate limits WhatsApp est un prérequis non négociable pour tout éditeur qui monte en charge. Buffering, multi-numéros, monitoring des erreurs : ces mécanismes doivent être intégrés dès la phase de conception. Pour intégrer l'API WhatsApp Business dans votre plateforme sans gérer la relation Meta directement, découvrez la solution Whakup Meta Tech Provider certifiée.