> ## 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.

# Attività del contatto Flowella in HubSpot

> Vedete ogni attività WhatsApp di Flowella registrata nella timeline dei contatti HubSpot, i nomi degli eventi Timeline v4 e come usarli come trigger workflow.

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.

<Note>
  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.
</Note>

## Attività tracciate su un contatto

| Attività          | Registrata quando                                             | Trigger di workflow | Utilizzo con Ritarda fino all'evento | Evento Timeline v4        |
| ----------------- | ------------------------------------------------------------- | ------------------- | ------------------------------------ | ------------------------- |
| Modulo completato | Un contatto invia un modulo WhatsApp Flow inviato da Flowella | Modulo completato   | Sì                                   | `flowella-form-completed` |
| Messaggio inviato | Flowella invia un messaggio in uscita o un modello            | Messaggio inviato   | Sì                                   | `flowella-message-sent`   |
| Messaggio letto   | Il contatto apre un messaggio consegnato da Flowella          | Messaggio letto     | Sì                                   | `flowella-message-seen`   |
| Risposta ricevuta | Il contatto invia una risposta in testo libero                | Risposta testuale   | Sì                                   | `flowella-reply`          |

## Cosa registra ciascuna attività

### Modulo completato

Registrata quando un contatto completa un modulo WhatsApp Flow. L'attività registra:

* **Tipo**: Modello
* **Origine**: WhatsApp Flow
* **Modulo**: il nome del modulo completato, ad esempio Get Started
* **Collegamenti**: Visualizza invio, Visualizza in Flowella

### Messaggio inviato

Registrata quando Flowella invia un messaggio o un modello in uscita al contatto. L'attività registra:

* **Direzione**: In uscita
* **Tipo**: Modello o Testo
* **Stato**: Inviato
* **Modello**: il nome del modello, ad esempio `flowella_form_reminder`
* **Collegamenti**: Apri nella Posta in arrivo, Visualizza in Flowella

### Messaggio letto

Registrata quando il contatto apre un messaggio consegnato da Flowella. L'attività registra:

* **Direzione**: In entrata (ricevuta)
* **Tipo**: Testo
* **Tempo di lettura**: 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:

* **Direzione**: In entrata
* **Tipo**: Testo
* **Messaggio**: il contenuto della risposta
* **Tempo di risposta**: 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.

| Attività          | Trigger di workflow | Uso tipico                                                                |
| ----------------- | ------------------- | ------------------------------------------------------------------------- |
| Modulo completato | Modulo completato   | Elaborare le risposte del modulo, quindi ramificare in base alla risposta |
| Messaggio inviato | Messaggio inviato   | Registrare attività in uscita o avviare un timer di follow-up             |
| Messaggio letto   | Messaggio letto     | Dare seguito solo dopo che il contatto ha visto il messaggio              |
| Risposta ricevuta | Risposta testuale   | Instradare il contatto in base a ciò che ha risposto                      |

<Note>
  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](/hubspot/workflow-actions) per la configurazione completa, incluso come filtrare il trigger Risposta testuale sul contenuto del messaggio.
</Note>

## 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](/hubspot/reporting-and-dashboards).

## Correlati

<CardGroup cols={2}>
  <Card title="Azioni del workflow" icon="git-branch" href="/hubspot/workflow-actions">
    Configuri trigger e azioni Flowella nei workflow HubSpot.
  </Card>

  <Card title="Report e dashboard" icon="chart-column" href="/hubspot/reporting-and-dashboards">
    Crei report sull'attività WhatsApp accanto agli altri canali.
  </Card>

  <Card title="Canale personalizzato" icon="inbox" href="/hubspot/custom-channel">
    Porti le conversazioni WhatsApp nella posta in arrivo di HubSpot.
  </Card>

  <Card title="Utilizzo della posta in arrivo" icon="messages-square" href="/app/inbox">
    Legga e risponda alle conversazioni WhatsApp in Flowella.
  </Card>
</CardGroup>