# Errore WhatsApp 132069: Flow limitato — causa e soluzione

URL: https://wa.genuka.com/it/docs/errors/132069
Language: Italian

> 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](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes#other-errors)

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](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/guides/healthmonitoring)).

| 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?

1. **Leggi le allerte che hai ricevuto** per questo Flow: indicano quale delle tre metriche è peggiorata.
2. **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.
3. **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](https://wa.genuka.com/sdk/flows).
4. **Per un'allerta sul tasso di errore**, esamina gli errori elencati nell'allerta con il riferimento dei codici
   di errore dei Flow di Meta.
5. **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**

```bash
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": [] }
```

**Node.js**

```ts
/** Only send a Flow when it is published; otherwise use another path. */
export async function flowIsSendable(flowId: string): Promise<boolean> {
  const response = await fetch(`https://wa.genuka.com/api/v1/flows/${flowId}`, {
    headers: { Authorization: `Bearer ${process.env.GENUKA_WA_API_KEY}` },
  });
  const { data } = await response.json();
  // "throttled": 10 sends per hour at most. "blocked": none.
  return data.status === "published";
}
```

## 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_changed`** per 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](https://wa.genuka.com/it/docs/errors/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](https://wa.genuka.com/it/docs/errors/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

* [Meta — Error codes](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes)
* [Meta — Flow health and monitoring](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/guides/healthmonitoring)
