> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.

# WhatsApp Flows: schermate, stati e regole

> Cosa sono i WhatsApp Flows, Flows statici e con endpoint, gli stati di un Flow, cosa richiede Meta prima della pubblicazione e come li crea Flowella.

Un WhatsApp Flow è un modulo o una breve app che si apre all'interno di una chat WhatsApp. Il cliente tocca un pulsante, compare una schermata con domande, menu a tendina, selettori di data o caselle di consenso, e le sue risposte vi arrivano quando le invia. I Flows sono definiti in **Flow JSON**, pubblicati su Meta e inviati tramite il pulsante di un template o un messaggio interattivo.

> [!NOTE]
>
> **In Flowella.** Supportato. Flowella crea i Flows dai vostri moduli HubSpot, o da zero nel [Flow designer](https://knowledge.flowella.io/it/app/flow-designer.md), e li pubblica per voi, quindi non dovete mai scrivere Flow JSON. Flowella invia i Flows tramite il pulsante Flow di un template e registra ogni invio. Consultate [Flows](https://knowledge.flowella.io/it/app/flows.md).

## Gli elementi di base

| Termine | Cosa significa |
| - | - |
| **Flow** | Un'attività che il cliente completa, come "Prenota una visita" o "Richiedi un preventivo" |
| **Schermata** | Una pagina del Flow, con i propri componenti e un pulsante in basso |
| **Componente** | Un elemento di una schermata: testo, un campo di inserimento, un elenco, un selettore di data, un opt-in, un'immagine |
| **Flow JSON** | La definizione delle schermate e dei componenti, con un numero di versione. Consultate [Versioni di Flow JSON](https://knowledge.flowella.io/it/whatsapp/flows/flow-json-versions.md). |
| **Endpoint** | Un server facoltativo che il Flow chiama per caricare dati o verificare risposte mentre il cliente lo compila |
| **Flow token** | Un identificativo che l'azienda imposta quando invia il Flow, restituito con le risposte per associarle alla persona giusta |

## Flows statici e con endpoint

| | Flow statico | Flow con endpoint |
| - | - | - |
| Come funziona | Tutto è nel Flow JSON. Le risposte arrivano quando il cliente ha finito. | Durante l'esecuzione il Flow chiama il vostro server, ad esempio per verificare le risposte o caricare opzioni. |
| Monitoraggio della salute | Nessuno | Meta monitora il server e può limitare o bloccare il Flow. Consultate [Salute dei Flow](https://knowledge.flowella.io/it/whatsapp/flows/flow-health.md). |
| Configurazione | Nient'altro oltre alla pubblicazione | Una chiave di cifratura sul numero di telefono e un server che risponde agli health check. Consultate [Endpoint e sicurezza dei Flow](https://knowledge.flowella.io/it/whatsapp/flows/flow-endpoints-and-security.md). |

> [!NOTE]
>
> **In Flowella.** I Flows creati da moduli HubSpot sono Flows con endpoint: Flowella ospita l'endpoint, che verifica ogni invio rispetto al modulo HubSpot attivo prima che il cliente veda la schermata di ringraziamento. I Flows del Flow designer e della Flowella API sono statici.

## Cosa richiede Meta

Chiunque può creare un Flow, ma per pubblicarlo e inviarlo Meta richiede:

* Un'[azienda verificata](https://knowledge.flowella.io/it/whatsapp/accounts/business-verification.md).
* Un numero di telefono registrato sul WhatsApp Business Account.
* Una buona valutazione della qualità dei messaggi. Consultate [Valutazione della qualità](https://knowledge.flowella.io/it/whatsapp/limits/quality-score.md).
* Un Flow JSON valido in una versione non congelata né scaduta.
* Per i Flows con endpoint, una chiave di cifratura firmata sul numero e un endpoint in salute.

In Flowella, un requisito mancante compare durante la sincronizzazione come badge, ad esempio **Verification required** o **Registration required**. Consultate [Errori di sincronizzazione](https://knowledge.flowella.io/it/app/flows.md#sync-errors).

## Gli stati di un Flow

| Stato | Impostato da | Cosa significa |
| - | - | - |
| **Draft** | Voi | In costruzione. Si può inviare solo per test e mostra un banner di bozza. È l'unico stato in cui un Flow si può eliminare. |
| **Published** | Voi | Attivo. Si può inviare a chiunque. |
| **Throttled** | WhatsApp | L'endpoint o la navigazione tra le schermate non sono in salute. I clienti possono ancora aprirlo, ma potete inviarlo solo 10 volte all'ora. |
| **Blocked** | WhatsApp | La salute è peggiorata. Non potete inviarlo e i clienti non possono aprire i Flows già ricevuti. |
| **Deprecated** | Voi | Ritirato definitivamente. Non si può inviare, ma i clienti che lo hanno già ricevuto potrebbero ancora inviarlo. |

Throttled e Blocked riguardano solo i Flows con endpoint. WhatsApp riporta un Flow a Throttled, poi a Published, quando la salute si ristabilisce.

> [!NOTE]
>
> **In Flowella.** Una sincronizzazione pubblica subito, senza passare per la bozza. Flowella si rifiuta di inviare un template il cui Flow è deprecated. Per i Flows che gestite tramite la Flowella API, `GET /v1/flows/{id}` aggiorna lo stato da Meta e il webhook `flow.status_updated` segnala le modifiche. Consultate [Webhook](https://knowledge.flowella.io/it/api-reference/webhooks.md).

## Come un Flow arriva al cliente

| Canale | Quando potete usarlo |
| - | - |
| **Template con un pulsante Flow** | In qualsiasi momento, una volta approvato il template. È così che avviate una conversazione con un Flow. |
| **Messaggio Flow interattivo** | Solo mentre la [finestra di 24 ore](https://knowledge.flowella.io/it/whatsapp/messaging/customer-service-window.md) del cliente è aperta |

Consultate [Inviare i Flows](https://knowledge.flowella.io/it/whatsapp/flows/sending-flows.md).

## Dove funzionano i Flows

I Flows si aprono su Android 6.0 e versioni successive e su iOS 12 e versioni successive. Meta ha aggiunto WhatsApp Web e Desktop da dicembre 2025. Consultate [Dispositivi supportati dai Flows](https://knowledge.flowella.io/it/whatsapp/flows/flows-client-support.md).

## Correlati

> [card] [I Flows in Flowella](https://knowledge.flowella.io/it/app/flows.md)
>
> Trasformate un modulo HubSpot in un Flow.

> [card] [Flow designer](https://knowledge.flowella.io/it/app/flow-designer.md)
>
> Create un Flow senza HubSpot.

> [card] [Componenti e limiti dei Flow](https://knowledge.flowella.io/it/whatsapp/flows/flow-components-and-limits.md)
>
> Cosa può contenere una schermata.

> [card] [Codici di errore dei Flows](https://knowledge.flowella.io/it/whatsapp/errors/flows-error-codes.md)
>
> Errori di pubblicazione e di invio.

Verificato rispetto alla documentazione di Meta il 18 novembre 2026: [WhatsApp Flows overview](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/guides), [Lifecycle of a Flow](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/guides/lifecycle) e [Sending a Flow](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/guides/sendingaflow).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.