Built on the official Meta WhatsApp Business API Official Meta WhatsApp Business API See plans

Build a chatbot with the flow builder

5 min read Updated 19 Nov 2026

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.

Note

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.

Start Bot FlowKeywords: hi, hello
Button MessageChoose an option
Text MessageButton 1: Prices
Text MessageButton 2: Timings
Assign ChatButton 3: Talk to a person
A sample flow. Each button leads to its own next step.

Blocks you can use#

Drag blocks from the "Available Components" panel on the left. The blocks currently listed are:

BlockUse it to
Text MessageSend a text. You can set a delay in seconds and use the name and phone variables.
Button MessageSend a message with up to 3 reply buttons. Each button leads to its own next step.
ListSend a menu with up to 10 options in one section. Each option leads to its own next step.
Image Message, Audio Message, Video Message, DocumentSend a file. You can upload one or choose it from your library.
LocationSend a place with name, address, latitude and longitude.
Collect AnswerAsk a question and save the reply as the contact's name, email or a note.
Update ContactAdd a tag, or set a custom attribute.
Assign ChatGive the chat to a specific team member, or in turn (round robin).
Wait / DelayPause, then continue depending on whether the customer replied.
Go to FlowJump to another flow or to your main menu flow.

Build your first flow#

  1. Open Flow BuilderGo to WhatsApp > Flow Builder, then click Add New. A canvas opens with a Start Bot Flow block already on it.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. Check the listYou return to the Flows list. It shows your flow with its keyword, matching type and a Status switch.
Open Flow Builder
yourdomain.com/client/flow-builders
Text Message
Button Message
List
Collect Answer
Save1

Start Bot Flow2

hi, hello, menu
Exact keyword match
joined3

Button Message

Prices · Timings · Help
The flow canvas. Drag blocks from the left and join them with lines.
  1. Save, which asks for a Title
  2. Start Bot Flow block with its keywords
  3. Line joining one block to the next

Test it and switch it on#

  1. Check the Status switchIn the Flows list the Status switch must be on. A flow that is off does not answer.
  2. 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.
  3. Fix and save againClick the edit icon in the Action column to reopen the canvas, change a block, and Save.
Tip

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.

Was this guide helpful?
Black Friday Sale – Get 20% OFF!
Latest offer

Black Friday Sale – Get 20% OFF!

Unlock smarter business communication this Black Friday! Enjoy 20% OFF on all WhatsApp Marketing Agency plans, including WhatsApp Business API, bulk messaging, AI chatbots, CRM integration and automation. Use coupon code BLACKFRIDAY20 at checkout. Limited-time offer: 27–30 November 2026.

Claim 20% OFF Now