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
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.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 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.
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.
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.Related
Workflow actions
Set up Flowella triggers and actions in HubSpot workflows.
Reporting & dashboards
Report on WhatsApp activity alongside your other channels.
Custom channel
Bring WhatsApp conversations into the HubSpot inbox.
Using the inbox
Read and reply to WhatsApp conversations in Flowella.