API WhatsApp et les rate limits : guide pour les plateformes de fidélité

Les rate limits WhatsApp API désignent les plafonds d'envoi imposés par Meta sur chaque numéro de téléphone Business. Ces limites ne sont pas fixes : elles évoluent dynamiquement selon l'ancienneté du numéro, la qualité des envois et le volume historique traité. Pour une plateforme de fidélité qui doit déclencher des campagnes pour des centaines d'enseignes simultanément, comprendre ces plafonds et architecturer les envois en conséquence est un prérequis technique non négociable.

Le système de niveaux de messagerie Meta (tiers)

Meta organise les limites d'envoi en quatre niveaux progressifs. Chaque numéro commence au niveau 1 et monte automatiquement lorsque les conditions sont remplies.

Niveau	Messages marketing / 24h	Condition de montée
Tier 1	1 000	Point de départ
Tier 2	10 000	2x le seuil précédent envoyé en 7 jours avec quality rating vert/jaune
Tier 3	100 000	Idem depuis tier 2
Tier 4	Illimité	Sur demande, après historique solide

Ces limites s'appliquent aux messages marketing (templates de catégorie MARKETING). Les messages de catégorie UTILITY et AUTHENTICATION ont leurs propres compteurs, généralement plus généreux.

Pour une plateforme de fidélité, la plupart des nouveaux numéros de marchands démarrent au tier 1. Il faut donc planifier une montée en charge progressive, notamment dans les premières semaines d'un nouveau marchand.

Notre article sur les limites de messagerie WhatsApp API détaille les mécanismes de progression.

Comment les rate limits impactent une architecture multi-tenant

Dans une plateforme de fidélité multi-tenant, chaque marchand a son propre numéro WhatsApp. Les rate limits sont appliqués au niveau du numéro, pas au niveau de votre plateforme ou de votre compte BSP. Cela a plusieurs implications :

Isolation naturelle : un marchand qui atteint son plafond n'affecte pas les autres. Chaque numéro a son propre quota.

Nécessité d'un scheduler par tenant : si un marchand au tier 1 veut envoyer 5 000 messages en une journée, votre plateforme doit mettre en file d'attente les 4 000 messages qui dépassent le plafond et les envoyer le lendemain.

Détection des erreurs de rate limit : l'API Graph retourne une erreur 131048 lorsque le plafond est atteint. Votre backend doit intercepter cette erreur, marquer le message comme "en attente" et le replanifier sans le perdre.

Gestion du quality rating en parallèle : les rate limits et le quality rating sont liés. Un numéro qui passe en score rouge peut voir ses limites réduites même s'il était au tier 3. Votre système doit monitorer les deux métriques en parallèle.

Pour une vue complète sur la gestion des numéros et comptes multiples, consultez notre guide sur le WABA multi-numéros.

Architecturer les envois pour respecter les plafonds

Une file d'attente naïve (FIFO simple) n'est pas suffisante. Voici les patterns recommandés pour une plateforme de fidélité :

Queue par numéro avec throttling adaptatif :

Chaque numéro a sa propre file. Le throttler connaît le tier actuel du numéro et limite le débit en conséquence :

• Tier 1 : max 1 000 messages/24h, soit environ 42 messages/heure en flux constant.
• Tier 2 : 10 000 messages/24h, soit 417 messages/heure.

Priorité par type de message :

Les messages transactionnels (expiration de points imminente, confirmation de récompense) doivent passer avant les campagnes promotionnelles. Implementez une queue à deux niveaux de priorité par numéro.

Retry avec backoff exponentiel :

En cas d'erreur de rate limit, ne réessayez pas immédiatement. Attendez 1 min, puis 5 min, puis 15 min. Cela évite de saturer l'API et de cumuler des erreurs.

Reporting en temps réel pour les marchands :

Exposez dans votre interface le nombre de messages envoyés vs. le plafond disponible, le tier actuel, et une estimation du temps nécessaire pour traiter la file d'attente en cours.

Ce que Whakup apporte pour simplifier cette gestion

Whakup expose son API REST avec une gestion transparente des erreurs de rate limit. Plutôt que de gérer vous-même les codes d'erreur Meta et les stratégies de retry, vous bénéficiez d'une couche d'abstraction stable.

Points clés de l'intégration Whakup pour la gestion des rate limits :

• Webhooks de statut : chaque message envoyé déclenche un webhook de statut (sent, delivered, read, failed). Les échecs liés aux rate limits sont distingués des autres types d'erreurs.
• API multi-numéros : vous pouvez interroger le tier et le quality rating de chaque numéro via des endpoints dédiés.
• Hébergement EU : l'infrastructure est hébergée en Europe, ce qui réduit la latence sur les appels API depuis vos serveurs FR/EU et limite les timeouts inattendus.

Sur la tarification, Whakup facture 0,0088 €/message + les frais Meta (environ 0,0712 € pour un message marketing vers un numéro français, soit ~0,08 €/message au total). Les messages utility (rappels de points, confirmations) coûtent environ 0,0336 €/message.

Pour démarrer votre intégration et tester les limites dans un environnement sandbox, consultez la page API WhatsApp de Whakup.

FAQ

Peut-on accélérer la montée en tier en envoyant beaucoup de messages rapidement ?

Oui, mais avec précaution. Pour passer du tier 1 au tier 2, il faut envoyer des volumes croissants avec un quality rating qui reste vert ou jaune. Si vous envoyez massivement vers des contacts non consentants pour "brûler" les paliers, le quality rating se dégrade et bloque la progression — voire fait descendre le numéro en dessous de son tier actuel.

Les messages entrants (réponses des clients) consomment-ils les rate limits ?

Non. Les rate limits s'appliquent uniquement aux messages sortants initiés par votre plateforme. Les réponses des clients ne sont pas comptabilisées dans les quotas.

Que se passe-t-il si un numéro atteint son plafond en milieu de campagne ?

L'API retourne une erreur 131048. Les messages suivants doivent être mis en queue et envoyés le lendemain (le compteur se remet à zéro toutes les 24h). Si votre plateforme ne gère pas cette queue, les messages non envoyés sont simplement perdus.

Les rate limits sont-ils les mêmes pour tous les pays ?

Les tiers sont définis par numéro, pas par pays. En revanche, les frais Meta varient selon le pays du destinataire, pas du numéro expéditeur. Un numéro français qui envoie vers le Maroc sera facturé aux tarifs Meta du Maroc pour ces messages.