API WhatsApp et les rate limits : guide pour les CRM

Q: Comment vérifier le tier actuel d'un numéro via l'API ?

Interrogez l'endpoint suivant avec votre token système : GET /{phone-number-id}?fields=messaging_limit_tier,quality_rating Le champ messaging_limit_tier retourne la valeur TIER_1, TIER_2, TIER_3 ou TIER_NOT_SET (numéro non encore qualifié). La gestion des rate limits est une responsabilité d'infrastructure que votre CRM doit prendre en charge de façon transparente pour vos clients. Un numéro bloqué en pleine campagne est une crise pour votre client — et un signal d'alerte sur la robustesse de votre intégration. Whakup, Meta Tech Provider certifié, fournit une API WhatsApp Business avec queue d'envoi managée, monitoring des tiers en temps réel et architecture multi-tenant isolée par défaut. Consultez également notre comparatif des meilleurs BSP WhatsApp en France et notre guide complet de l'API WhatsApp Business.

Les rate limits de l'API WhatsApp Business définissent le volume de messages qu'un numéro peut envoyer par unité de temps. Pour un CRM qui gère les campagnes de plusieurs clients en simultané, ignorer ces limites revient à déclencher des erreurs 131056 en production, à bloquer des envois critiques et à dégrader le quality rating de vos clients. Ce guide explique le système de tiers Meta, comment les rate limits s'appliquent en contexte multi-tenant, et comment architecturer votre CRM pour ne jamais les dépasser involontairement.

Le système de tiers de messaging Meta

Meta organise les capacités d'envoi en quatre tiers progressifs, basés sur le volume de conversations uniques initiées en 24 heures glissantes. Ces tiers concernent uniquement les messages outbound initiés par l'entreprise (Business Initiated), c'est-à-dire les messages utilisant un template approuvé.

Tier	Conversations uniques / 24h	Condition d'accès
Tier 1	1 000	Par défaut au démarrage
Tier 2	10 000	Tier 1 atteint + quality rating GREEN ou YELLOW
Tier 3	100 000	Tier 2 atteint + quality rating GREEN ou YELLOW
Tier 4 (unlimited)	Illimité	Tier 3 atteint + quality rating GREEN

La montée en tier est automatique : Meta augmente le tier dans les 24 heures suivant le dépassement du seuil, à condition que le quality rating soit satisfaisant. En revanche, un quality rating RED bloque la montée en tier et peut provoquer une descente.

Important : ces limites s'appliquent par numéro de téléphone, pas par WABA. En architecture multi-tenant, si chaque client CRM dispose de son propre numéro, leurs limites sont indépendantes.

Les autres rate limits à connaître

Limite sur les appels API (API call rate limit)

Indépendamment des tiers de messaging, l'API Graph impose une limite sur le nombre d'appels HTTP par token d'accès. Pour les tokens système liés à un WABA, la limite est de l'ordre de 200 appels par heure par token. Au-delà, Meta retourne une erreur #4 (Application Request Limit Reached).

En CRM multi-tenant, si tous vos clients partagent le même token système, vous pouvez atteindre cette limite lors de pics de campagnes simultanées. La solution : un token système par WABA client.

Limite sur les templates (template messaging rate limit)

L'envoi de messages template via l'API Cloud hébergée par Meta supporte jusqu'à 80 messages par seconde par numéro sur les comptes productifs. Cette limite est distincte des tiers de messaging et s'applique à la débit d'injection. Si votre CRM dépasse ce seuil, les appels API retournent une erreur 131056 (Spam Rate Limit Hit) ou 131048 (Too Many Requests).

Limite sur les messages de session (user-initiated)

