Skip to main content

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.

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.

Activities tracked against a contact

ActivityRecorded whenWorkflow triggerUse with Delay until event
Form completedA contact submits a WhatsApp Flow form sent by FlowellaForm CompletedYes
Message sentFlowella sends an outbound message or templateMessage SentYes
Message readThe contact opens a message Flowella deliveredMessage ReadYes
Reply receivedThe contact sends a free text replyText ReplyYes

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.
ActivityWorkflow triggerTypical use
Form completedForm CompletedProcess form answers, then branch on the response
Message sentMessage SentLog outbound activity or start a follow-up timer
Message readMessage ReadFollow up only after the contact has seen the message
Reply receivedText ReplyRoute 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 for the full setup, including how to filter the Text Reply trigger on message content.

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.

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.