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

# Componenti dei WhatsApp Flow e limiti di caratteri

> Ogni componente dei WhatsApp Flow con i limiti di Meta: componenti per schermata, lunghezza di testi ed etichette, opzioni, immagini, opt-in e file.

Ogni schermata di un WhatsApp Flow è composta da componenti: testo, campi di inserimento, elenchi, selettori, opt-in, immagini e un pulsante a piè di pagina. Meta limita quanti componenti può contenere una schermata e quanto possono essere lunghe etichette e opzioni. Quando un Flow supera un limite, Meta ne rifiuta la pubblicazione. Quando un testo è lungo ma entro i limiti, WhatsApp può troncarlo sui telefoni più piccoli.

> [!NOTE]
>
> **In Flowella.** Supportato in parte. Flowella crea i Flows a partire da un sottoinsieme di questi componenti e controlla i limiti principali prima della pubblicazione. I campi dei moduli HubSpot vengono associati al componente più vicino. Consultate [Come vengono convertiti i campi HubSpot](https://knowledge.flowella.io/it/app/flows.md#how-hubspot-fields-convert) e il [Flow designer](https://knowledge.flowella.io/it/app/flow-designer.md). Flowella non usa elenchi di navigazione, selettori a chip, selettori di calendario o caroselli di immagini.

## Limiti per schermata

| Limite | Massimo |
| - | - |
| Componenti | 50 |
| Footer (il pulsante in basso) | 1 |
| Opt-in | 5 |
| Link incorporati | 2 |
| Immagini | 3 |
| Selettori di foto o di documenti | 1 |

> [!NOTE]
>
> **In Flowella.** Le caselle di consenso di un modulo HubSpot diventano opt-in, quindi contano ai fini dei 5. Se un modulo HubSpot richiedesse più di 50 componenti, Flowella elimina i blocchi di rich text e mantiene tutte le domande.

## Testo

| Componente | Limite |
| - | - |
| Heading | 80 caratteri |
| Subheading | 80 caratteri |
| Body | 4.096 caratteri |
| Caption | 409 caratteri |
| Rich text | Per contenuti lunghi come i termini. Da Flow JSON 6.3 può condividere una schermata con il footer. |

Il testo non può essere vuoto o composto solo da spazi. I testi Body e Caption supportano grassetto, corsivo, barrato, link ed elenchi semplici.

## Campi di inserimento

| Componente | Limiti |
| - | - |
| **Text input** (riga singola) | Etichetta 20 caratteri, testo di aiuto 80, testo di errore 30. Risposte fino a 80 caratteri per impostazione predefinita. Tipi: text, number, email, password, passcode, phone. |
| **Text area** (più righe) | Etichetta 20 caratteri, testo di aiuto 80. Risposte fino a 600 caratteri per impostazione predefinita. |
| **Date picker** | Etichetta 40 caratteri, testo di aiuto e di errore 80. Da Flow JSON 5.0, le date vengono scambiate come `YYYY-MM-DD`, indipendentemente dal fuso orario. |
| **Calendar picker** | Data singola o intervallo. Titolo 80 caratteri, descrizione 300, etichetta 40. |

## Scelte

| Componente | Opzioni | Limiti di testo |
| - | - | - |
| **Radio button** (una sola scelta) | Da 1 a 20 | Etichetta e titolo dell'opzione 30 caratteri, descrizione 300 |
| **Checkbox** (più scelte) | Da 1 a 20 | Etichetta e titolo dell'opzione 30 caratteri, descrizione 300 |
| **Dropdown** | Da 1 a 200, o 100 se le opzioni hanno immagini | Etichetta 20 caratteri, titolo dell'opzione 30, descrizione 300 |
| **Opt-in** | Una casella | 120 caratteri, con un link **Read more** facoltativo |

Da Flow JSON 6.0 le immagini delle opzioni devono essere di 100 KB o meno. Le immagini WebP non vengono mostrate nelle versioni di iOS precedenti alla 14.

## Pulsanti e link

| Componente | Limiti |
| - | - |
| **Footer** | Etichetta 35 caratteri, didascalie 15 caratteri. Uno per schermata. |
| **Embedded link** | 25 caratteri, 2 per schermata |

## Immagini e file

| Componente | Limiti |
| - | - |
| **Image** | JPEG o PNG, idealmente sotto i 300 KB, 3 per schermata |
| **Photo picker** e **document picker** | Permettono al cliente di allegare immagini o documenti. Fino a 10 file in una risposta, 100 MB in totale. |

> [!WARNING]
>
> Flowella salva in HubSpot le foto caricate dai clienti come file pubblici. Non chiedete documenti d'identità o altre immagini sensibili. Consultate [Limiti e insidie](https://knowledge.flowella.io/it/app/flows.md#limits-and-gotchas).

## Logica

I componenti **If** e **Switch** mostrano o nascondono parti di una schermata in base alle risposte precedenti, senza chiamare un endpoint. Potete annidare fino a tre componenti **If**. Un footer dentro un **If** deve comparire in entrambi i rami. In Flowella, impostate le condizioni nella [scheda Logic](https://knowledge.flowella.io/it/app/flow-designer.md#logic-tab) del designer.

## Flows facili da leggere

I limiti sono massimi, non obiettivi. WhatsApp accorcia etichette e titoli delle opzioni lunghi per adattarli allo schermo, quindi un'etichetta che sta su un telefono grande può essere troncata su uno piccolo. Per regole pratiche, consultate [Buone pratiche per la progettazione dei moduli](https://knowledge.flowella.io/it/app/form-design-best-practices.md).

## Correlati

> [card] [Buone pratiche per i moduli](https://knowledge.flowella.io/it/app/form-design-best-practices.md)
>
> Etichette e domande che rientrano nei limiti.

> [card] [Codici di errore dei Flows](https://knowledge.flowella.io/it/whatsapp/errors/flows-error-codes.md)
>
> Cosa succede quando si supera un limite.

> [card] [Versioni di Flow JSON](https://knowledge.flowella.io/it/whatsapp/flows/flow-json-versions.md)
>
> Quale versione ha introdotto cosa.

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

Verificato rispetto alla documentazione di Meta il 18 novembre 2026: [Components](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/guides/components), [Media upload components](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/guides/media_upload) e [Best practices](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/guides/bestpractices).


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