Build a chatbot with the flow builder
The flow builder lets you design a chatbot conversation by joining blocks on a canvas. You need a connected WhatsApp number, a plan that includes flows, and permission to manage flows.
How a flow works#
A flow starts with a Start Bot Flow block. It has keywords. When a customer's message matches a keyword, the bot follows the blocks you joined: it sends messages, asks questions, shows buttons or lists, and can tag the contact or give the chat to a team member.
If a customer is in the middle of a flow, their next message continues that flow. A flow that matches takes priority over a simple keyword auto reply.
If you do not see Flow Builder under WhatsApp in the left menu, your role or plan may not include it. The number of flows is also limited by your plan.
Blocks you can use#
Drag blocks from the "Available Components" panel on the left. The blocks currently listed are:
| Block | Use it to |
|---|---|
| Text Message | Send a text. You can set a delay in seconds and use the name and phone variables. |
| Button Message | Send a message with up to 3 reply buttons. Each button leads to its own next step. |
| List | Send a menu with up to 10 options in one section. Each option leads to its own next step. |
| Image Message, Audio Message, Video Message, Document | Send a file. You can upload one or choose it from your library. |
| Location | Send a place with name, address, latitude and longitude. |
| Collect Answer | Ask a question and save the reply as the contact's name, email or a note. |
| Update Contact | Add a tag, or set a custom attribute. |
| Assign Chat | Give the chat to a specific team member, or in turn (round robin). |
| Wait / Delay | Pause, then continue depending on whether the customer replied. |
| Go to Flow | Jump to another flow or to your main menu flow. |
Build your first flow#
- Open Flow BuilderGo to WhatsApp > Flow Builder, then click Add New. A canvas opens with a Start Bot Flow block already on it.
- Set the keywordsClick the Start Bot Flow block. A Configure panel opens. Under the keywords box, type the words that start the bot, separated by commas, for example
hi, hello, menu. Choose Exact keyword match (the whole message must be the keyword) or Contain (the message includes it). Click Done. - Add blocksDrag a block, for example Button Message, from the left panel onto the canvas. Click it to fill in the text and the button names. Button text can be up to 20 characters and the main message up to 1024.
- Join the blocksDrag from the small dot on the right of one block to the next block. Every block must be joined, or you cannot save. For buttons and lists, join each button or option to the step it should lead to.
- SaveClick Save in the left panel. A box opens. Enter a Title, optionally choose a Contact list and Segment so the bot only answers those contacts (leave them on "All contacts" and "All segments" to answer everyone), then click Save.
- Check the listYou return to the Flows list. It shows your flow with its keyword, matching type and a Status switch.
Start Bot Flow2
hi, hello, menuExact keyword match
Button Message
Prices · Timings · Help- Save, which asks for a Title
- Start Bot Flow block with its keywords
- Line joining one block to the next
Test it and switch it on#
- Check the Status switchIn the Flows list the Status switch must be on. A flow that is off does not answer.
- Test from another phoneSend your keyword to your business number from a phone that is not your business number. Check each button and path. Use a test contact that is in the list or segment you chose, if you chose one.
- Fix and save againClick the edit icon in the Action column to reopen the canvas, change a block, and Save.
Start small: one greeting, one Button Message with three buttons, and a Text Message for each. Add Assign Chat at the end of a path so a person takes over when the customer needs help. Free text replies only reach customers inside the 24-hour customer service window. For later messages use an approved template.
Common problems#
"You must connect all nodes to proceed"
A block is not joined to the flow. Drag a line from the previous block to it, or delete the extra block.
Save is refused for a block
Some blocks have required fields. A Collect Answer needs a question and where to save it. A List needs a message, a menu button name, a section title and at least one option. An Assign Chat set to a specific person needs that person selected. Update Contact needs a tag or attribute. Fix the block named in the message.
"You have reached the maximum number of flow builders allowed by your plan"
Delete a flow you do not need, or change your plan. See Manage your subscription and billing.
The bot does not answer
Check the Status switch, the keyword and the matching type. Also check the contact belongs to the list or segment you chose for the flow.
Need help?#
Contact support on WhatsApp +91 99159 60958 or email info@whatsappmarketingagency.com, or use the contact page. You can also read Inbox automation for hours and assignment.