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 Startedsu Modulo completato per attivare il workflow solo sugli invii di un modulo WhatsApp Flow specifico.messageType=TEMPLATEsu Messaggio letto per isolare le ricevute di lettura dei Suoi invii di modelli.templateName=flowella_form_remindersu 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,SYSTEMoOTHER - 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.
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.
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.

