> ## 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.

# Versioni di Flow JSON di WhatsApp: congelamento e scadenza

> Come WhatsApp gestisce le versioni di Flow JSON, Data API e messaggi Flow, cosa comportano frozen ed expired per i Flows attivi e cosa usa Flowella.

Ogni WhatsApp Flow dichiara la versione di Flow JSON in cui è scritto, e i Flows con endpoint dichiarano anche una versione della Data API. Meta aggiunge funzionalità nelle nuove versioni e ritira quelle vecchie in due fasi: una versione **frozen** (congelata) non si può più pubblicare, e una versione **expired** (scaduta) non si può più inviare né aprire. Mantenere i Flows su una versione supportata è ciò che li fa continuare a funzionare.

> [!NOTE]
>
> **In Flowella.** Supportato. Flowella scrive ogni Flow in Flow JSON **7.3**, la versione più recente, e i Flows basati su moduli HubSpot usano la Data API **3.0**. Flowella non sposta da sola i Flows pubblicati a una nuova versione: un Flow usa la versione che Flowella scrive alla successiva sincronizzazione o pubblicazione.

## Le tre versioni

| Versione | Formato | Cosa controlla |
| - | - | - |
| **Flow JSON** | `major.minor`, ad esempio `7.3` | Quali componenti e proprietà può usare il Flow e come si comportano |
| **Data API** | `major.minor`, ad esempio `3.0` | Come un Flow con endpoint cifra e formatta le sue richieste. Solo Flows con endpoint. |
| **Message** | Un numero intero, attualmente `3` | Il formato di un messaggio Flow interattivo |

Una modifica del primo numero è una modifica incompatibile, quindi un Flow potrebbe richiedere interventi per passarvi. Una modifica del secondo numero aggiunge funzionalità senza rompere nulla. Dopo `1.9` viene `1.10`, non `2.0`.

## Frozen ed expired

| Stato | Pubblicazione | Invio e apertura |
| - | - | - |
| **Supported** | Consentita | Consentiti |
| **Frozen** | Rifiutata. Non potete creare o aggiornare un Flow in questa versione. | Ancora consentiti |
| **Expired** | Rifiutata | Rifiutati. I clienti non possono aprire i Flows in questa versione, nemmeno quelli già ricevuti. |

Meta di solito dà circa 90 giorni di preavviso prima che una versione venga congelata o scada, e annuncia le date nel changelog dei Flows. Per motivi di sicurezza può agire più rapidamente e può saltare del tutto la fase di congelamento.

## A che punto sono le versioni

| Versione | Rilascio | Stato nel changelog di Meta |
| - | - | - |
| 7.3 | Settembre 2025 | Più recente, non congelata |
| 7.2, 7.1, 7.0 | Da marzo a luglio 2025 | Non congelate |
| Da 6.0 a 6.3 | Da novembre 2024 a gennaio 2025 | Non congelate |
| 5.1 | Settembre 2024 | Non congelata |
| 5.0 | Agosto 2024 | Congelata dal 10 settembre 2025 |
| 4.0, 3.1, 3.0, 2.1 | Dal 2023 al 2024 | Congelate dall'8 aprile 2025 |

Il changelog dei Flows di Meta è stato aggiornato l'ultima volta l'11 novembre 2025. Consultatelo prima di pianificare una migrazione.

La Data API **4.0**, rilasciata a novembre 2025, aggiunge una firma facoltativa che dimostra che ogni richiesta all'endpoint proviene da qualcuno che ha ricevuto il messaggio Flow. La Data API 3.0 resta supportata.

## Modifiche incompatibili da conoscere

| Passando a | Cosa è cambiato |
| - | - |
| 4.0 | I gruppi di checkbox e radio button richiedono un'etichetta. I nomi dei campi non possono essere vuoti. |
| 5.0 | I date picker scambiano le date come `YYYY-MM-DD`, indipendentemente dal fuso orario |
| 6.0 | I valori di testo non possono essere vuoti o composti solo da spazi. Le immagini delle opzioni devono essere di 100 KB o meno. |
| 7.0 | La selezione di un'opzione non riesegue più la sua azione quando una schermata si riapre |

## Cosa fare quando Meta annuncia un congelamento

* **I Flows creati in Flowella** usano la versione che scrive Flowella. Quando Flowella passa a una versione più recente, sincronizzate o pubblicate di nuovo ogni Flow per aggiornarlo.
* **I Flows creati in WhatsApp Manager o con un altro strumento** vanno aggiornati lì prima che la versione scada. Meta mostra avvisi nel suo Flow builder e invia webhook di avviso sulle versioni.
* **Prima che una versione scada**, sostituite ogni template il cui Flow la usa ancora, altrimenti i clienti che toccano il pulsante non potranno aprire il Flow.

## Correlati

> [card] [Panoramica dei WhatsApp Flows](https://knowledge.flowella.io/it/whatsapp/flows/flows-overview.md)
>
> Come funzionano i Flows e i loro stati.

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

> [card] [Endpoint e sicurezza dei Flow](https://knowledge.flowella.io/it/whatsapp/flows/flow-endpoints-and-security.md)
>
> Le versioni della Data API in pratica.

> [card] [Modifiche alla piattaforma](https://knowledge.flowella.io/it/whatsapp/platform-changes.md)
>
> Le prossime modifiche di Meta che riguardano Flowella.

Verificato rispetto alla documentazione di Meta il 18 novembre 2026: [Versioning](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/guides/versioning) e il [WhatsApp Flows changelog](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/changelog).


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