Erreur WhatsApp 132069 : Flow limité (throttled)
Erreur WhatsApp 132069 : Flow en état throttled, limité à 10 envois par heure parce que son endpoint répond mal. Comment le réparer et revenir à Published.
L'erreur WhatsApp 132069 signifie que votre Flow est en état « throttled » : WhatsApp a détecté que son endpoint répond mal, par lenteur, erreurs ou indisponibilité, et limite son envoi à 10 messages par heure. La cause est côté serveur. Réparez l'endpoint ; le Flow redevient publié automatiquement une fois les métriques rétablies.
Que signifie l'erreur 132069 ?
« Flow is in throttled state and 10 messages using this flow were already sent in the last hour. » — Meta, codes d'erreur de la Cloud API
Son code voisin décrit l'étape suivante :
« Flow is in blocked state. » — Meta, code 132068
Pour les deux, la consigne de Meta est la même : corriger le Flow. Ces états ne concernent que les Flows qui appellent votre endpoint pour obtenir leurs données (Meta, Flow health and monitoring).
| État du Flow | Restriction | Effet pour les utilisateurs |
|---|---|---|
| Published | Aucune | Aucun |
| Throttled (132069) | 10 nouveaux messages Flow par heure | Les Flows déjà reçus s'ouvrent et fonctionnent toujours |
| Blocked (132068) | Plus aucun envoi | Les Flows déjà envoyés ne s'ouvrent plus |
Quand l'erreur 132069 apparaît-elle ?
WhatsApp surveille trois métriques de l'endpoint d'un Flow : le taux d'erreur (côté endpoint ou côté client), la latence et la disponibilité. Quand l'une se dégrade nettement, le Flow passe d'abord en Throttled, puis en Blocked si la dégradation continue. Meta envoie plusieurs alertes par webhook avant d'en arriver là.
Les causes typiques :
- un endpoint qui met plusieurs secondes à répondre, parce qu'il interroge une base ou une API lente ;
- un endpoint qui ne répond pas aux requêtes de contrôle de santé (health check) ;
- un déploiement qui casse le déchiffrement ou renvoie des erreurs en série ;
- un serveur injoignable depuis Internet.
Où la voir dans Genuka WA ?
| Canal | Ce que vous recevez |
|---|---|
Réponse de POST /api/v1/messages | 400, "error": "send_template", meta.code: 132069 (ou 132068) |
GET /api/v1/flows/{id} | data.status relu chez Meta à chaque appel : published, throttled ou blocked, avec validationErrors |
Webhook flow.status_changed | Les événements du champ flows que Meta envoie, transmis à votre endpoint |
Genuka WA classe les codes 132xxx en template : renvoyer le même message ne changera rien tant
que l'endpoint n'est pas réparé.
Comment corriger l'erreur 132069 ?
Lisez les alertes reçues pour ce Flow : elles indiquent laquelle des trois métriques s'est dégradée.
Pour une alerte de latence, accélérez l'endpoint. Meta recommande de répondre en moins d'une seconde : mettez en cache, préchargez, sortez les appels lents du chemin de la requête.
Pour une alerte de disponibilité, vérifiez que l'endpoint est joignable depuis Internet en
continu et qu'il répond aux requêtes de contrôle de santé. Le gestionnaire createFlowEndpoint de
la librairie y répond automatiquement : voir Flows dans la librairie.
Pour une alerte de taux d'erreur, reprenez les erreurs citées dans l'alerte avec la référence des codes d'erreur des Flows de Meta.
Attendez la reprise automatique. WhatsApp détecte la réparation et fait repasser le Flow de
Blocked à Throttled, puis de Throttled à Published. Suivez-le avec
GET /api/v1/flows/{id}.
curl https://wa.genuka.com/api/v1/flows/flw_1 \
-H "Authorization: Bearer $GENUKA_WA_API_KEY"
# { "data": { "id": "flw_1", "name": "prise_de_rendez_vous", "status": "throttled", ... }, "validationErrors": [] }Comment éviter l'erreur 132069 ?
- Mesurez la latence de votre endpoint sous charge réelle, pas seulement en développement.
- Surveillez l'endpoint comme un service de production : disponibilité, taux d'erreur, temps de réponse, avec une alerte avant que WhatsApp ne réagisse.
- Recevez les événements
flow.status_changedpour savoir qu'un Flow change d'état sans attendre l'échec d'un envoi. - Prévoyez un parcours de repli (lien web, conversation classique) pour les cas où le Flow
n'est pas
published.
Quels codes sont liés ?
- 131047 : un Flow envoyé comme message interactif hors de la fenêtre de 24 heures est refusé ; il faut alors un template avec un bouton Flow.
- 132001 : le template portant le bouton Flow est introuvable dans cette langue, ou pas approuvé.
FAQ
Mes utilisateurs peuvent-ils encore remplir un Flow limité ?
Oui. En état Throttled, les Flows déjà reçus s'ouvrent et fonctionnent ; seul l'envoi de nouveaux messages est limité à 10 par heure. En état Blocked, en revanche, même les Flows déjà envoyés ne s'ouvrent plus.
Les Flows sans endpoint sont-ils concernés ?
Non. Meta précise que la surveillance de santé ne s'applique qu'aux Flows qui utilisent les données de votre endpoint.
Faut-il republier le Flow après réparation ?
Non. WhatsApp détecte automatiquement que l'endpoint est rétabli et fait remonter l'état du Flow, de Blocked à Throttled puis à Published.