Réponse courte
Selon la documentation de Meta, chaque numéro d'entreprise de l'API WhatsApp Cloud accepte jusqu'à 80 messages par seconde par défaut, et jusqu'à 1 000 par mise à niveau automatique pour les numéros éligibles. Des limites distinctes s'appliquent au même destinataire, aux appels de gestion de l'API Graph et au volume quotidien. Un dépassement du débit renvoie l'erreur 130429 : ralentissez, mettez les envois en file d'attente et réessayez avec un délai croissant.
Passer à 1 000 messages par seconde
Le plafond s'applique à chaque numéro d'entreprise et compte les messages entrants et sortants de tous types. Meta met à niveau automatiquement et gratuitement les numéros éligibles lorsque les trois conditions sont réunies. La mise à niveau peut prendre jusqu'à 1 minute, pendant laquelle le numéro est inutilisable.
Les numéros utilisés à la fois avec l'application WhatsApp Business et l'API Cloud ont un débit fixe de 20 messages par seconde.
| Condition | Détail |
|---|---|
| Limite de messagerie | Illimitée sur le portefeuille d'entreprise |
| Volume | 100 000 utilisateurs uniques ou plus contactés hors des fenêtres de service client sur 24 heures glissantes |
| Qualité | Score de qualité JAUNE (moyen) ou supérieur |
Quatre limites distinctes et leurs erreurs
| Limite | Ce qu'elle plafonne | Erreur typique |
|---|---|---|
| Débit | Messages par seconde et par numéro | 130429 |
| Limite par paire | Messages d'un numéro vers un même destinataire sur une courte durée | 131056 |
| Limites de l'API Graph | Appels de gestion par application et par compte | 4, 80007, 80008 |
| Limite de messagerie | Personnes uniques contactées sur 24 heures glissantes | Restrictions d'envoi |
Comment réessayer sans risque
- Mettez chaque envoi en file d'attente et videz la file avec un groupe de workers.
- Limitez le débit sous votre plafond, en gardant de la marge pour les réponses.
- Enregistrez chaque message avant l'envoi pour qu'une nouvelle tentative ne crée jamais de doublon.
- Ne réessayez que les erreurs de limitation et les erreurs serveur transitoires, avec un backoff exponentiel et du jitter, en plafonnant le délai et le nombre de tentatives.