Errore WhatsApp 132069: Flow limitato — causa e soluzione
Errore WhatsApp 132069: il Flow è limitato a 10 invii all'ora perché il suo endpoint non è in buona salute. Come sistemare l'endpoint e tornare a Published.
L'errore WhatsApp 132069 significa che il tuo Flow è nello stato "throttled": WhatsApp ha rilevato che il suo endpoint non è in buona salute, per latenza, errori o indisponibilità, e limita l'invio a 10 messaggi all'ora. La causa è sul tuo server. Sistema l'endpoint; il Flow torna pubblicato da solo appena le metriche si riprendono.
Cosa significa l'errore 132069?
"Flow is in throttled state and 10 messages using this flow were already sent in the last hour." — Meta, Cloud API error codes
Il codice vicino descrive la fase successiva:
"Flow is in blocked state." — Meta, codice 132068
Per entrambi, l'istruzione di Meta è la stessa: correggi il Flow. Questi stati si applicano solo ai Flow che chiamano il tuo endpoint per i loro dati (Meta, Flow health and monitoring).
| Stato del Flow | Restrizione | Effetto per gli utenti |
|---|---|---|
| Published | Nessuna | Nessuno |
| Throttled (132069) | 10 nuovi messaggi Flow all'ora | I Flow già ricevuti si aprono e funzionano ancora |
| Blocked (132068) | Nessun invio | I Flow già inviati non si aprono più |
Quando si verifica l'errore 132069?
WhatsApp monitora tre metriche dell'endpoint di un Flow: il tasso di errore (lato endpoint o lato client), la latenza e la disponibilità. Quando una di queste peggiora in modo significativo, il Flow passa prima a Throttled, poi a Blocked se la situazione peggiora. Meta invia diversi webhook di allerta prima di arrivarci.
Cause tipiche:
- un endpoint che impiega diversi secondi a rispondere, perché interroga un database o un'API lenti;
- un endpoint che non risponde alle richieste di health check;
- un deploy che rompe la decifratura o restituisce errori a raffica;
- un server non raggiungibile da internet.
Dove lo vedi in Genuka WA?
| Canale | Cosa ottieni |
|---|---|
Risposta di POST /api/v1/messages | 400, "error": "send_template", meta.code: 132069 (o 132068) |
GET /api/v1/flows/{id} | data.status letto da Meta a ogni chiamata: published, throttled o blocked, con validationErrors |
Webhook flow.status_changed | Gli eventi del campo flows inviati da Meta, inoltrati al tuo endpoint |
Genuka WA classifica i codici 132xxx come template: inviare di nuovo lo stesso messaggio non cambia nulla
finché l'endpoint non è sistemato.
Come risolvo l'errore 132069?
Leggi le allerte che hai ricevuto per questo Flow: indicano quale delle tre metriche è peggiorata.
Per un'allerta di latenza, velocizza l'endpoint. Meta consiglia di rispondere in meno di un secondo: cache, precaricamento, chiamate lente spostate fuori dal percorso della richiesta.
Per un'allerta di disponibilità, verifica che l'endpoint sia sempre raggiungibile da internet
e che risponda alle richieste di health check. L'handler createFlowEndpoint della libreria risponde
automaticamente: vedi i Flow nella libreria.
Per un'allerta sul tasso di errore, esamina gli errori elencati nell'allerta con il riferimento dei codici di errore dei Flow di Meta.
Aspetta il ripristino automatico. WhatsApp rileva la correzione e sposta il Flow da Blocked a
Throttled, poi da Throttled a Published. Seguilo con 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": "book_appointment", "status": "throttled", ... }, "validationErrors": [] }Come prevengo l'errore 132069?
- Misura la latenza del tuo endpoint sotto carico reale, non solo in sviluppo.
- Monitora l'endpoint come un servizio di produzione: disponibilità, tasso di errore, tempo di risposta, con un'allerta che scatta prima che reagisca WhatsApp.
- Ricevi gli eventi
flow.status_changedper sapere quando un Flow cambia stato senza aspettare che un invio fallisca. - Prevedi un percorso alternativo (link web, conversazione normale) per quando il Flow non è
published.
Codici di errore correlati
- 131047: un Flow inviato come messaggio interattivo fuori dalla finestra di 24 ore viene rifiutato; ti serve allora un modello con un pulsante Flow.
- 132001: il modello che contiene il pulsante Flow non si trova in quella lingua, oppure non è approvato.
FAQ
I miei utenti possono ancora compilare un Flow limitato?
Sì. Nello stato Throttled, i Flow già ricevuti si aprono e funzionano; solo l'invio di nuovi messaggi è limitato a 10 all'ora. Nello stato Blocked, invece, anche i Flow già inviati non si aprono più.
I Flow senza endpoint sono coinvolti?
No. Meta precisa che il monitoraggio dello stato di salute si applica solo ai Flow che usano dati dal tuo endpoint.
Devo ripubblicare il Flow dopo averlo sistemato?
No. WhatsApp rileva automaticamente che l'endpoint si è ripreso e fa risalire il Flow, da Blocked a Throttled e poi a Published.
Fonti
Errore WhatsApp 132015: modello in pausa — causa e soluzione
Errore WhatsApp 132015: Meta ha messo in pausa il modello per bassa qualità. Quanto durano le pause (3 h, 6 h, poi disattivazione con 132016) e come riprendere in sicurezza.
Confronti tra API WhatsApp: Twilio, 360dialog, WATI
Genuka WA a confronto con Twilio, 360dialog, WATI e le API WhatsApp non ufficiali: modello di prezzo, tariffe Meta, coesistenza, webhook e rischi, fianco a fianco.