WhatsApp Flows
Design interactive multi-screen forms and guided experiences that run natively inside WhatsApp — no links, no redirects.
What are WhatsApp Flows?
WhatsApp Flows (part of the official Meta Flows API) let you build interactive screens that appear inline in a WhatsApp conversation. They're ideal for:- Lead capture forms (name, email, phone, interest)
- Appointment booking and scheduling
- Product catalog browsing and ordering
- Customer satisfaction surveys (NPS, CSAT)
- Registration and onboarding questionnaires
- Support ticket creation
Note
Flows run entirely within WhatsApp — the contact never leaves the app or opens a browser. This dramatically increases completion rates compared to external form links.
Flow Builder
1
Create a new Flow
Go to Dashboard → Flows → New Flow. Give it a name and select the category (Sign Up, Appointment, Customer Service, Survey, etc.). The category is reported to Meta and affects how the flow is reviewed.
2
Add Screens
A Flow is made of one or more Screens. Each screen is a page the contact sees. Use the + Add Screen button and drag to reorder. Common patterns:
- Single screen — simple lead form
- Two screens — collect info → confirmation
- Multi-screen — wizard / booking flow
3
Add Components to each Screen
Drag components from the right panel onto your screen:
| Component | Use case |
|---|---|
| Text Input | Single-line text (name, email, phone). |
| Text Area | Multi-line text (message, description). |
| Dropdown | Select from a list of options. |
| Radio Buttons | Pick one option (single choice). |
| Checkboxes | Pick multiple options. |
| Date Picker | Select a date (calendar UI). |
| Image | Display an image between fields. |
| Text / Heading | Static label or section header. |
| Footer Button | The primary action (Next / Submit). |
4
Configure routing
Each screen's footer button can route to the next screen or complete the flow. On completion, you define what data is sent back to MotherBot and how it's used (store in contact fields, trigger a chatbot action, send a template reply).
5
Publish the Flow
Click Submit for Review. Meta reviews Flows (usually within 24 hours for standard categories). Once approved, the Flow status changes to Published.
Attaching Flows to Messages
Published Flows can be triggered in two ways:- Template button — add a 'Flow' button to a message template. When the contact taps it, the Flow opens.
- Chatbot action — use the 'Open Flow' action in a chatbot sequence to launch the Flow after a keyword trigger.
Tip
Combine a campaign with a Flow button template to collect structured data from a large audience. This is powerful for surveys, registrations, and appointment booking at scale.
Accessing Submitted Responses
Flow responses are available in:- Contact profile — each submitted field is stored as a contact property.
- Conversations — the conversation shows a 'Flow completed' event with submitted data.
- Webhooks — a flow.completed event is sent to your webhook endpoint with the full payload.
- API — query /api/contacts/:id to get all stored properties.
Flow Limits
| Limit | Value |
|---|---|
| Max screens per Flow | 10 |
| Max components per screen | 20 |
| Max dropdown options | 300 |
| Max checkbox options | 20 |
| Response payload size | 5 KB |