Il modulo è stato rinominato da Forms a Flows nella v2.6.31. Gli oggetti sorgente HubSpot sono ancora chiamati form — la rinomina interessa solo la voce nella barra laterale di Flowella, l’intestazione della pagina e l’URL. I segnalibri a
/{org}/forms continuano a funzionare: Flowella emette un reindirizzamento permanente 308 a /{org}/flows.Come aprirla
Andate su Flows nella navigazione a sinistra, oppure:/{org}/{waba}/{phone}/flows. L’elenco è lo stesso. Lo scoping del canale viene utilizzato quando sincronizzate un Flow con Meta.
Cosa mostra l’elenco
Ogni riga rappresenta un form HubSpot. Le colonne includono:- Nome del form e un ID form HubSpot troncato con un pulsante di copia con un solo clic.
- Conteggio dei campi — quanti campi ha il form, con un flag se qualcuno non è supportato.
- Ultima modifica in HubSpot — estratto dal
updatedAtdi HubSpot stesso in modo da poter sapere quando è cambiata la definizione del form. - Stato del WhatsApp Flow — sincronizzato, in bozza o obsoleto (HubSpot è cambiato dall’ultima sincronizzazione).
- Indicatore di deriva — quando il form HubSpot è stato modificato dall’ultima creazione del Flow, la riga mostra un’etichetta ambra Form HubSpot modificato da quando è stato creato questo Flow — sincronizza nuovamente per acquisirlo. Avviate una nuova sincronizzazione per cancellarla.
- Crea WhatsApp Flow / Sincronizza WhatsApp Flow — l’azione principale. L’etichetta passa a Sincronizza quando esiste già un Flow e a Obsoleto — Sincronizzazione necessaria quando il form HubSpot è stato modificato dall’ultima sincronizzazione.
Sincronizzazione del catalogo in background
Flowella mantiene automaticamente aggiornato l’elenco Flows, quindi i form HubSpot appena aggiunti o rinominati appaiono senza fare clic su nulla:- Quando aprite la pagina, Flowella serve immediatamente il catalogo memorizzato nella cache e mette in coda una nuova sincronizzazione in background se il catalogo ha più di 5 minuti.
- Ogni 20 minuti, una scansione in background risincronizza il catalogo per ogni organizzazione la cui integrazione HubSpot è CONNECTED, in modo che gli elenchi rimangano aggiornati anche per le schede che nessuno ha aperto.
- Mentre è in corso una sincronizzazione in background, l’intestazione mostra Aggiornamento… accanto all’icona di aggiornamento. Al termine, l’etichetta passa a Ultima sincronizzazione 2 minuti fa (o l’equivalente in tempo relativo). L’elenco si aggiorna sul posto.
Dettaglio del form
Fate clic su una riga per aprire la sua pagina di dettaglio. L’intestazione del dettaglio mostra la stessa azione principale Crea / Sincronizza WhatsApp Flow della riga dell’elenco, quindi non dovete tornare indietro per apportare modifiche. Dalla pagina di dettaglio potete:- Rivedere la mappatura campo per campo tra il form HubSpot e il WhatsApp Flow.
- Vedere le esecuzioni di sincronizzazione passate — quando ciascuna è stata avviata, lo stato (in coda, in esecuzione, riuscita, fallita) e qualsiasi errore restituito da Meta.
- Avviare una nuova sincronizzazione, riprovare un’esecuzione fallita o annullare una sincronizzazione ancora in corso.
- Aprire il Flow corrispondente in Meta Business Suite.
- Controllare quale versione del form HubSpot è stata utilizzata per costruire il Flow pubblicato. Quando un Flow è stato sincronizzato, l’intestazione mostra Flow creato dal form HubSpot al 12 set, 14:03. Confrontatelo con il valore corrente Ultima modifica in HubSpot per decidere se dovete risincronizzare.
Sincronizzare un form con un WhatsApp Flow
Quando fate clic su Crea WhatsApp Flow o Sincronizza WhatsApp Flow, Flowella:- Esegue un controllo preflight — conferma che HubSpot sia connesso, che il canale attivo sia verificato, che il form abbia almeno un campo supportato e che la fatturazione sia attiva.
- Legge l’ultima definizione del form da HubSpot.
- Genera l’equivalente JSON del WhatsApp Flow.
- Lo carica su Meta sul canale che avete selezionato (limitato al canale).
- Registra l’esecuzione di sincronizzazione nella pagina di dettaglio e appone il timestamp Flow creato dal form HubSpot al in modo che la deriva possa essere rilevata nelle modifiche successive.
Blocco per ambito canale
I Flow sono a livello di organizzazione nell’elenco ma limitati al canale quando si sincronizza — un Flow deve essere caricato rispetto a una combinazione specifica di WABA + numero di telefono.
Se fate clic su Sincronizza dall’URL a livello di organizzazione e Flowella non può decidere quale canale utilizzare (nessun canale connesso, più canali senza ambito impostato o una sessione cross-org obsoleta), il pulsante rimane pre-disabilitato con un tooltip che spiega cosa manca. Passate al canale corretto dal selettore di canale, o aprite direttamente
/{org}/{waba}/{phone}/flows.
UX degli errori di sincronizzazione
Quando una sincronizzazione fallisce, Flowella trasforma la riga di esecuzione in un singolo pulsante di azione contornato in modo che possiate correggere in avanti dalla stessa riga:
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 di registrazione telefono, non un generico “non pronto”. Terminate la registrazione del telefono in Impostazioni → Meta e riprovate.QUEUE_FAILED— la coda di sincronizzazione non è riuscita a prendere in carico il job. Di solito transitorio; riprovate. Se persiste, la pagina di stato della piattaforma è il prossimo posto da controllare (vedere Stato e incidenti).- Meta
validation_errors— il badge riassume quali campi ha rifiutato Meta, in modo che possiate regolare il form HubSpot (o la mappatura dei campi) e riprovare senza lasciare la riga.
Le sottomissioni Flow si allegano al contatto HubSpot iscritto
Quando un WhatsApp Flow viene inviato da un workflow HubSpot, Flowella ora passa l’id del contatto HubSpot iscritto attraverso il Flow e lo include comehs_object_id quando la sottomissione viene riscritta in HubSpot. Questo fa sì che la sottomissione si alleghi al contatto esatto che HubSpot ha iscritto — non a un record simile — anche quando il numero di telefono corrisponde a più contatti, e rimuove l’ultimo caso in cui la ricerca del telefono HubSpot poteva ricadere sul record sbagliato.
Se la vostra organizzazione ha già Flow pubblicati, risincronizzate ogni Flow una volta in modo che il nuovo campo nascosto sia incluso nel JSON del Flow caricato su Meta:
1
Aprite la pagina Flows
Andate su Flows e aprite qualsiasi form il cui WhatsApp Flow è stato creato prima di questa modifica.
2
Avviate una nuova sincronizzazione
Fate clic su Sincronizza WhatsApp Flow sulla riga (o sull’azione principale nella pagina di dettaglio). Flowella ricarica il JSON del Flow su Meta con il campo id contatto nascosto.
3
Ripetete per ogni form attivo
Solo i form inviati dai workflow HubSpot ne hanno bisogno. I form inviati al di fuori del contesto di un workflow non sono interessati.
Testo della domanda nei blocchi di rich text
HubSpot vi consente di posizionare un elemento di rich text sopra un gruppo di campi in modo che il testo della domanda si trovi sopra l’input piuttosto che all’interno dell’etichetta del campo. Flowella mappa quei blocchi nel WhatsApp Flow insieme agli input:
Il rich text appare prima degli input nel gruppo di campi, quindi i clienti vedono la domanda, poi rispondono. Le etichette dei campi vengono ancora mostrate in-app, quindi mantenetele brevi — vedere Best practice di progettazione dei form.
Se avete già form HubSpot che utilizzano rich text sopra i gruppi di campi, risincronizzateli dalla pagina di dettaglio del form. Le esecuzioni di sincronizzazione precedenti prendevano solo le etichette dei campi, quindi il testo della domanda in rich text mancava dal Flow pubblicato finché non risincronizzate.
Formattazione della schermata di ringraziamento
La stessa mappatura HTML → componente Flow ora si applica al testo di ringraziamento su un form HubSpot. Intestazioni, testo in grassetto, spazi non separabili ed elenchi puntati sopravvivono alla sincronizzazione invece di essere ridotti a testo semplice, e il piè di pagina Fatto viene preservato.
Ogni punto elenco viene visualizzato come una singola riga, quindi il markup HubSpot ben formattato (un
<p> annidato all’interno di ogni <li>) non produce più righe di punti orfani su WhatsApp. Le intestazioni superiori a 80 caratteri ricadono ancora nel corpo del testo, come altrove nel Flow.
Se un form è stato sincronizzato prima di questa modifica, il suo Flow porta ancora il testo di ringraziamento in testo semplice. Aprite la pagina di dettaglio del form e risincronizzate per acquisire la nuova formattazione.
Dati di esempio
Se non avete ancora una connessione HubSpot, la pagina Flows viene visualizzata con righe illustrative dietro un callout “Dati di esempio”. Connettete HubSpot per passare ai vostri form reali.Un form può sincronizzarsi perfettamente e leggersi male su un telefono. Le etichette lunghe dei campi vengono accorciate sullo schermo, in modo particolarmente evidente su iPhone, e il tipo di domanda sbagliato peggiora la situazione. Vedere Best practice di progettazione dei form prima di costruire un form.
Correlati
Configurazione HubSpot
Connettete il portale da cui Flowella legge i form.
Progettazione dei form
Costruite form HubSpot che si visualizzano correttamente su ogni dispositivo.
Azioni del workflow
Attivate i Flow da un workflow HubSpot.
Guide ai workflow
Ricette end-to-end che combinano form, template e workflow.
Errori di sincronizzazione HubSpot
Diagnosticate problemi di sincronizzazione dei form e sottomissioni mancanti.
Multi-canale
I Flow vengono sincronizzati per canale — capite lo scoping.
Sicurezza dei dati
Come le sottomissioni dei form sono crittografate in transito e a riposo.