API WhatsApp et les rate limits : guide pour les plateformes de chatbot IA

Les rate limits de l'API WhatsApp Business définissent combien de conversations votre chatbot IA peut ouvrir par tranche de temps. Mal anticipés, ils transforment un lancement réussi en incident de production au pire moment — lors d'une campagne, d'un pic de charge ou d'un onboarding client en masse.

Les deux niveaux de rate limiting à connaître

L'API WhatsApp impose des limites à deux niveaux distincts. Confondre les deux est la première source de bugs en production.

1. La messaging tier (limite de conversations par 24h)

C'est la limite la plus connue. Elle s'applique par numéro de téléphone et détermine combien de conversations business-initiated vous pouvez ouvrir sur 24 heures glissantes :

Tier	Conversations/jour	Condition d'accès
Tier 1	1 000	Défaut à l'activation
Tier 2	10 000	Tier 1 atteint + quality score High/Medium
Tier 3	100 000	Tier 2 atteint + quality score High/Medium
Tier 4	Illimité	Demande manuelle à Meta

La montée en tier est automatique si vous maintenez un quality score suffisant et que vous atteignez 80% de la limite du tier courant sur 7 jours consécutifs. La descente, elle, est immédiate dès que le quality score passe en Low.

2. Les rate limits de l'API Cloud (requêtes par seconde)

L'API Cloud de Meta impose aussi des limites sur le nombre d'appels HTTP par seconde vers l'endpoint messages. Le plafond actuel est de 80 messages par seconde par numéro de téléphone. Au-delà, Meta retourne une erreur 130429 (rate limit hit) que votre système doit gérer avec backoff exponentiel.

Impact sur l'architecture d'une plateforme chatbot IA

Une plateforme SaaS chatbot avec plusieurs dizaines de clients doit traiter ces limites à deux niveaux de son architecture.

Au niveau de chaque numéro client. Chaque client dispose de son propre numéro et donc de ses propres limites. Votre orchestrateur de messages ne doit pas mutualiser les files d'attente entre clients. Une campagne massive d'un client A ne doit pas retarder les messages transactionnels d'un client B.

Au niveau de l'envoi par numéro. Pour des chatbots IA à fort volume, 80 msg/s représente 4,8 millions de messages par jour — largement suffisant pour Tier 3. Mais si votre chatbot déclenche des envois en rafale (par exemple, une campagne batch déclenchée manuellement), un pic instantané peut dépasser la limite et générer des erreurs.

Architecture recommandée :

• File de messages par numéro avec un worker limité à 70-75 msg/s (marge de sécurité)
• Retry avec backoff exponentiel sur les erreurs 130429 et 131056
• Priorité de file : messages transactionnels (confirmations, alertes) passent avant les messages marketing

Stratégies de scaling pour les chatbots IA à fort volume

Multiplier les numéros pour les cas légitimes. Si un client a des besoins supérieurs à 100 000 conversations/jour, la solution n'est pas d'attendre le Tier 4. Plusieurs numéros sur le même WABA, chacun montant progressivement en tier, permettent de distribuer la charge. Attention : chaque numéro doit avoir son propre warmup.

Séparer les numéros par use case. Un numéro dédié aux campagnes marketing (catégorie à ~0,08 €/msg en France) et un numéro dédié aux notifications transactionnelles (catégorie utility à ~0,0336 €/msg). Cette séparation protège le quality score du numéro transactionnel des signaux négatifs générés par les campagnes.

Monitorer les limites en amont. L'API Graph expose l'endpoint GET /{phone-number-id}?fields=messaging_limit_tier,quality_rating pour connaître le tier courant. Exposez cette donnée dans votre dashboard client et alertez quand un numéro approche de 80% de sa limite journalière.

Gérer le warmup des nouveaux numéros. Un numéro activé via embedded signup démarre en Tier 1. Prévenez vos clients : impossible d'envoyer 50 000 messages le jour J. Planifiez un warmup de 2 à 4 semaines avec des volumes croissants et des audiences très engagées pour monter en tier rapidement.

FAQ

Quelle est la différence entre rate limit et messaging limit ?

Le rate limit est une limite technique sur le nombre de requêtes API par seconde (80 msg/s). La messaging limit (ou messaging tier) est une limite commerciale sur le nombre de conversations business-initiated par 24 heures. Les deux s'appliquent en parallèle.

Comment gérer l'erreur 130429 dans mon chatbot ?

L'erreur 130429 signifie que vous avez dépassé le rate limit de l'API. Implémentez un backoff exponentiel : attendez 1 seconde, réessayez ; si ça échoue encore, attendez 2 secondes, puis 4, puis 8. Ne jamais boucler en retry immédiat — cela aggrave la situation. Loggez ces erreurs pour identifier les pics de charge et ajuster votre throttling.

Les conversations user-initiated consomment-elles la messaging tier ?

Non. La messaging tier s'applique uniquement aux conversations business-initiated — celles que votre chatbot ouvre en envoyant le premier message. Les conversations initiées par l'utilisateur (qui envoie un message en premier) ne sont pas plafonnées par la messaging tier.

Un nouveau numéro peut-il passer de Tier 1 à Tier 3 en quelques jours ?

Théoriquement oui, si vous maintenez un quality score High et atteignez 80% de chaque tier sur 7 jours consécutifs. En pratique, le passage Tier 1 → Tier 3 prend généralement 3 à 6 semaines avec un warmup bien géré. Ne promettez pas à vos clients des volumes de Tier 3 dès l'activation.

---

Maîtriser les rate limits WhatsApp, c'est construire une plateforme chatbot IA qui tient ses promesses SLA même sous charge. Ces contraintes doivent être intégrées dans votre architecture dès le premier sprint, pas ajoutées en correctif après le premier incident. Découvrez comment l'API WhatsApp de Whakup simplifie la gestion multi-numéros et multi-tenant pour les éditeurs de chatbot. Pour approfondir, lisez notre article sur les limites de messagerie par tiers et le guide complet de l'API WhatsApp Business.