Vai al contenuto principale
Flowella registra l’attività WhatsApp sul record del contatto HubSpot come attività della timeline, con l’etichetta Flowella: WhatsApp Forms Integration. Il vostro team vede l’interazione su WhatsApp accanto a email, chiamate e riunioni. Ogni tipo di attività è anche un trigger per i workflow Flowella, e funziona con il passaggio Delay until event di HubSpot per mettere in pausa un workflow finché il contatto non compie un’azione su WhatsApp. Queste attività richiedono la funzionalità Contact activity events (message sent, read, replies, forms). Vedere Verificare che gli eventi di attività dei contatti siano sbloccati.

Attività tracciate su un contatto

Ogni attività ha lo stesso nome del relativo trigger dei workflow, e potete usarle tutte in un passaggio Delay until event. Immagini, messaggi vocali, video e documenti inviati dal contatto non registrano un’attività Text Reply, quindi non attivano il trigger Text Reply.
Se create report o integrazioni con l’API di HubSpot, i nomi degli eventi sono flowella-form-completed, flowella-message-sent, flowella-message-seen e flowella-reply. In HubSpot vedete solo le etichette indicate sopra.

Proprietà degli eventi per il filtraggio

Ogni evento Flowella include le proprietà indicate di seguito. Potete usarle come condizioni di filtro nei trigger dei workflow HubSpot, negli elenchi attivi e nei report per l’evento corrispondente. messageType è un enum dell’evento Message Read con i valori TEXT, IMAGE, AUDIO, VIDEO, DOCUMENT, TEMPLATE, SYSTEM e OTHER. Descrive il messaggio in uscita che è stato letto. Filtri tipici:
  • formName = Get Started su Form Completed, per attivare il trigger solo sugli invii di uno specifico form WhatsApp Flow.
  • messageType = TEMPLATE su Message Read, per isolare le conferme di lettura dei vostri invii di template.
  • templateName = flowella_form_reminder su Message Sent, per segmentare i contatti a cui è stato inviato un template specifico.
Evitate di filtrare su Message nell’evento Text Reply. HubSpot valuta i filtri degli eventi rispetto a tutti gli eventi Text Reply storici del contatto, quindi un contatto che mesi fa ha risposto “cancel” continua a corrispondere per sempre a un filtro Message contains "cancel". Create invece rami sulla proprietà di contatto Last WhatsApp reply message. Contiene sempre e solo l’ultima risposta.
Non esiste una proprietà di direzione. Message Sent e Message Read riguardano sempre messaggi che avete inviato voi, e Text Reply è sempre un messaggio del contatto. Filtrate sull’evento stesso.
Queste proprietà sono impostate sull’evento della timeline. Nei trigger dei workflow compaiono come campi filtrabili sotto l’evento Flowella; negli elenchi attivi di HubSpot potete farvi riferimento tramite il filtro degli eventi della timeline per il tipo di evento corrispondente.

Proprietà di contatto Last WhatsApp reply

Oltre agli eventi della timeline, Flowella gestisce due proprietà di contatto che contengono sempre la risposta WhatsApp in arrivo più recente del contatto: Entrambe le proprietà si trovano nel gruppo Flowella Properties sul record del contatto. Flowella crea il gruppo ed entrambe le proprietà quando collegate o ricollegate HubSpot, se CRM contacts (auto-create on new WhatsApp chat) è sbloccato in Settings → HubSpot. Se mancano, Flowella le crea la volta successiva che registra una risposta. Flowella sovrascrive entrambe le proprietà ogni volta che registra un’attività Text Reply: per messaggi di testo, tocchi di pulsanti, scelte da elenchi e invii di Flow. Per un invio di Flow, Last WhatsApp reply message contiene un riepilogo dell’invio su una riga. Flowella aggiorna le proprietà prima di registrare l’attività. Quando si attiva un trigger Text Reply, Last WhatsApp reply message contiene già il messaggio che l’ha attivato, quindi il vostro workflow può creare subito rami sulla proprietà. Se HubSpot continua a rifiutare l’aggiornamento, Flowella registra comunque l’attività. Le risposte più lunghe di 4.096 caratteri vengono troncate ai primi 4.096.

Create rami sulla proprietà, non sul messaggio dell’evento

HubSpot valuta i filtri degli eventi come Text Reply → Message contains rispetto a tutti gli eventi Text Reply storici del contatto, non solo al più recente. Se un contatto ha inviato anche una sola volta una risposta corrispondente, il filtro corrisponde per sempre. La proprietà di contatto evita questo problema perché contiene solo l’ultima risposta. Lo schema consigliato è:
  1. Iscrivete il workflow sull’evento Text Reply, così si attiva quando arriva un nuovo messaggio in entrata.
  2. Create rami sulla proprietà di contatto Last WhatsApp reply message. Usate l’uguaglianza esatta per scelte fisse come Yes / No, oppure “contains any of” per l’instradamento per parola chiave.
Se avete workflow esistenti che filtrano su Text Reply → Message, ricreateli in modo che creino rami sulla proprietà di contatto Last WhatsApp reply message. Il filtro Message a livello di evento confronta l’intera cronologia delle risposte e può iscrivere contatti in base a risposte vecchie.
HubSpot conserva la cronologia delle modifiche delle proprietà, quindi i valori precedenti di Last WhatsApp reply message restano visibili nella cronologia della proprietà sul record del contatto. Includete la proprietà in qualsiasi processo di conservazione o eliminazione dei dati che riguardi il contenuto dei messaggi.

Cosa registra ogni attività

