Strumento gratuito

Template JSON e anteprima per WhatsApp Flows

Dodici template WhatsApp Flow pronti da copiare in inglese, arabo, francese, spagnolo, tedesco e portoghese, dalla raccolta di lead e dalla prenotazione di appuntamenti ai sondaggi NPS, alle checklist KYC e alle iscrizioni alle offerte del Ramadan. Vedete l'anteprima di ogni schermata in una cornice di telefono, copiate o scaricate il JSON del Flow e verificate il vostro JSON rispetto alle regole documentate da Meta.

Gratis · senza registrazione · funziona nel vostro browser

Mostra i modelli per

JSON del Flow (versione 7.3)

{
  "version": "7.3",
  "screens": [
    {
      "id": "CONTACT",
      "title": "Your details",
      "layout": {
        "type": "SingleColumnLayout",
        "children": [
          {
            "type": "TextHeading",
            "text": "Tell us about you"
          },
          {
            "type": "TextBody",
            "text": "It takes less than a minute. We only use these details to reply to your request."
          },
          {
            "type": "TextInput",
            "name": "full_name",
            "label": "Full name",
            "input-type": "text",
            "required": true
          },
          {
            "type": "TextInput",
            "name": "company",
            "label": "Company",
            "input-type": "text",
            "required": false
          },
          {
            "type": "TextInput",
            "name": "email",
            "label": "Email",
            "input-type": "email",
            "required": true
          },
          {
            "type": "TextInput",
            "name": "phone",
            "label": "Mobile number",
            "input-type": "phone",
            "required": true,
            "helper-text": "Include the country code, for example +971"
          },
          {
            "type": "Footer",
            "label": "Continue",
            "on-click-action": {
              "name": "navigate",
              "next": {
                "type": "screen",
                "name": "NEEDS"
              },
              "payload": {}
            }
          }
        ]
      }
    },
    {
      "id": "NEEDS",
      "title": "Your request",
      "terminal": true,
      "success": true,
      "layout": {
        "type": "SingleColumnLayout",
        "children": [
          {
            "type": "RadioButtonsGroup",
            "name": "interest",
            "label": "What are you interested in?",
            "required": true,
            "data-source": [
              {
                "id": "demo",
                "title": "A product demo"
              },
              {
                "id": "pricing",
                "title": "Pricing"
              },
              {
                "id": "partnership",
                "title": "Partnership"
              },
              {
                "id": "other",
                "title": "Something else"
              }
            ]
          },
          {
            "type": "Dropdown",
            "name": "timeline",
            "label": "When do you start?",
            "required": true,
            "data-source": [
              {
                "id": "now",
                "title": "Right away"
              },
              {
                "id": "one_three",
                "title": "In 1 to 3 months"
              },
              {
                "id": "later",
                "title": "Later this year"
              },
              {
                "id": "exploring",
                "title": "Just exploring"
              }
            ]
          },
          {
            "type": "RadioButtonsGroup",
            "name": "call_time",
            "label": "Best time to call",
            "required": false,
            "data-source": [
              {
                "id": "morning",
                "title": "Morning"
              },
              {
                "id": "afternoon",
                "title": "Afternoon"
              },
              {
                "id": "evening",
                "title": "Evening"
              }
            ]
          },
          {
            "type": "TextArea",
            "name": "message",
            "label": "Message",
            "required": false,
            "helper-text": "Anything we should know before we call"
          },
          {
            "type": "OptIn",
            "name": "marketing_opt_in",
            "label": "Send me product news and offers on WhatsApp. I can reply STOP at any time.",
            "required": false
          },
          {
            "type": "Footer",
            "label": "Send request",
            "on-click-action": {
              "name": "complete",
              "payload": {
                "full_name": "${screen.CONTACT.form.full_name}",
                "company": "${screen.CONTACT.form.company}",
                "email": "${screen.CONTACT.form.email}",
                "phone": "${screen.CONTACT.form.phone}",
                "interest": "${form.interest}",
                "timeline": "${form.timeline}",
                "call_time": "${form.call_time}",
                "message": "${form.message}",
                "marketing_opt_in": "${form.marketing_opt_in}"
              }
            }
          }
        ]
      }
    }
  ]
}

Incollatelo nell’editor dei Flow in WhatsApp Manager oppure caricatelo con la Flows API. Sostituite l’URL di esempio dell’informativa sulla privacy con il vostro. Questi modelli funzionano senza un endpoint dati, quindi non richiedono data_api_version né routing_model.

Messaggio che apre il Flow (Cloud API)

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "<CUSTOMER_PHONE_NUMBER>",
  "type": "interactive",
  "interactive": {
    "type": "flow",
    "header": {
      "type": "text",
      "text": "Talk to our team"
    },
    "body": {
      "text": "Share a few details and the right person will contact you within one business day."
    },
    "action": {
      "name": "flow",
      "parameters": {
        "flow_message_version": "3",
        "flow_token": "<UNIQUE_FLOW_TOKEN>",
        "flow_id": "<FLOW_ID>",
        "flow_cta": "Get in touch",
        "flow_action": "navigate",
        "flow_action_payload": {
          "screen": "CONTACT"
        }
      }
    }
  }
}

Un messaggio interattivo può essere inviato solo entro la finestra di assistenza clienti di 24 ore. Per avviare voi la conversazione, collegate il Flow a un template di messaggio approvato con un pulsante Flow.

Le regole di WhatsApp Flows che questi modelli rispettano

Il JSON dei Flow 7.3 è la versione che Meta consiglia per pubblicare nuovi Flow.
Un Flow senza endpoint dati richiede solo version e screens; Meta genera il modello di instradamento.
Ogni Flow termina con una schermata terminale con un Footer che esegue l’azione complete.
Limiti per schermata: 50 componenti, 1 Footer, 2 link incorporati, 3 immagini e 5 consensi (opt-in).
Le etichette sono brevi: 20 caratteri per i campi di testo e i menu a tendina, 30 per i gruppi di pulsanti di opzione e caselle di controllo, 35 per il pulsante del Footer.
Gli id delle schermate usano solo lettere e trattini bassi e SUCCESS è riservato.

Regole verificate sulla documentazione di Meta su WhatsApp Flows il 2026-10-10.

Realizziamo e ospitiamo i Flow con il vostro endpoint dati

Vi servono slot, prezzi o dati degli account in tempo reale in un Flow? Il nostro team progetta le schermate, realizza e ospita l’endpoint dati cifrato e collega le risposte al vostro CRM. Contattate il team commerciale per un preventivo su misura.

Nulla di ciò che scrivete qui viene inviato ai nostri server.

Risposta breve

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.

Infrastruttura affidabileMeta Business Solution Provider ufficiale Partner Google RBM Membro GSMA ISO/IEC 27001:2022 ISO/IEC 27018 ISO 9001:2015 ISO 22301 SOC 2 Type II Conforme al GDPR

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.