> ## 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.
# Flowella contact activity in HubSpot
> See every Flowella WhatsApp activity logged on the HubSpot contact timeline, the Timeline v4 event names, and how to use them as workflow triggers.
Every WhatsApp interaction Flowella handles is written back to the HubSpot contact record as a timeline activity, labelled **Flowella: WhatsApp Forms Integration**. This gives your team a full history of WhatsApp engagement next to email, calls, and meetings.
Each activity type is also exposed as a Flowella workflow trigger, and can be used with HubSpot's **Delay until event occurs** action to pause a workflow until the contact does something on WhatsApp.
Contact activity events use HubSpot's **CRM Timeline v4** event API. Behind the scenes the four event types are `flowella-message-sent`, `flowella-message-seen`, `flowella-reply`, and `flowella-form-completed`. You only ever see the friendly labels in the timeline, but the underlying event names matter if you're building custom reports or external integrations on top of HubSpot's API.
## Activities tracked against a contact
| Activity | Recorded when | Workflow trigger | Use with Delay until event | Timeline v4 event |
| -------------- | ------------------------------------------------------- | ---------------- | -------------------------- | ------------------------- |
| Form completed | A contact submits a WhatsApp Flow form sent by Flowella | Form Completed | Yes | `flowella-form-completed` |
| Message sent | Flowella sends an outbound message or template | Message Sent | Yes | `flowella-message-sent` |
| Message read | The contact opens a message Flowella delivered | Message Read | Yes | `flowella-message-seen` |
| Reply received | The contact sends a free text reply | Text Reply | Yes | `flowella-reply` |
## What each activity records
### Form completed
Logged when a contact completes a WhatsApp Flow form. The activity records:
* **Type**: Template
* **Source**: WhatsApp Flow
* **Form**: the name of the form completed, for example Get Started
* **Links**: View submission, View in Flowella
### Message sent
Logged when Flowella sends an outbound message or template to the contact. The activity records:
* **Direction**: Outbound
* **Type**: Template or Text
* **Status**: Sent
* **Template**: the template name, for example `flowella_form_reminder`
* **Links**: Open in Inbox, View in Flowella
### Message read
Logged when the contact opens a message Flowella delivered. The activity records:
* **Direction**: Inbound (receipt)
* **Type**: Text
* **Time to read**: how long after delivery the contact opened the message
* **Links**: View message in Flowella
### Reply received
Logged when the contact sends a free text reply. The activity records:
* **Direction**: Inbound
* **Type**: Text
* **Message**: the content of the reply
* **Response time**: how quickly the contact replied
* **Links**: Open in Inbox, View in Flowella
## Using activities in workflows
The same four activities power Flowella's HubSpot workflow triggers. You can enrol a contact when an activity occurs, or hold a contact at a **Delay until event occurs** step until it does.
| Activity | Workflow trigger | Typical use |
| -------------- | ---------------- | ----------------------------------------------------- |
| Form completed | Form Completed | Process form answers, then branch on the response |
| Message sent | Message Sent | Log outbound activity or start a follow-up timer |
| Message read | Message Read | Follow up only after the contact has seen the message |
| Reply received | Text Reply | Route the contact based on what they replied |
The strongest pattern is **send then wait**: send a template, add a **Delay until event occurs** step set to a Flowella event such as Form Completed, then branch on whether the event happened in your chosen window. See [Workflow actions](/hubspot/workflow-actions) for the full setup, including how to filter the Text Reply trigger on message content.
## Turn contact activity events on or off
The four events are written by an org-level **capability**. You can switch the whole feature on or off without uninstalling the HubSpot app.
Go to **Settings → HubSpot → Contact activity events** and toggle the switch.
* **On (default)** — Flowella publishes message-sent, message-seen, reply, and form-completed events to every connected contact's timeline.
* **Off** — Flowella stops publishing new events. Existing timeline entries are kept.
Turning the toggle off is useful while you debug a noisy workflow, or if a portal admin wants to keep WhatsApp data out of the CRM timeline temporarily.
## Deep links from the timeline
Each timeline event carries two links you can click straight from the activity card:
* **View in Flowella** — uses the new **channel-scoped inbox path** (`/{org}/{waba}/{phone}/inbox/...`) so you land on the right channel even if your Flowella account spans multiple WABAs.
* **Open in Inbox** — opens the HubSpot **live-messages** thread for the conversation, so an agent can reply from inside HubSpot.
(Behind the scenes, the v4 event payload exposes these as `flowellaRecordUrl` and `inboxUrl`. They were previously generic and broke for multi-channel accounts — both URLs are now generated per-channel.)
## Finding activities on a contact
Open any contact record and look at the **Activities** timeline. Flowella events show under the **Flowella: WhatsApp Forms Integration** label. To see only WhatsApp activity, filter the timeline by that activity type. These same activities feed the contact and conversation properties used in [Reporting and dashboards](/hubspot/reporting-and-dashboards).
## Related
Set up Flowella triggers and actions in HubSpot workflows.
Report on WhatsApp activity alongside your other channels.
Bring WhatsApp conversations into the HubSpot inbox.
Read and reply to WhatsApp conversations in Flowella.