---
title: "Template JSON e anteprima per WhatsApp Flows"
description: "Esempi JSON gratuiti di WhatsApp Flows in sei lingue, inclusi inglese e arabo: moduli lead, prenotazioni, sondaggi e opt-in. Anteprima, validazione e copia."
canonical: "https://omnichannels.ai/it/tools/whatsapp-flows-templates/"
language: "it"
updated: "2026-10-10"
publisher: "BroadNet Technologies"
brand: "OmniChannels.ai"
---

# Template JSON e anteprima per WhatsApp Flows

Canonical: https://omnichannels.ai/it/tools/whatsapp-flows-templates/
Language: it
Publisher: OmniChannels.ai by BroadNet Technologies

Un WhatsApp Flow è un insieme di schermate nella chat definite in Flow JSON. Il Flow valido più semplice ha una versione, come 7.3, e un array di screens. Ogni schermata ha un id fatto di lettere e trattini bassi, un SingleColumnLayout con componenti e un solo pulsante Footer. Le schermate avanzano con azioni navigate e l'ultima schermata è contrassegnata come terminal ed esegue complete, che invia le risposte al vostro webhook.

## Come usare un template WhatsApp Flow
1. **Scegliete un template:** Scegliete un caso d'uso come raccolta di lead, prenotazione di un tavolo o ticket di assistenza, poi passate da una versione linguistica all'altra.
2. **Guardate l'anteprima delle schermate:** Toccate il pulsante nell'anteprima del telefono per scorrere ogni schermata esattamente nell'ordine in cui la vedrà il cliente.
3. **Copiate o scaricate il JSON:** Incollate il JSON del Flow nell'editor dei Flow in WhatsApp Manager oppure caricatelo con la Flows API, poi pubblicatelo.
4. **Validate le vostre modifiche:** Incollate il JSON modificato nel validatore per individuare percorsi interrotti, campi mancanti ed etichette oltre i limiti di caratteri di Meta.

## Cosa contiene un file Flow JSON di WhatsApp

Il Flow JSON ha due proprietà obbligatorie: version e screens. Ogni schermata ha un id, un titolo facoltativo mostrato nella barra superiore e un layout di tipo SingleColumnLayout i cui figli sono componenti: testo, input, elenchi di selezione, selettori di data, opt-in e un pulsante Footer.
La navigazione è nelle azioni. Un Footer con navigate apre la schermata successiva; nell'ultima schermata, contrassegnata come terminal, un Footer con complete chiude il Flow e invia il payload alla vostra azienda con il flow token. Dal Flow JSON 4.0, qualsiasi schermata può leggere i campi di una schermata precedente con ${screen.SCREEN_ID.form.field}, quindi i template mantengono vuoti i payload di navigate e raccolgono ogni risposta nel payload finale di complete.
- version: la versione del Flow JSON, "7.3" in ogni template.
- screens: l'elenco ordinato delle schermate; la prima senza un percorso in entrata è la schermata di ingresso.
- routing_model e data_api_version: solo per i Flow che chiamano il vostro endpoint dati.
- terminal e success: contrassegnano l'ultima schermata e se concludere lì conta come successo.

## Flow con o senza endpoint dati

Tutti e dodici i template sono privi di endpoint. Funzionano senza un server: le opzioni sono scritte nel JSON, Meta genera il modello di instradamento e ricevete le risposte sul vostro webhook quando il cliente completa il Flow. Meta consiglia i Flow senza endpoint ogni volta che non servono dati in tempo reale, perché si aprono più in fretta e si costruiscono più rapidamente.
Aggiungete un endpoint dati quando la schermata dipende da dati in tempo reale: fasce di appuntamento disponibili, un prezzo che cambia, disponibilità di magazzino o una verifica sull'account del cliente. In tal caso le schermate usano data_exchange, il Flow richiede data_api_version e un routing_model, e il vostro endpoint deve decifrare ogni richiesta e rispondere entro il timeout di Meta. Questa è la parte che costruiamo e ospitiamo per i clienti.

## Limiti di caratteri e regole dei componenti da rispettare