Les messages de session (en réponse à un message entrant d'un utilisateur, dans la fenêtre de 24 heures) ne sont pas soumis aux tiers de messaging. Ils sont limités uniquement par le débit API (80 msg/s).

Architecturer votre CRM pour gérer les rate limits

Queue d'envoi avec throttling par numéro

Ne laissez jamais vos clients déclencher des envois en appel API direct et synchrone. Implémentez une queue persistante (Redis, RabbitMQ, SQS) avec un worker dédié par numéro client, configuré pour respecter :

Maximum 80 messages par seconde en débit d'injection
Comptage des conversations uniques sur 24h pour rester sous le tier courant

Exposez dans votre UI CRM le tier actuel de chaque numéro client et le nombre de conversations consommées sur la fenêtre en cours.

Gestion des erreurs 131048 et 131056

Ces deux codes d'erreur indiquent un dépassement de rate limit. Votre implémentation doit :

Détecter l'erreur dans la réponse API (code HTTP 429 ou erreur dans le corps JSON)
Appliquer un backoff exponentiel : attente de 1s, puis 2s, 4s, 8s avant les tentatives suivantes
Ne pas perdre le message : remettre le message en queue avec une priorité haute
Alerter si le backoff dépasse 5 tentatives sur un même message

Planification des campagnes en dehors des pics

Si plusieurs clients CRM lancent des campagnes simultanément, le débit total peut saturer vos workers. Proposez une fonctionnalité de planification horaire avec distribution automatique pour étaler les pics de charge.

Montée en tier : comment l'accélérer

Un numéro qui démarre en Tier 1 (1 000 conversations/24h) peut freiner les campagnes de nouveaux clients. Voici comment accélérer la montée en tier de façon conforme :

Démarrer avec des campagnes de faible volume sur des listes très engagées (contacts opt-in récents)
Maintenir un quality rating GREEN en ciblant des audiences pertinentes
Envoyer régulièrement plutôt qu'en pics — la montée en tier se déclenche sur le volume des 24 dernières heures
Ne pas tenter de gonfler artificiellement le volume avec des messages sans valeur : cela dégrade le quality rating et bloque la montée en tier

Un nouveau numéro peut passer du Tier 1 au Tier 3 en 2 à 3 semaines avec une stratégie d'envoi progressive et un quality rating stable.

FAQ

Les rate limits s'appliquent-ils aux messages entrants ?

Non. Les rate limits de Meta concernent uniquement les messages sortants initiés par l'entreprise via l'API. Les messages entrants des utilisateurs ne sont pas limités en volume, mais leur traitement côté CRM dépend de votre propre infrastructure (webhooks, base de données, workers).

Un CRM peut-il partager un seul numéro entre plusieurs clients ?

Techniquement oui, mais ce n'est pas recommandé. Les rate limits s'appliquent au numéro : si plusieurs clients partagent le même numéro, leurs volumes d'envoi s'additionnent et ils se disputent le même tier. En outre, le quality rating est mutualisé. L'architecture à privilégier en CRM est un numéro dédié par client final.

Que se passe-t-il si on dépasse le Tier 4 (unlimited) ?

Le Tier 4 est théoriquement illimité, mais Meta conserve la possibilité de plafonner les envois pour des raisons de capacité réseau. Dans la pratique, les WABA en Tier 4 avec un quality rating GREEN ne rencontrent pas de limitation en volume. Des débits très élevés (plusieurs millions de messages par jour) nécessitent une coordination avec votre BSP ou Tech Provider.

Comment vérifier le tier actuel d'un numéro via l'API ?

Interrogez l'endpoint suivant avec votre token système :

GET /{phone-number-id}?fields=messaging_limit_tier,quality_rating

Le champ messaging_limit_tier retourne la valeur TIER_1, TIER_2, TIER_3 ou TIER_NOT_SET (numéro non encore qualifié).

La gestion des rate limits est une responsabilité d'infrastructure que votre CRM doit prendre en charge de façon transparente pour vos clients. Un numéro bloqué en pleine campagne est une crise pour votre client — et un signal d'alerte sur la robustesse de votre intégration.

Whakup, Meta Tech Provider certifié, fournit une API WhatsApp Business avec queue d'envoi managée, monitoring des tiers en temps réel et architecture multi-tenant isolée par défaut. Consultez également notre comparatif des meilleurs BSP WhatsApp en France et notre guide complet de l'API WhatsApp Business.