Documentation

Limites de débit & quotas

TextMeFlow applique deux couches indépendantes : des limites de débit par numéro (qui protègent votre numéro WhatsApp des blocages Meta) et des quotas mensuels par plan (ce que vous payez). Cette page explique les deux, et ce que votre code doit faire quand il les atteint.

1. Limites de débit par numéro

Elles existent pour protéger votre numéro — WhatsApp bloque les numéros qui se comportent comme des canons à spam. Elles s'appliquent à chaque voie d'envoi (API native, endpoint compatible TextMeBot, intégrations no-code) :

  • 1 message par seconde en continu
  • 60 messages par minute
  • 1 000 messages par heure

Les limites de burst s'assouplissent une fois que votre numéro envoie depuis quelques semaines — un numéro « chaud » avec un bon historique de livraison obtient plus de marge qu'un numéro fraîchement connecté. Lisez les bonnes pratiques anti-spam pour la vue d'ensemble (score de risque, opt-in, gestion du STOP, heures calmes).

2. À quoi ressemble un 429

Au-delà de la limite de débit, l'API renvoie 429 Too Many Requests. Ne réessayez pas immédiatement en boucle serrée — attendez et réessayez avec un délai exponentiel. L'envoi via une file d'attente est le meilleur schéma : poussez les messages dans votre propre file et videz-la à ≤1 msg/s.

3. Quotas mensuels par plan

Indépendamment des limites de débit, chaque plan a un quota mensuel de messages — Free, c'est 50 messages/mois (à vie), les plans payants commencent à 5 €/mois. Consultez les tarifs pour les paliers actuels. Deux choses se produisent à l'approche du quota :

  • À 80 % d'utilisation, nous vous envoyons un avertissement par e-mail
  • À 100 %, les nouveaux envois sont rejetés avec 429 et l'erreur quota_exceeded — les messages ne sont jamais silencieusement reportés à la période suivante
HTTP/1.1 429 Too Many Requests
{"error": "quota_exceeded", "monthly_quota": 500, "used": 500}

La mise à niveau prend effet immédiatement (au prorata) ; sinon le compteur se réinitialise au début de la période de facturation suivante.

4. Les schémas qui vous évitent les ennuis

  • Étalez les lots : 200 rappels à 8 h pile déclencheront la limite par minute — planifiez-les sur une fenêtre de temps
  • Traitez 429 différemment des erreurs de validation 4xx : l'un signifie « plus tard », l'autre « jamais »
  • Surveillez les champs du payload quota_exceeded (monthly_quota, used) pour construire vos propres alertes d'utilisation
  • Variez le contenu des messages — un texte identique envoyé à de nombreux destinataires augmente le score de risque interne, même sous la limite de débit

En bref

Restez sous 1 msg/s, surveillez les 429 et passez au plan supérieur avant d'atteindre 100 % du quota. Les limites existent pour que votre numéro continue de fonctionner pendant des années.