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

Les rate limits de l'API WhatsApp Business définissent le nombre de messages qu'un numéro expéditeur peut envoyer par unité de temps. Contrairement à une API email qui travaille en dizaines de milliers de messages par heure, WhatsApp impose des plafonds par paliers progressifs liés à la réputation du numéro. Pour une plateforme emailing habituée à des envois massifs instantanés, adapter son architecture à ces contraintes est un prérequis non négociable.

Les messaging tiers : le système de paliers WhatsApp

WhatsApp utilise un système de quatre tiers pour définir le volume journalier de messages template (Business-Initiated Conversations) qu'un numéro peut initier :

Tier	Volume max / 24h	Condition d'accès
Tier 1	1 000 conversations	Par défaut à l'activation
Tier 2	10 000 conversations	Automatique si conditions remplies
Tier 3	100 000 conversations	Automatique si conditions remplies
Tier 4	Illimité	Sur demande via BSP

La montée en tier est automatique : si un numéro initie plus de 50 % de son plafond actuel pendant 7 jours consécutifs, et que son quality rating est "High" ou "Medium", Meta élève le tier automatiquement. En revanche, un quality rating "Low" bloque la progression et peut rétrograde le tier.

Point critique pour les plateformes emailing : le plafond s'applique au niveau du numéro, pas du compte. Si votre client veut envoyer à 50 000 contacts en une campagne, il lui faut soit être en Tier 3, soit répartir sur plusieurs numéros.

Rate limits API au niveau technique

En dehors des messaging tiers (plafond logique), l'API Cloud impose des limites techniques d'appels HTTP :

• 80 appels par seconde par numéro de téléphone pour l'endpoint d'envoi de messages (POST /messages).
• Des limites sur les autres endpoints (gestion des templates, webhooks) sont moins restrictives.

Pour une plateforme emailing qui envoie en rafale, 80 appels/seconde peut sembler faible. En pratique, cela représente 288 000 requêtes par heure. Pour des volumes plus importants, la solution est l'architecture multi-numéros.

Il faut également gérer les codes d'erreur 429 (Too Many Requests) et 130429 (rate limit atteint) dans votre moteur d'envoi. La stratégie recommandée est un backoff exponentiel avec retry queue.

Architecture d'envoi pour une plateforme emailing

Une plateforme emailing qui intègre WhatsApp doit repenser son pipeline d'envoi :

File d'attente avec throttling par numéro. Chaque numéro client dispose de sa propre queue isolée avec un débit maximal contrôlé (ex. : 60 messages/seconde pour garder une marge sur la limite des 80). Ne jamais partager une queue entre plusieurs numéros/clients.

Distribution multi-numéros pour les gros volumes. Si un client a plusieurs numéros enregistrés sur son WABA (ce que l'API WhatsApp supporte), la plateforme peut distribuer la campagne sur N numéros pour multiplier le débit effectif. Attention : chaque numéro a son propre tier et son propre quality rating.

Séquencement des campagnes. Pour un client en Tier 1 (1 000 contacts/jour), une campagne à 3 000 contacts se fait en 3 jours. Votre planificateur de campagne doit gérer ce séquencement automatiquement et informer le client du calendrier d'envoi résultant.

Monitoring des tiers en temps réel. Interroger régulièrement le champ messaging_limit_tier via l'API Graph pour mettre à jour l'affichage dans votre interface et recalculer les estimations d'envoi.

Stratégies de montée en volume pour vos clients

Accompagner vos clients dans la montée en tier est un service à valeur ajoutée :

• Warm-up progressif : au lancement d'un nouveau numéro, commencer par envoyer à 500-800 contacts/jour (sous le plafond Tier 1) pour établir un bon quality rating avant de pousser le volume.
• Prioriser la qualité des listes : des listes opt-in propres génèrent peu de signalements, ce qui maintient le quality rating haut et facilite la progression automatique des tiers.
• Éviter les pics abrupts : une augmentation soudaine du volume sans warm-up peut déclencher une surveillance de la part de Meta, même si le volume reste sous le plafond théorique.
• Communiquer les tiers dans l'interface : afficher clairement le tier actuel, le plafond en cours, et une estimation du délai pour passer au tier supérieur.

Pour mieux comprendre comment le quality rating influence ces tiers, consultez notre article dédié sur la politique qualité Meta et son impact sur les scores WhatsApp.

FAQ

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

Non. Les rate limits concernent uniquement les messages initiés par l'entreprise (outbound). Les messages entrants et les réponses dans une fenêtre de conversation ouverte (24h) ne sont pas soumis aux mêmes contraintes.

Un client avec un WABA multi-numéros cumule-t-il les plafonds ?

Oui. Chaque numéro a son propre tier et son propre plafond. Un client avec 3 numéros en Tier 2 peut théoriquement envoyer 30 000 conversations/jour. Mais chaque numéro monte en tier indépendamment, en fonction de son propre historique de qualité.

Que se passe-t-il si on dépasse le plafond du tier en cours ?

Meta rejette les messages qui dépassent le plafond avec une erreur 131048 ou 130429. Les messages ne sont pas mis en file d'attente par Meta : c'est à la plateforme de gérer le retry. Si les dépassements sont fréquents et que le quality rating reste bon, Meta peut monter le tier automatiquement avant les 7 jours.

Le Tier 4 "illimité" est-il vraiment sans limite ?

Le Tier 4 supprime le plafond sur les conversations initiées, mais les limites techniques d'appels API (80/seconde) restent applicables. Pour des volumes très élevés, il faut contacter le BSP pour discuter d'architectures spécifiques.

---

Intégrer les rate limits WhatsApp dans votre plateforme emailing demande une refonte partielle du moteur d'envoi, mais ouvre la voie à un canal de communication nettement plus performant que l'email. Whakup, en tant que Meta Tech Provider certifié, accompagne les plateformes dans cette architecture. Consultez notre offre API WhatsApp Business pour démarrer, et notre guide sur le choix du meilleur BSP WhatsApp en France pour comparer les options disponibles.