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.

The Forms page shows every HubSpot form Flowella is tracking for your organisation, the WhatsApp Flow Flowella has built from each one, and whether that Flow is in sync with Meta. For how to set up the HubSpot integration in the first place, see HubSpot setup. This page covers the in-app Forms screen, not the integration setup.

​
How to open it

Go to Forms in the left navigation, or: 
/{org}/forms
You can also open Forms scoped to a specific channel at /{org}/{waba}/{phone}/forms. The list is the same — the channel scoping is used when you sync a Flow to Meta.

​
What the list shows

Each row represents one HubSpot form. Columns include:
  • Form name and HubSpot form ID
  • Catalog updated — when Flowella last refreshed the form definition from HubSpot
  • WhatsApp Flow status — whether a Flow has been synced to Meta and the result of the last sync
  • Quick actions — view the form details, run a sync, open the linked Flow on Meta
You can filter and search the list to find a specific form quickly.

​
Form detail

Click a row to open its detail page. From there you can:
  • Review the field-by-field mapping between the HubSpot form and the WhatsApp Flow.
  • See past sync runs — when each was started, status (queued, running, succeeded, failed), and any errors Meta returned.
  • Trigger a new sync.
  • Open the corresponding Flow in Meta Business Suite.

​
Syncing a form to a WhatsApp Flow

When you click Sync, Flowella:
  1. Reads the latest form definition from HubSpot.
  2. Generates the equivalent WhatsApp Flow JSON.
  3. Uploads it to Meta on the channel you have selected.
  4. Records the sync run on the detail page.
Most syncs take a few seconds. If Meta rejects the Flow, the failure reason appears in the run row — usually because of an unsupported field type or missing screen.

​
Sample data

If you have no HubSpot connection yet, the Forms page renders with illustrative rows behind a “Sample data” callout. Connect HubSpot to switch to your real forms.
HubSpot forms with unsupported field types (file upload, signature) cannot be synced as-is. Adjust the form in HubSpot or skip those fields in the WhatsApp Flow.