La maggior parte dei Flow respinti fallisce su piccole regole. Le etichette sono brevi: 20 caratteri per un campo di testo, un'area di testo o un menu a discesa, 30 per un gruppo di pulsanti di opzione o caselle di controllo, 40 per un selettore di data e 35 per il pulsante Footer. I titoli delle opzioni sono limitati a 30 caratteri e le descrizioni a 300. Le intestazioni accettano 80 caratteri e il testo del corpo 4.096.
Per schermata potete usare fino a 50 componenti, un Footer, due link incorporati, tre immagini e cinque opt-in. Gli id delle schermate possono contenere solo lettere e trattini bassi, e SUCCESS è riservato. Le etichette arabe contano caratteri, non byte, quindi un'etichetta araba di 20 caratteri va bene. Il validatore controlla tutto questo e indica la schermata da correggere.

## Flow in arabo e RTL per i clienti del GCC

Ogni template ha una versione araba nativa con le stesse schermate e gli stessi nomi di campo, così il codice del vostro webhook gestisce entrambe le lingue senza modifiche. WhatsApp impagina i Flow arabi da destra a sinistra sul telefono del cliente; l'anteprima mostra la stessa direzione.
La libreria include casi d'uso importanti nel Golfo: iscrizioni alle offerte di Ramadan ed Eid con un orario del messaggio dopo l'iftar, prenotazione di un tavolo al ristorante, richieste di visita immobiliare e una checklist di documenti KYC che chiede ai clienti di non inviare foto dei documenti d'identità nella chat.

## Come inviare un Flow ai clienti

Dopo aver pubblicato un Flow, inviatelo come messaggio interattivo di tipo flow con il suo Flow ID, un flow token da voi generato, un breve testo del pulsante e la prima schermata. La libreria vi fornisce il payload del messaggio per ogni template. I messaggi interattivi funzionano solo entro la finestra di assistenza clienti di 24 ore; per raggiungere i clienti per primi, collegate il Flow a un modello di messaggio (template) approvato con un pulsante Flow.
Quando il cliente finisce, WhatsApp gli mostra un riepilogo delle sue risposte e voi ricevete il payload completo sul vostro webhook. Rispondete con un messaggio di conferma che dica cosa succede dopo e come modificare o annullare.

## Flow JSON di WhatsApp: domande frequenti

### Quale versione del Flow JSON devo usare?

Usate la 7.3, la versione che Meta consigliava per pubblicare nuovi Flow quando abbiamo controllato il suo changelog. Le versioni più vecchie come la 5.0 sono congelate: i Flow su di esse possono ancora essere inviati ma non pubblicati.

### Mi serve un server o un endpoint dati per questi template?

No. Tutti i template sono privi di endpoint. Le opzioni sono scritte nel JSON e le risposte arrivano al vostro webhook quando il cliente tocca il pulsante finale. L'endpoint serve solo per dati in tempo reale come fasce disponibili o prezzi.

### Come uso un template in WhatsApp Manager?

Create un Flow in WhatsApp Manager, aprite l'editor JSON, sostituite il suo contenuto con il template, controllate l'anteprima e pubblicate. Potete anche creare e pubblicare il Flow con la Flows API.

### Posso modificare etichette e opzioni?

Sì. Cambiate qualsiasi testo, aggiungete o rimuovete opzioni e campi, poi incollate il JSON nel validatore. Vi avvisa quando un'etichetta supera il limite di caratteri o un percorso punta a una schermata che non esiste più.

### Perché il mio Flow non si pubblica?

Le cause comuni sono un'etichetta oltre il limite, un id di schermata con cifre o trattini, una schermata terminal senza Footer, l'azione complete su una schermata non terminal e data_exchange senza data_api_version e un modello di instradamento.

### I template in arabo sono da destra a sinistra?

Sì. Sono scritti in arabo e WhatsApp li mostra da destra a sinistra. Nomi dei campi e id delle opzioni restano in inglese, quindi lo stesso codice del webhook funziona per entrambe le lingue.

### Un Flow può raccogliere documenti d'identità?

I Flow hanno componenti per la scelta di foto e documenti, ma i caricamenti sensibili richiedono una gestione attenta. Il template KYC si limita a verificare quali documenti ha il cliente e a prenotare un invio sicuro, il che tiene le immagini dei documenti fuori dalla chat.

### Questo validatore è lo stesso di Meta?

No. Esegue controlli statici di base modellati sugli errori documentati da Meta. Il validatore di Meta in WhatsApp Manager controlla anche espressioni e modelli di dati, quindi pubblicate solo dopo che non segnala errori.