Form Completed

Registrata quando un contatto completa un form WhatsApp Flow. L’attività registra:
  • Form name: il nome del form completato, ad esempio Get Started
  • Source: sempre WhatsApp Flow
  • Links: View submission, View in Flowella
Fate clic su View submission per aprire una finestra sul record del contatto con le domande e le risposte del contatto, senza uscire da HubSpot. Vedere Finestre View submission e View template.

Message Sent

Registrata quando Meta conferma di aver inviato al contatto un messaggio WhatsApp da Flowella. L’attività registra:
  • Phone: il numero di telefono del contatto in formato E.164
  • Status: Sent
  • Template: il nome del template, ad esempio flowella_form_reminder (solo quando il messaggio era un template)
  • Links: View template, Open in Inbox, View in Flowella
Lo stato è sempre Sent: Flowella non aggiorna l’attività quando il messaggio viene consegnato. La consegna al telefono del contatto non viene registrata come attività separata, e le letture vengono registrate come Message Read. Quando il messaggio era un template, l’attività ha un link View template che apre il template così come lo ha visto il contatto. Vedere Finestre View submission e View template.

Message Read

Registrata quando Meta segnala che il contatto ha letto un messaggio di Flowella. L’attività registra:
  • Phone: il numero di telefono del contatto in formato E.164
  • Message type: il tipo di messaggio letto, uno tra TEXT, IMAGE, AUDIO, VIDEO, DOCUMENT, TEMPLATE, SYSTEM o OTHER
  • Time to read (seconds): quanto tempo dopo l’invio da parte di Flowella il contatto ha letto il messaggio
  • Links: View message in Flowella

Text Reply

Registrata quando il contatto invia un messaggio di testo, tocca un pulsante, sceglie da un elenco o invia un Flow. L’attività registra:
  • Phone: il numero di telefono del contatto in formato E.164
  • Message: il contenuto della risposta. Per un invio di Flow, un riepilogo su una riga.
  • Response time (seconds): il tempo trascorso tra il vostro ultimo messaggio nella conversazione e questa risposta
  • Links: Open in Inbox, View in Flowella

Usare le attività nei workflow

Le stesse quattro attività alimentano i trigger dei workflow HubSpot di Flowella. Potete iscrivere un contatto quando si verifica un’attività, oppure trattenerlo in un passaggio Delay until event finché non si verifica.
Lo schema più efficace è inviare e poi attendere: inviate un template, aggiungete un passaggio Delay until event impostato su un evento Flowella come Form Completed, poi create rami in base al fatto che l’evento si sia verificato nell’intervallo scelto. Vedere Azioni dei workflow per la configurazione completa, incluso come instradare in base alla risposta di un contatto usando la proprietà Last WhatsApp reply message.

Verificare che gli eventi di attività dei contatti siano sbloccati

Flowella registra queste attività solo quando Contact activity events (message sent, read, replies, forms) si trova sotto Unlocked nella card Capabilities in Settings → HubSpot. Richiede le autorizzazioni HubSpot timeline e analytics.behavioral_events.send. Se si trova sotto Not available, ricollegate HubSpot e approvate le autorizzazioni. Non esiste un’impostazione per sospendere le attività. Si interrompono solo quando scollegate HubSpot, e le attività già presenti nella timeline vi restano. Ogni attività contiene link su cui potete fare clic direttamente dalla card dell’attività:
  • View in Flowella apre la conversazione nella posta in arrivo di Flowella, sul numero WhatsApp usato dalla conversazione, anche se la vostra organizzazione ha più numeri.
  • Open in Inbox apre il thread della conversazione nella posta in arrivo delle conversazioni di HubSpot, così un agente può rispondere da HubSpot. Funziona solo quando il contatto ha una conversazione nella posta in arrivo di HubSpot, ad esempio tramite il canale personalizzato Flowella.
  • View submission (Form Completed) e View template (Message Sent, solo messaggi template) aprono una finestra sul record del contatto. Vedere sotto.

Finestre View submission e View template

Le attività Form Completed e le attività Message Sent dei template hanno un link che apre una finestra sul record del contatto HubSpot. Il vostro team può esaminare cosa è stato inviato, o cosa ha visto il contatto, senza cambiare scheda. Flowella salva una copia dell’invio o del template quando registra l’attività. La finestra mostra ciò che il contatto ha inviato o visto, anche se in seguito modificate il template o il Flow. Ogni link funziona per 24 ore dopo che Flowella ha registrato l’attività. Trascorso questo tempo, la finestra mostra Link expired, e riaprendo l’attività si ottiene lo stesso link scaduto. Per vedere i dettagli in seguito, usate View in Flowella. Premete Escape o fate clic fuori dalla finestra per tornare alla timeline del contatto.

Trovare le attività su un contatto

Aprite un record di contatto qualsiasi e osservate la timeline Activities. Gli eventi Flowella compaiono sotto l’etichetta Flowella: WhatsApp Forms Integration. Per vedere solo l’attività WhatsApp, filtrate la timeline per quel tipo di attività. Per creare report sull’attività WhatsApp, vedere Report e dashboard.

Correlati

Azioni dei workflow

Configurate trigger e azioni Flowella nei workflow HubSpot.

Report e dashboard

Create report sull’attività WhatsApp insieme agli altri vostri canali.

Canale personalizzato

Portate le conversazioni WhatsApp nella posta in arrivo di HubSpot.

Usare la posta in arrivo

Leggete e rispondete alle conversazioni WhatsApp in Flowella.
Ultima modifica il 24 ottobre 2026