> ## 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. # Inviate il vostro primo WhatsApp Flow da un modulo HubSpot > Trasformate un modulo HubSpot in un WhatsApp Flow, aggiungetelo a un modello, provatelo sul vostro telefono, poi inviatelo da un workflow HubSpot in modo che le risposte arrivino in HubSpot. In questo tutorial trasformate un modulo di marketing HubSpot in un WhatsApp Flow, lo inviate al vostro telefono, poi lo inviate da un workflow HubSpot. Alla fine, un Flow completato compare in HubSpot come invio del modulo originale. Richiede circa 50 minuti di lavoro effettivo, in base alle stime della guida di configurazione di Flowella, più fino a 24 ore di attesa mentre Meta esamina il vostro modello. ## Prima di cominciare * Leggete [Prima di iniziare](https://knowledge.flowella.io/it/before-you-start.md) e tenete pronti gli accessi a Meta e HubSpot. * La verifica aziendale di Meta deve essere completata prima di poter creare un Flow nella tappa 3. Consultate [Verifica aziendale](https://knowledge.flowella.io/it/meta/business-verification.md). * Tenete a portata di mano il vostro telefono con WhatsApp, su un numero personale e non sul numero aziendale che collegate. * Scegliete o create un breve modulo di marketing HubSpot per le prove. Includete un campo email: HubSpot usa l'indirizzo email per associare un invio del modulo a un contatto. * La tappa 6 richiede i workflow di HubSpot, inclusi nei piani Professional ed Enterprise di HubSpot. Senza di essi, vi fermate alla tappa 5. Se WhatsApp e HubSpot sono già collegati, passate direttamente alla tappa 3. ## Come si combinano gli elementi Il diagramma mostra l'ordine in cui un Flow viene creato, approvato, inviato e restituito a HubSpot. ```mermaid theme={null} sequenceDiagram actor M as Marketer participant HS as HubSpot participant F as Flowella participant WA as WhatsApp actor C as Cliente M->>HS: Crea il modulo di marketing HS-->>F: Il modulo compare nella pagina Flows M->>F: Create WA Flow F->>HS: Legge il modulo F->>WA: Crea o aggiorna il Flow, poi lo pubblica M->>F: Create template with this Flow F->>WA: Invia il modello per l'approvazione HS->>F: Il workflow esegue Send WhatsApp Template F->>C: Messaggio modello con pulsante Flow C->>WA: Apre il Flow e lo invia WA->>F: Risposte F->>HS: Invio del modulo sul contatto associato F-->>C: Schermata di ringraziamento, o un errore da correggere F->>HS: L'evento Form Completed avvia i workflow di follow-up ``` ## Tappa 1: collegare WhatsApp e HubSpot Circa 16 minuti. **1. Assegnate un nome all'organizzazione** Al primo accesso, Flowella vi chiede di **Name your organisation**. Inserite il nome e selezionate **Continue**. Non potete collegare WhatsApp finché l'organizzazione non ha un nome. **2. Collegate WhatsApp** Andate su **Settings → WhatsApp (Meta)** e selezionate **Connect WhatsApp**. Nel flusso di registrazione di Meta, scegliete o create il vostro WhatsApp Business Account (WABA), l'account in Meta che contiene i vostri numeri e modelli, poi verificate il numero di telefono. **3. Collegate HubSpot** Andate su **Settings → HubSpot** e selezionate **Connect HubSpot**. Scegliete il vostro account HubSpot e approvate il collegamento in HubSpot. **Verificate che abbia funzionato:** in cima all'app, gli indicatori di stato **WhatsApp** e **HubSpot** mostrano entrambi **Connected**. Su uno schermo piccolo, controllate **Settings → WhatsApp (Meta)**, dove il vostro numero è elencato in **Connected WhatsApp numbers**, e **Settings → HubSpot**, che mostra **Connected**. Per maggiori dettagli su ogni passaggio, consultate [Configurare Flowella](https://knowledge.flowella.io/it/onboarding.md). ## Tappa 2: inviare il vostro primo messaggio Circa 2 minuti. 1. Dal vostro telefono, inviate un qualsiasi messaggio WhatsApp al vostro numero aziendale. Questo apre la finestra di 24 ore, la finestra di assistenza clienti di Meta, durante la quale potete rispondere senza un modello. 2. In Flowella, aprite **Inbox** e selezionate la nuova conversazione. 3. Scrivete una risposta in **Type a message…** e premete Invio. **Verificate che abbia funzionato:** la risposta arriva sul vostro telefono. Consultate [Inbox](https://knowledge.flowella.io/it/app/inbox.md) per saperne di più sulle conversazioni. ## Tappa 3: creare il Flow Circa 15 minuti. 1. In HubSpot, create o scegliete il vostro modulo di marketing di prova. Flowella converte i campi di testo a riga singola, testo multiriga, email, telefono, numero, menu a tendina, pulsanti di opzione, caselle di controllo e data, e trasforma i campi file in un selettore di foto. Esclude i campi che non può convertire, e un campo obbligatorio che non può convertire blocca la sincronizzazione. 2. In Flowella, aprite **Flows**. Flowella aggiorna l'elenco dei moduli HubSpot quando aprite la pagina. Se il vostro modulo non è elencato, selezionate il pulsante di aggiornamento in cima alla pagina. 3. Trovate il vostro modulo e selezionate **Create WA Flow** nella colonna **WhatsApp Flow**. Il pulsante mostra **Syncing…** mentre Flowella crea il Flow e lo pubblica nel vostro WABA. **Verificate che abbia funzionato:** la riga mostra **Created**, oppure **Updated** se il vostro WABA aveva già un Flow con lo stesso nome, e il pulsante diventa **Sync WA Flow**. Selezionate **Open in Meta** per visualizzare l'anteprima del Flow. Il Flow ha una schermata con le domande del vostro modulo, intitolata con il nome del modulo, seguita da una schermata di ringraziamento. Flowella non ha un editor di Flow: per modificare le domande in seguito, modificate il modulo in HubSpot, poi selezionate **Sync WA Flow**. Consultate [Flows](https://knowledge.flowella.io/it/app/flows.md) e [Buone pratiche per la progettazione dei moduli](https://knowledge.flowella.io/it/app/form-design-best-practices.md). ## Tappa 4: aggiungere il Flow a un modello Circa 5 minuti, più la revisione di Meta. I contatti aprono un Flow da un pulsante **Flow** in un messaggio modello, quindi il Flow ha bisogno di un modello. Usate una delle due opzioni, poi inviate il modello. ### Opzione A: partire dalla pagina Flows Dopo la prima sincronizzazione riuscita della vostra organizzazione, Flowella mostra **Your form is now a WhatsApp Flow**. Selezionate **Create template with this Flow**. Se non vedete la finestra di dialogo, selezionate invece **Create template** nella riga del modulo. L'editor dei modelli si apre con un pulsante **Flow** già collegato al vostro Flow. Il testo del pulsante è **Continue**, che potete modificare. Scrivete il messaggio, scegliete una **Category** e inserite un **Template name** usando lettere minuscole, numeri e trattini bassi. ### Opzione B: partire dal modello iniziale di Flowella 1. In **Templates**, selezionate **New template**, poi **View starters** sotto **Flowella Templates**. 2. Trovate `flowella_start_flow` e selezionate **Use this starter**. Il suo messaggio recita `Hi {{1}}, tap below to complete a short form and we will get back to you.` e il suo pulsante Flow riporta **Open form**. 3. Nel campo **WhatsApp Flow** del pulsante, scegliete il vostro Flow. I Flows sono elencati con il nome del modulo HubSpot da cui provengono. 4. In **Body variables**, cambiate il **Fallback value** per `{{1}}` da `Alex` a qualcosa che suoni bene per chiunque, come `there`. Flowella lo invia quando un contatto non ha un nome. Il modello iniziale usa la categoria **Marketing**. Scegliete la categoria adatta al vostro messaggio prima di inviarlo. Consultate [Prezzi e categorie di messaggi WhatsApp](https://knowledge.flowella.io/it/account/pricing-and-conversation-categories.md). ### Inviare il modello a Meta 1. Selezionate **Save draft**. 2. Selezionate **Publish Template**, controllate la categoria, poi selezionate di nuovo **Publish Template** per inviarlo a Meta. Se il messaggio contiene variabili come `{{1}}`, assegnate prima a ciascuna un **Fallback value**. Meta lo esamina come esempio della variabile. Consultate [Variabili dei modelli](https://knowledge.flowella.io/it/app/template-variables.md#valori-di-fallback). 3. Attendete che lo stato passi da **Pending** ad **Approved**. Meta indica che una decisione può richiedere fino a 24 ore. **Verificate che abbia funzionato:** lo stato del modello è **Approved**. Se Meta lo rifiuta, consultate [Modello rifiutato](https://knowledge.flowella.io/it/troubleshooting/template-rejected.md). ## Tappa 5: provare il Flow sul vostro telefono Circa 3 minuti. 1. Aprite il vostro modello approvato e andate alla scheda **Send**. 2. In **Test Template**, scegliete il **Country**, inserite il vostro **WhatsApp Number** e compilate le eventuali variabili del modello. 3. Selezionate **Send Test**. 4. Sul vostro telefono, aprite il messaggio e toccate il pulsante Flow. Compilate il modulo usando il vostro indirizzo email e inviatelo. **Verificate che abbia funzionato:** * WhatsApp mostra la schermata di ringraziamento con il messaggio di ringraziamento del vostro modulo HubSpot. * Nell'**Inbox** di Flowella, la conversazione mostra una scheda con le vostre risposte, contrassegnata **Response sent**. Il titolo della scheda è il testo del pulsante Flow, oppure **Flow response**. * In HubSpot, il modulo ha un nuovo invio da una pagina che porta il nome del modulo, ad esempio `WhatsApp Flow · Contact us`. HubSpot aggiorna le proprietà del contatto mappate dal modulo. * La cronologia del contatto mostra un evento **Form Completed** con un link **View submission**. Flowella invia le risposte al modulo HubSpot originale. L'invio e le proprietà del contatto compaiono in HubSpot esattamente come per un modulo compilato sul vostro sito web. > [!NOTE] > > Questa prova spunta anche **Send a Flow from HubSpot** nella guida di configurazione, perché quel passaggio conta qualsiasi Flow completato. ## Tappa 6: inviare il Flow da un workflow HubSpot Circa 10 minuti. > [!NOTE] > > Questa tappa richiede le azioni dei workflow di HubSpot, che a loro volta richiedono un piano HubSpot che includa i workflow (Professional o Enterprise). In Flowella, aprite **Settings → HubSpot** e verificate che **Custom workflow actions** si trovi sotto **Unlocked**. In caso contrario, il vostro percorso termina alla tappa 5: inviate i Flows da Flowella con un invio di prova o un [invio massivo](https://knowledge.flowella.io/it/app/bulk-send.md). **1. Preparate un contatto di prova** In HubSpot, usate un contatto con il vostro numero WhatsApp in formato internazionale, come `+447700900123`, e il vostro indirizzo email. Il messaggio inviato nella tappa 2 potrebbe aver già creato o collegato un contatto per il vostro numero. Consultate [Formato del numero di telefono](https://knowledge.flowella.io/it/hubspot/phone-number-format.md). **2. Create un workflow basato sui contatti** Le azioni di Flowella funzionano solo sui contatti. Impostate un trigger di iscrizione che per ora soddisfi solo il vostro contatto di prova, come il valore di una proprietà o una lista. **3. Aggiungete Send WhatsApp Template** Aggiungete l'azione **Send WhatsApp Template** di Flowella. In **Template Name**, scegliete il vostro modello con il Flow. Nell'elenco compaiono solo i modelli approvati. In **Contact Phone Number**, selezionate la proprietà del contatto che contiene il numero WhatsApp. Se il vostro modello ha una variabile, mappate una proprietà come il nome a **Template Variable 1**. Consultate [Send WhatsApp Template](https://knowledge.flowella.io/it/hubspot/workflow-actions.md#send-whatsapp-template). **4. Attendete il Flow** Aggiungete un passaggio **Delay until event** sull'evento **Form Completed** di Flowella. Filtratelo per **Form Name** in modo che corrisponda al nome del vostro modulo HubSpot, e impostate quanto attendere, ad esempio un giorno. **5. Decidete cosa succede dopo** Per i contatti che completano il Flow, create una diramazione in base alle proprietà del contatto scritte dal modulo, oppure create un'attività. L'evento **Form Completed** registra il nome e l'origine del modulo, non le risposte. Per i contatti che non lo completano in tempo, inviate un modello di promemoria o create un'attività. **6. Attivate il workflow** Attivate il workflow e iscrivete il vostro contatto di prova. **Verificate che abbia funzionato:** * Il modello arriva sul vostro telefono e la cronologia del workflow del contatto mostra l'azione **Send WhatsApp Template** come completata. Flowella completa l'azione quando WhatsApp segnala il primo stato del messaggio, di solito inviato. * Dopo che avete completato il Flow, il contatto supera il passaggio **Delay until event** e l'invio compare nel modulo HubSpot come nella tappa 5. * Nella guida di configurazione, **Send a template from HubSpot** risulta spuntato. **Form Completed** si attiva solo quando qualcuno invia un WhatsApp Flow tramite Flowella, mai per gli invii dello stesso modulo dal sito web. Per workflow completi basati su questo schema, consultate le [guide ai workflow](https://knowledge.flowella.io/it/hubspot/workflows/overview.md). ## Risoluzione dei problemi > **Create WA Flow è disattivato** > > Passate il mouse sul pulsante per vedere il motivo. Il messaggio più comune è "Meta business verification is required before publishing flows." Il pulsante non è disponibile anche quando WhatsApp non è collegato, quando il modulo non ha campi supportati dai WhatsApp Flows o quando il vostro piano non consente la sincronizzazione. Consultate [Flows](https://knowledge.flowella.io/it/app/flows.md) e [Problemi di onboarding](https://knowledge.flowella.io/it/troubleshooting/onboarding.md). > **La sincronizzazione non riesce** > > La riga mostra un'etichetta come **Not ready**. Passate il mouse sull'icona informativa accanto per vedere il motivo. Se un campo HubSpot obbligatorio non può essere raccolto in un WhatsApp Flow, rendete il campo facoltativo o cambiatene il tipo in HubSpot, poi selezionate **Try again**. Consultate [Flows](https://knowledge.flowella.io/it/app/flows.md). > **Il mio modulo non è nella pagina Flows** > > Selezionate il pulsante di aggiornamento in cima a **Flows**. Compaiono solo i moduli di marketing HubSpot. Se la pagina mostra **Sample forms**, Flowella non riesce ancora a leggere i vostri moduli HubSpot: controllate il collegamento in **Settings → HubSpot**. Consultate [Flows](https://knowledge.flowella.io/it/app/flows.md). > **Il modello non è nell'elenco dell'azione HubSpot** > > Compaiono solo i modelli con stato **Approved**. Attendete la decisione di Meta, poi riaprite l'azione. Consultate [Azioni dei workflow HubSpot](https://knowledge.flowella.io/it/hubspot/workflow-actions.md). > **Il Flow mostra un errore quando lo invio** > > "Missing required field" di solito significa che è stato aggiunto un campo obbligatorio al modulo HubSpot dopo l'ultima sincronizzazione. Selezionate **Sync WA Flow** nella pagina **Flows**, poi inviate di nuovo il Flow. "Could not submit to HubSpot. Try again." significa che HubSpot non ha accettato l'invio: riprovate e verificate che **Settings → HubSpot** mostri **Connected**. > **L'invio non è associato a un contatto** > > HubSpot associa gli invii dei moduli ai contatti tramite l'indirizzo email. Aggiungete un campo email al modulo, oppure assicuratevi che il contatto abbia un indirizzo email in HubSpot. > **L'azione Send WhatsApp Template non riesce** > > Aprite la cronologia del workflow del contatto per vedere il motivo indicato da Flowella. Un numero mancante o formattato male restituisce `CONTACT_PHONE_MISSING` o `CONTACT_PHONE_INVALID`. Consultate [Formato del numero di telefono](https://knowledge.flowella.io/it/hubspot/phone-number-format.md) e [Azioni dei workflow HubSpot](https://knowledge.flowella.io/it/hubspot/workflow-actions.md). ## Risorse correlate > **[Flows](https://knowledge.flowella.io/it/app/flows.md)** > > Stato di sincronizzazione, conversione dei campi e limiti dei WhatsApp Flows. > **[Modelli](https://knowledge.flowella.io/it/app/templates.md)** > > Create, provate e inviate i modelli WhatsApp. > **[Azioni dei workflow HubSpot](https://knowledge.flowella.io/it/hubspot/workflow-actions.md)** > > Tutte le azioni e gli eventi di Flowella disponibili nei workflow di HubSpot. > **[Guide ai workflow](https://knowledge.flowella.io/it/hubspot/workflows/overview.md)** > > Ricette pronte di workflow HubSpot che usano i Flows. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.