Aller au contenu principal
Technique WhatsApp API 6 min de lecture

API WhatsApp et les rate limits : guide pour les agences de communication

Les rate limits de l'API WhatsApp Business définissent combien de messages vous pouvez envoyer par jour. Comprendre leur fonctionnement est indispensable pour toute agence de communication.

Les rate limits de l'API WhatsApp Business sont des plafonds de volume imposés par Meta sur chaque numéro de téléphone connecté. Ils ne sont pas fixes : ils évoluent selon le comportement d'envoi et la qualité perçue par les destinataires. Pour une agence de communication qui prépare des campagnes à fort volume, ne pas anticiper ces limites, c'est risquer de découvrir en production que votre numéro ne peut envoyer qu'à 1 000 personnes par jour — là où vous en aviez prévu 50 000.

Les tiers de messagerie et leurs plafonds

Meta organise les limites d'envoi en quatre niveaux, appelés tiers. Ces tiers s'appliquent au nombre de conversations initiées par l'entreprise (Business-Initiated Conversations) sur une fenêtre glissante de 24 heures.

Tier Conversations/24h Condition de passage
Tier 1 1 000 Numéro par défaut après vérification
Tier 2 10 000 Automatique après volume suffisant en Tier 1
Tier 3 100 000 Automatique après volume suffisant en Tier 2
Tier 4 Illimité Sur demande explicite à Meta

La montée en tier est automatique si deux conditions sont remplies :

  • Vous avez envoyé à au moins 50 % du plafond actuel sur les 7 derniers jours.
  • Votre quality rating est vert (score élevé).

Si votre quality rating est jaune ou rouge, vous ne pouvez pas progresser. Si il passe en rouge alors que vous êtes en Tier 3, vous pouvez redescendre en Tier 2.

Ce que les rate limits ne couvrent pas

Les limites par tier concernent les conversations initiées par l'entreprise. Elles ne s'appliquent pas :

  • Aux conversations initiées par les utilisateurs (réponses à vos messages ou messages entrants spontanés).
  • Aux messages envoyés en réponse à une conversation ouverte dans les 24 heures suivant le dernier message de l'utilisateur (fenêtre de service).

Cela a une conséquence pratique pour les agences qui gèrent du service client ou des chatbots : si vous répondez à des messages entrants, vous n'êtes pas limité par le tier. Les limites ne s'activent que quand vous initiez une conversation de votre côté avec un template HSM.

Il existe aussi une limite technique séparée : le débit par seconde de l'API Graph. Meta autorise un certain nombre de requêtes API par seconde par numéro. Si vous envoyez en rafale (batch), pensez à découper vos appels avec un délai entre chaque requête pour ne pas atteindre ce plafond et recevoir des erreurs 429.

Stratégie de montée en charge pour une agence

Planifiez 2 à 4 semaines de warm-up par numéro. Un numéro neuf commence toujours en Tier 1. Pour atteindre le Tier 3 avant une grande campagne, il faut activer le numéro tôt, l'alimenter avec des envois réguliers à volume croissant, et maintenir un quality rating vert.

Ne lancez jamais une grande campagne avec un numéro froid. C'est l'erreur classique. L'annonceur prévoit une campagne nationale pour son lancement de produit, le numéro est provisionné 48h avant — et le jour J, les envois sont bloqués à 1 000 messages.

Activez plusieurs numéros en parallèle pour le volume. Si votre campagne nécessite 200 000 envois en 24h et que vous êtes en Tier 3, vous avez besoin de deux numéros minimum (2 × 100 000). Whakup permet de gérer plusieurs numéros dans une même intégration et de distribuer les envois entre eux.

Monitorez les erreurs API en temps réel. Une erreur 131056 signifie que vous avez atteint votre limite de tier. Ne ré-essayez pas immédiatement : attendez la fenêtre suivante (les 24h se réinitialisent à une heure fixe par compte).

Pour une vue complète de l'architecture API, consultez notre guide de l'API WhatsApp Business. Pour comprendre comment le quality rating interagit avec les tiers, lisez notre article dédié sur la politique qualité Meta WhatsApp.

Récupérer les informations de tier via l'API

Vous pouvez interroger Meta directement pour connaître le tier actuel d'un numéro et ses limites :

GET https://graph.facebook.com/v20.0/{phone-number-id}?fields=messaging_limit_tier

La réponse retourne une valeur parmi TIER_50, TIER_250, TIER_1K, TIER_10K, TIER_100K, TIER_UNLIMITED. Intégrez cet appel dans votre dashboard agence pour visualiser en un coup d'oeil l'état de capacité de chaque numéro client.

Whakup expose ces informations directement dans son API, avec des webhooks qui vous alertent en cas de restriction ou de changement de tier — sans avoir besoin d'interroger Meta manuellement. Découvrez l'API WhatsApp Whakup pour construire votre infrastructure d'envoi à l'échelle.

FAQ

Les rate limits s'appliquent-ils par numéro ou par WABA ?

Par numéro de téléphone. Un WABA (WhatsApp Business Account) peut contenir plusieurs numéros, chacun avec son propre tier et son propre quality rating. Si vous avez besoin de volume, la solution est d'ajouter des numéros au WABA plutôt que d'attendre la montée en tier d'un seul numéro.

Peut-on demander à Meta d'accélérer la montée en tier ?

Non directement. La montée en tier est algorithmique. Vous pouvez en revanche vous assurer que les conditions sont remplies (volume à 50 % du plafond, quality rating vert) pour que le passage soit rapide. Certains BSPs peuvent faciliter la démarche, mais il n'existe pas de raccourci officiel.

Que se passe-t-il si on dépasse la limite pendant une campagne ?

Les messages en excès reçoivent une erreur 131056 dans la réponse API. Ils ne sont pas mis en file d'attente automatiquement : vous devez gérer la retry logic côté client. Prévoyez une queue avec des délais exponentiels et un suivi des messages non délivrés.

Les messages d'authentification (OTP) sont-ils soumis aux mêmes limites ?

Les messages d'authentification (catégorie AUTHENTICATION) suivent les mêmes tiers que les autres messages initiés par l'entreprise. En revanche, Meta applique des règles d'envoi spécifiques pour les OTP : il faut utiliser les templates de la catégorie AUTHENTICATION et respecter les contraintes de contenu associées.


Les rate limits sont une contrainte réelle que toute agence doit intégrer dans sa planification dès le premier brief. Avec Whakup, vous gérez le warm-up, la répartition multi-numéros et le monitoring des tiers depuis une seule API. Explorez l'offre Whakup et construisez une capacité d'envoi à la hauteur de vos ambitions campagnes.

#technique api whatsapp#rate limits whatsapp api#agence communication
Arthur Lyonnet
Arthur LyonnetCo-fondateur & CEO

Co-fondateur de Whakup, Arthur accompagne les entreprises africaines dans leur transformation digitale via WhatsApp depuis 2022. Passionné par le growth marketing et l'entrepreneuriat en Afrique francophone.

🚀

Prêt à passer à l'action ?

Essayez Whakup gratuitement pendant 15 jours. Aucune carte bancaire requise.

Démarrer l'essai gratuit