> ## 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. # Pagina Moduli: sincronizzate i form HubSpot ai WhatsApp Flows > Sfogliate i form HubSpot che Flowella traccia, controllate lo stato di sincronizzazione di ogni WhatsApp Flow con Meta e avviate una sincronizzazione dalla schermata Moduli in-app. Flowella forms synced from HubSpot La pagina Moduli mostra tutti i moduli HubSpot che Flowella sta tracciando per la vostra organizzazione, il WhatsApp Flow che Flowella ha costruito a partire da ciascuno di essi e se tale flusso è sincronizzato con Meta. Per sapere come impostare l'integrazione con HubSpot, vedere [HubSpot setup](/it/hubspot/setup). Questa pagina riguarda la schermata **Forms** in-app, non la configurazione dell'integrazione. ## Come aprirla Andare a **Forms** nella navigazione a sinistra, oppure: ```text theme={null} /{org}/forms ``` È anche possibile aprire i moduli con un canale specifico in `/{org}/{waba}/{phone}/forms`. L'elenco è lo stesso, ma lo scoping del canale viene utilizzato quando si sincronizza un flusso in Meta. ## Cosa mostra l'elenco Ogni riga rappresenta un modulo HubSpot. Le colonne includono: * **Nome modulo** e un ID modulo HubSpot troncato con un pulsante di copia con un solo clic. * **Conteggio campi** - quanti campi ha il modulo, con un flag se qualcuno non è supportato. * **Ultima modifica in HubSpot** - estratto da HubSpot, in modo da poter sapere quando è cambiata la definizione del modulo stesso. * **Catalogo aggiornato** - quando Flowella ha aggiornato l'ultima volta la definizione del modulo da HubSpot. * **Stato di WhatsApp Flow** - sincronizzato, in bozza o stantio (HubSpot è cambiato dall'ultima sincronizzazione). * **Create WhatsApp Flow / Sync WhatsApp Flow** - l'azione principale. L'etichetta passa a **Sync** quando il flusso esiste già e a **Stale - Sync needed** quando il modulo HubSpot è stato modificato dall'ultima sincronizzazione. Il pulsante è **pre-disabilitato** con un tooltip quando non può essere eseguito, ad esempio: HubSpot non connesso, nessun canale WhatsApp attivo, fatturazione inattiva o il modulo contiene tipi di campo non supportati. Il tooltip spiega esattamente quale prerequisito manca. Se l'account HubSpot non ha ancora moduli sincronizzati, Flowella **avvia il catalogo automaticamente** alla prima visita, quindi non è necessario attivare un pull iniziale. È possibile filtrare e cercare nell'elenco per trovare rapidamente un modulo specifico. ## Dettaglio modulo Fare clic su una riga per aprire la pagina dei dettagli. L'intestazione dei dettagli mostra la stessa **Creazione/Sincronizzazione WhatsApp Flow** azione primaria della riga dell'elenco, quindi non è necessario tornare indietro per apportare modifiche. Dalla pagina dei dettagli è possibile: * Rivedere la mappatura campo per campo tra il modulo HubSpot e WhatsApp Flow. * Vedere le precedenti **esecuzioni di sincronizzazione** - quando è stata avviata, lo stato (in coda, in esecuzione, riuscita, fallita) e gli eventuali errori restituiti da Meta. * Avviare una nuova sincronizzazione, **ritentare** un'esecuzione non riuscita o **annullare** una sincronizzazione ancora in corso. * Aprire il flusso corrispondente in Meta Business Suite. ## Sincronizzazione di un modulo in una WhatsApp Flow Quando si fa clic su **Crea WhatsApp Flow** o **Sincronizza WhatsApp Flow**, Flowella: 1. Esegue un **controllo preliminare** per verificare che HubSpot sia collegato, che il canale attivo sia verificato, che il modulo abbia almeno un campo supportato e che la fatturazione sia attiva. 2. Legge l'ultima definizione del modulo da HubSpot. 3. Genera il JSON equivalente di WhatsApp Flow. 4. Lo carica in Meta sul canale selezionato (channel-scoped). 5. Registra l'esecuzione della sincronizzazione nella pagina dei dettagli. La maggior parte delle sincronizzazioni richiede pochi secondi. Se Meta rifiuta il flusso, il motivo del fallimento appare nella riga dell'esecuzione come **messaggio di errore sicuro per l'utente** (tradotto dal grafico di Meta) - di solito a causa di un tipo di campo non supportato, di un problema di verifica sul canale o di una mancata corrispondenza di categoria. Riprovare dalla stessa riga una volta risolta la causa. ## Channel scope gating I moduli sono **a livello di organizzazione nell'elenco** ma **vincolati al canale quando si sincronizza** — un Flow deve essere caricato su una specifica combinazione di WABA + numero di telefono. | URL che si apre | Cosa accade | | ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `/{org}/forms` | Elenca tutti i moduli che Flowella sta tracciando. Se è connesso esattamente **un** canale WhatsApp, Flowella lo utilizza automaticamente durante la sincronizzazione. Con più di un canale, è necessario aprire Moduli in uno scope di canale prima di sincronizzare. | | `/{org}/{waba}/{phone}/forms` | Stesso elenco, ma le sincronizzazioni si rivolgono direttamente a questo canale. La pagina **attende che l'ID del canale nell'URL sia risolto** prima di eseguire le sue query HubSpot, in modo da non vedere uno scheletro che lampeggia con i risultati del canale sbagliato quando il canale memorizzato nella cache di sessione è obsoleto. | Se si fa clic su **Sync** dall'URL a livello di organizzazione e Flowella non riesce a decidere quale canale utilizzare (nessun canale connesso, più canali senza scope impostato o una sessione cross-org obsoleta), il pulsante rimane pre-disabilitato con un tooltip che spiega cosa manca. Passare al canale corretto dal [selettore di canali](/it/essentials/multi-channel#switching-channels), oppure aprire direttamente `/{org}/{waba}/{phone}/forms`. ## UX degli errori di sincronizzazione Quando una sincronizzazione fallisce, Flowella trasforma la riga dell'esecuzione in un singolo pulsante di azione con bordo, in modo da poter correggere in avanti dalla stessa riga: | Stato dell'esecuzione | Pulsante | Cosa fa | | ----------------------- | ----------- | --------------------------------------------------------------------------------------- | | Fallita | **Riprova** | Rimette in coda la stessa sincronizzazione del modulo. | | In coda / in esecuzione | **Annulla** | Best-effort: rimuove il job e contrassegna l'esecuzione come **`FLOW_SYNC_CANCELLED`**. | | Mai sincronizzata | **Crea** | Esegue la prima sincronizzazione per questo modulo. | La riga porta anche un **badge di errore sicuro per l'utente**: * **`FLOW_SYNC_PREFLIGHT` + errore Meta `#133010`** (telefono non registrato) — il badge mostra il messaggio Meta memorizzato e un suggerimento sulla **registrazione del telefono**, non un generico "non pronto". Completare la registrazione del telefono in **Impostazioni → Meta** e riprovare. * **`QUEUE_FAILED`** — la coda di sincronizzazione non è riuscita a prendere in carico il job. Di solito è transitorio; riprovare. Se persiste, la pagina di stato della piattaforma è il successivo punto da controllare (vedere [Stato e incidenti](/it/essentials/status-and-incidents)). * **Meta `validation_errors`** — il badge riassume quali campi sono stati rifiutati da Meta, in modo da poter adattare il modulo HubSpot (o la mappatura dei campi) e riprovare senza lasciare la riga. La cronologia delle esecuzioni viene conservata tra i tentativi, in modo da poter vedere quanti tentativi ha richiesto un modulo e cosa è cambiato tra di essi. ## Dati di esempio Se non si dispone ancora di una connessione HubSpot, la pagina dei moduli viene visualizzata con righe **illustrative** dietro un richiamo "Dati di esempio". Collegare HubSpot per passare ai moduli reali. I moduli HubSpot con tipi di campo non supportati (caricamento di file, firma) non possono essere sincronizzati così come sono. Adattare il modulo in HubSpot o saltare quei campi in WhatsApp Flow. ## Correlato Collega il portale Flowella per la lettura dei moduli. Attivare i flussi da un flusso di lavoro HubSpot. Ricette end-to-end che combinano moduli, modelli e flussi di lavoro. Diagnosticare i problemi di sincronizzazione dei moduli e gli invii mancanti. I moduli sono sincronizzati per canale: capire lo scope. Come vengono crittografati gli invii dei moduli in transito e a riposo.