The WhatsApp Flow block lets you design structured conversation journeys that guide users through branching paths, collect information, and execute actions based on their responses. Use WhatsApp flows when you want to go beyond simple replies—like:

• building lead qualification sequences
• customer support troubleshooting trees
• booking workflows
• multi-step forms.

Flows can integrate with variables, APIs, and integrations to fetch data, validate inputs, or trigger actions in external systems, all while keeping the conversation within WhatsApp. Learn more about flows

​

Using the WhatsApp flow block

To add a WhatsApp Flow to your bot:

1. Open your bot in Bot Builder.
2. Drag the WhatsApp flow action block onto the canvas.
3. Connect the block to the relevant part of your conversation flow.
4. Open the block configuration.
5. Select the published Flow from the dropdown.
6. Select the screen from which the Flow should start.
7. Configure any data that should be passed from WotNot into the Flow.
8. Map the Flow’s response fields to WotNot variables.
9. Configure the button that users click to open the Flow.
10. Deploy the bot.

The Flow dropdown is populated with Flows available from the WhatsApp number connected to the bot.

​

Configurations

​

Header

Shows the text in a bold format — making it look like a title. It is an optional field.

​

Footer

The text is displayed in a small grey color format. Mostly used to display a disclaimer to the user when selecting the option from the list.

​

Body

The text will be the question associated with showing the list of options. For example, “Select the service you are interested in”.

​

Error message

If the user types a random text instead of clicking the button, this error message will be sent.

​

Button Name

Set the text displayed on the button that opens the WhatsApp Flow. For example:

• Start
• Continue
• Book now
• Submit details

The user selects this button to open the Flow inside WhatsApp.

​

Flow Creation

• Log in to Meta Business Manager and open WhatsApp Manager.
• In the left navigation menu, go to Account tools → Flows.
• Click Create flow.
• You will see the Create flow screen with fields for the Flow name, category, and template.

On the Create flow page:

1. Enter a name for your Flow in the Name field. For example: Feedback
2. Select a suitable Category. For example: Shopping
3. Choose how the Flow will communicate with your backend:
   • Without endpoint – Use this when the Flow does not need to communicate with an external backend.
   • With endpoint – Use this when the Flow needs to send or receive data through a backend endpoint.
4. Select a Flow template.
5. For a feedback form, select Get feedback.

The Flow preview panel on the right displays a preview of the selected Flow.

6. Click Create.

• After creating the Flow, Meta opens the Flow editor.
• The editor contains three main areas:
  • JSON editor – Used to define the Flow structure and components.
  • Run button – Used to render and test the Flow.
  • Preview panel – Displays how the Flow will appear to users inside WhatsApp.
• You can modify the JSON to customize the Flow.

After making changes:

1. Click Run.
2. Review the Flow in the preview panel.
3. Verify that all questions, fields, and navigation behave as expected.
4. Check the Flow JSON errors indicator at the bottom of the editor.
5. Fix any validation errors before publishing.
6. Click Save.

• Once the Flow has been tested and saved, click Publish in the top-right corner of the Flow editor.
• Meta displays a confirmation dialog explaining that the Flow will be published.
• Click on Publish.

• Your flow is now published.
• You can also check the status of the flow as it is published or not.

​

Flow Selection

Add the WhatsApp flow action block on the bot builder and configure it.

​

Starting Screen

Select the screen where you want the user to enter the WhatsApp Flow. The available screens are taken from the selected Flow. Choose the appropriate screen based on where you want the user to begin their journey. For example, if your Flow has a SIGN_UP screen, selecting SIGN_UP starts the Flow from that screen when the user clicks the button.

​

Flow token

The Flow token is a custom value passed to the WhatsApp Flow when it is launched. WhatsApp sends this value back to your configured Flow endpoint with requests from that Flow. This lets your backend identify the current Flow and retrieve any additional information needed to process the user’s submission.

In the Flow token field, enter the value you want to pass to the WhatsApp Flow.

​

Pre-filled data

Define the values or variables that should be passed to the corresponding fields in the WhatsApp Flow. Use prefilled data when you already have information about the user and want to display it in the Flow instead of asking the user to enter it again. Select the field from the Flow and map it to a WotNot variable or value. This allows you to pass existing conversation data into the Flow and prefill the relevant fields. For example, if the Flow has a Name field, you can map it to the name variable so the user’s existing name is automatically passed to the Flow.

​

Save response to variables

Response mapping defines how the data submitted by a user in a WhatsApp Flow is received and stored in variables after the Flow is completed. This allows you to use the information collected through the Flow in the next steps of your bot, such as sending a personalized message, applying a condition, or passing the data to a function.

​

Output Paths

The WhatsApp Flow block provides different paths based on what happens when the user interacts with the Flow.

​

Flow completed

The Flow completed path is triggered when the user successfully completes and submits the Flow. Connect this path to the next step in your conversation, such as:

• Sending a confirmation message
• Calling a function with the submitted information
• Updating a contact
• Continuing to another part of the conversation

The values submitted through the Flow are available through the variables configured in Response mapping.

​

Flow abandoned or expired

The Flow abandoned or expired path is triggered when the user does not successfully complete the Flow, such as when the Flow is abandoned or expires. Connect this path to an appropriate fallback, such as:

• Asking the user to try again
• Offering an alternative way to provide the information
• Returning the user to the previous conversation step