What you can build with Flows
Appointment booking
Let customers pick a service, choose a date and time, and confirm a booking — all within WhatsApp.
Lead capture
Collect names, contact details, and preferences from new contacts in a structured, guided form.
Surveys and feedback
Gather structured responses through rating scales, dropdowns, and open text fields.
Order forms
Take orders or service requests with validated inputs, reducing back-and-forth messages.
Flow lifecycle
A Flow moves through three statuses from creation to retirement:| Status | Description |
|---|---|
| Draft | The Flow is being built or edited. It can be tested via the preview simulator but cannot be sent to real users. |
| Published | The Flow is live and can be sent to users in bot messages. A published Flow cannot be edited; it must be deprecated first or a new version created. |
| Deprecated | The Flow has been retired and can no longer be sent. Existing conversations already in a Flow are not interrupted. |
When you update a published Flow’s JSON on Meta, it is automatically returned to Draft status. You need to republish it before sending it to users again.
How Flows are synced to Meta
Paige manages the sync between your Flow definition and Meta’s WhatsApp Business API automatically. When you create or update a Flow, Paige uploads the Flow JSON to Meta as a Draft. From there you can publish it directly from the Paige dashboard. Each Flow is identified by a Meta Flow ID that is stored in your project. Your bot code uses this ID when sending a Flow to a contact.Generate a Flow
Describe the Flow you want to the Code Agent in the bot code chat. For example: “Create a 3-screen appointment booking flow with a service dropdown, date picker, and confirmation screen.” The agent generates the Flow definition and uploads it to Meta as a Draft.
Preview and validate
Use the Flow preview simulator in the Paige dashboard to step through the Flow screens. Open the Flows tab, select the Flow, and click Try it for an interactive simulation you can click through — this works even before you’ve connected your own WhatsApp number, because the preview falls back to the Paige Dev copy of the Flow. You can also ask the agent to validate the Flow and surface any Meta errors.
Publish the Flow
Once you are satisfied, publish the Flow from the dashboard or ask the Code Agent to publish it. After publishing, the Flow can be sent to users.
Flow JSON format
Flows are defined in JSON format (version6.0). Each Flow contains one or more screens, and each screen contains a layout of components. Paige’s Code Agent generates and edits this JSON for you — you rarely need to edit it by hand.
Common Flow components include:
| Component | Description |
|---|---|
TextHeading | A heading displayed at the top of a screen |
TextBody | Body copy or instructions on a screen |
TextInput | A free-text input field |
Dropdown | A single-select dropdown |
DatePicker | A date selection widget |
Footer | A button at the bottom of a screen that advances to the next screen or submits the form |
Managing Flows from the dashboard
From the Flows section of your project you can:- View all Flows and their current status
- Open the preview simulator for any Flow
- Sync a Flow to Meta manually
- Publish or deprecate a Flow
- Delete a Draft Flow