Skip to main content
Ogni interazione WhatsApp gestita da Flowella viene riportata sul record del contatto HubSpot come attività della timeline, etichettata come Flowella: WhatsApp Forms Integration. Questo offre al Suo team una cronologia completa dell’engagement WhatsApp accanto a email, chiamate e riunioni. Ogni tipo di attività è anche esposto come trigger di workflow Flowella e può essere utilizzato con l’azione Ritarda fino al verificarsi dell’evento di HubSpot per mettere in pausa un workflow finché il contatto non compie un’azione su WhatsApp.
Gli eventi di attività del contatto utilizzano l’API per eventi CRM Timeline v4 di HubSpot. Dietro le quinte i quattro tipi di evento sono flowella-message-sent, flowella-message-seen, flowella-reply e flowella-form-completed. Nella timeline vede sempre solo le etichette descrittive, ma i nomi degli eventi sottostanti sono importanti se sta costruendo report personalizzati o integrazioni esterne sull’API di HubSpot.

Attività tracciate su un contatto

Proprietà degli eventi per il filtraggio

Ogni evento di timeline Flowella contiene un insieme fisso di proprietà definite nell’app sviluppatore HubSpot. HubSpot rifiuta l’intero batch se Flowella invia qualsiasi proprietà non dichiarata nello schema dell’evento, quindi il runtime emette solo i campi elencati di seguito. Può utilizzare queste proprietà direttamente come condizioni di filtro sui trigger dei workflow HubSpot, sugli elenchi attivi e sui report per il tipo di evento corrispondente. messageType è un enum sull’evento Messaggio letto 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 Modulo completato per attivare il workflow solo sugli invii di un modulo WhatsApp Flow specifico.
  • messageType = TEMPLATE su Messaggio letto per isolare le ricevute di lettura dei Suoi invii di modelli.
  • templateName = flowella_form_reminder su Messaggio inviato per segmentare i contatti a cui è stato inviato un modello specifico.
  • Messaggio contiene “cancel” su Risposta ricevuta per costruire un workflow di intento di cancellazione.
La direzione attualmente non è una proprietà dell’evento. La direzione è fissata dal tipo di evento: Messaggio inviato e Messaggio letto sono sempre in uscita, mentre Risposta ricevuta è sempre in entrata. Filtri sull’evento stesso anziché su una proprietà direction.
Queste proprietà vengono impostate sull’evento della timeline. Nei trigger dei workflow appaiono come campi filtrabili sotto l’evento Flowella; negli elenchi attivi HubSpot può farvi riferimento tramite il filtro dell’evento della timeline per il tipo di evento corrispondente.

Cosa registra ciascuna attività

Modulo completato

Registrata quando un contatto completa un modulo WhatsApp Flow. L’attività registra:
  • Nome del modulo: il nome del modulo completato, ad esempio Get Started
  • Origine: da dove proviene l’invio, ad esempio WhatsApp Flow
  • Collegamenti: Visualizza invio, Visualizza in Flowella

Messaggio inviato

Registrata quando Flowella invia un messaggio o un modello in uscita al contatto. L’attività registra:
  • Telefono: il numero di telefono del destinatario in formato E.164
  • Stato di consegna: lo stato di consegna Meta, ad esempio sent
  • Nome del modello: il modello utilizzato, ad esempio flowella_form_reminder (impostato solo quando il messaggio è stato inviato a partire da un modello)
  • Collegamenti: Apri nella Posta in arrivo, Visualizza in Flowella

Messaggio letto

Registrata quando il contatto apre un messaggio consegnato da Flowella. L’attività registra:
  • Telefono: il numero di telefono del destinatario in formato E.164
  • Tipo di messaggio: il tipo di messaggio in uscita che è stato letto — uno tra TEXT, IMAGE, AUDIO, VIDEO, DOCUMENT, TEMPLATE, SYSTEM o OTHER
  • Tempo di lettura (secondi): dopo quanto tempo dalla consegna il contatto ha aperto il messaggio
  • Collegamenti: Visualizza messaggio in Flowella

Risposta ricevuta

Registrata quando il contatto invia una risposta in testo libero. L’attività registra:
  • Telefono: il numero di telefono del contatto in formato E.164
  • Messaggio: il contenuto della risposta
  • Tempo di risposta (secondi): quanto rapidamente ha risposto il contatto
  • Collegamenti: Apri nella Posta in arrivo, Visualizza in Flowella

Utilizzo delle attività nei workflow

Le stesse quattro attività alimentano i trigger di workflow HubSpot di Flowella. Può iscrivere un contatto quando si verifica un’attività, oppure trattenere un contatto in un passaggio Ritarda fino al verificarsi dell’evento finché non si verifica.
Lo schema più efficace è invia e attendi: invii un modello, aggiunga un passaggio Ritarda fino al verificarsi dell’evento impostato su un evento Flowella come Modulo completato, quindi ramifichi in base al fatto che l’evento si sia verificato o meno nella finestra scelta. Vedere Azioni del workflow per la configurazione completa, incluso come filtrare il trigger Risposta testuale sul contenuto del messaggio.

Attivare o disattivare gli eventi di attività del contatto

I quattro eventi vengono scritti da una funzionalità a livello di organizzazione. Può attivare o disattivare l’intera funzionalità senza disinstallare l’app HubSpot. Vada in Impostazioni → HubSpot → Eventi di attività del contatto e azioni l’interruttore.
  • Attivo (predefinito) — Flowella pubblica gli eventi messaggio-inviato, messaggio-visto, risposta e modulo-completato sulla timeline di ogni contatto collegato.
  • Disattivo — Flowella interrompe la pubblicazione di nuovi eventi. Le voci di timeline esistenti vengono conservate.
Disattivare l’interruttore è utile mentre esegue il debug di un workflow rumoroso o se un admin del portale vuole tenere temporaneamente i dati WhatsApp fuori dalla timeline del CRM.

Collegamenti diretti dalla timeline

Ogni evento della timeline porta due collegamenti su cui può fare clic direttamente dalla card dell’attività:
  • Visualizza in Flowella — utilizza il nuovo percorso della posta in arrivo per canale (/{org}/{waba}/{phone}/inbox/...) in modo da atterrare sul canale giusto anche se il Suo account Flowella copre più WABA.
  • Apri nella Posta in arrivo — apre il thread HubSpot live-messages per la conversazione, così un agente può rispondere dall’interno di HubSpot.
(Dietro le quinte, il payload dell’evento v4 espone questi come flowellaRecordUrl e inboxUrl. In precedenza erano generici e si rompevano per gli account multi-canale — entrambi gli URL ora vengono generati per canale.)

Trovare le attività su un contatto

Apra qualsiasi record di contatto e guardi la timeline Attività. Gli eventi Flowella appaiono sotto l’etichetta Flowella: WhatsApp Forms Integration. Per vedere solo l’attività WhatsApp, filtri la timeline per quel tipo di attività. Queste stesse attività alimentano le proprietà del contatto e della conversazione utilizzate in Report e dashboard.

Correlati

Azioni del workflow

Configuri trigger e azioni Flowella nei workflow HubSpot.

Report e dashboard

Crei report sull’attività WhatsApp accanto agli altri canali.

Canale personalizzato

Porti le conversazioni WhatsApp nella posta in arrivo di HubSpot.

Utilizzo della posta in arrivo

Legga e risponda alle conversazioni WhatsApp in Flowella.
Ultima modifica il 10 agosto 2026