Help / WhatsApp Flows

WhatsApp Flows

Build bot flows that reply to incoming messages automatically, and create forms that open inside WhatsApp (Meta Flows).

What is this section for?

Flows brings two tools together that work on WhatsApp on your behalf:

ToolWhat it doesExample
Bot flowWhen a client writes, it talks back automatically with messages, buttons and lists, then creates a task or assigns an agent.Show a menu to anyone who types “price”, open a task for anyone who picks “Appointment”.
Meta Flow (form)A multi-screen form the client fills in without leaving WhatsApp.Appointment request form, sign-up form, short survey.

They also work together: one step of a bot flow sends the client a form, and the answers can be used later in the flow.

Path: Left menu → Flows

Flows screen

This feature depends on your plan. If Flows is not in the menu, it is not in your plan or you have not been given permission. See Roles and Permissions. If the page says “Flows are not ready yet”, setup is not complete; contact support.

Know this first

  • The 24-hour rule. After a client writes to you, you can message them freely for 24 hours. After that you can only send a template. Bot flows follow this rule. See WhatsApp Templates.
  • Each flow is tied to one WhatsApp line. Templates are per line too, so the template step lists only the templates of the selected line.
  • Bot messages show in the chat. The sender is written as 🤖 Flow name, so agents can tell which messages came from the bot.
  • For one client, the same flow runs only once at a time. It is not triggered again while it is in progress.

Building a bot flow

1. Create the flow

  1. On the Flows page, click New bot flow.
  2. Type a name in the top field and choose the WhatsApp line.
  3. Add steps from the list on the left. Steps appear as boxes on the canvas.
  4. Drag from the dot on the right of a box to the next box to connect them. Each exit point goes to only one place.
  5. Click a box to open its settings in the right panel.
  6. Click Save.
Bot flow editor

Every flow needs one trigger. It cannot be deleted and must be connected to the first step. A flow can have at most 60 steps.

2. Choose the trigger

TriggerWhen does it start?
KeywordWhen the client’s message contains one of the words you typed. One word per line. Letter case and Turkish characters do not matter. You can choose Contains, Exactly matches or Starts with.
Any incoming messageEvery time the client writes (if they have no running flow).
First messageWhen the client writes to you for the first time.
Button replyWhen a button in another flow is pressed. You type the button ID (buttons are numbered b1, b2, b3 in order).
Form (Meta Flow) responseWhen the form you choose is filled in.
CRM eventWhen an event happens even if the client did not write (see below).

If the triggers of several flows match the same message, the flow created first runs. Avoid using the same word in two flows.

3. Steps

StepWhat it does
Text messageSends a plain message.
Button messageUp to 3 buttons (title up to 20 characters). Each button goes to its own path.
List messageA choice list of up to 10 rows (row title up to 24, description up to 72 characters). Each row goes to its own path.
TemplateSends an approved template. The only way to reach a client outside the 24-hour window.
MediaSends an image, video or document. The address must start with https://.
Send Meta FlowSends a published form to the client.
WaitWaits for a set time or waits for the client’s reply.
ConditionChecks a variable and splits into a Yes / No path.
Set variableStores a value to use in later steps.
HTTP requestSends a request to an outside system and saves the result in a variable.
Assign agentChanges the client’s agent.
Add to groupAdds the client to a group.
Create taskOpens a task. It is assigned to the client’s agent.
Change stageChanges the stage of the client’s latest meeting.
Hand off to humanThe flow stops and the chat is left to an agent.
EndEnds the flow.

Button message, list and form steps have a Timeout exit. If you enter minutes and the client does not reply in that time, the flow continues down that path. Leave 0 to wait indefinitely.

4. Variables

You can use variables in message texts with double curly braces:

VariableContents
{{customer_name}}The client’s name
{{phone}}Phone number
{{last_reply}}The client’s last reply (the title of the button they pressed, or the text they typed)
{{last_reply_id}}The ID of the button or row they chose
{{flow_fieldname}}A field from a filled-in form (example: {{flow_full_name}})
{{yourname}}A value you made with the Set variable step

In the Condition step, write the variable name without curly braces (example: last_reply).

5. Activating

A saved flow stays inactive. Switch it on with the toggle in the Flows list. Activation can be refused because:

If you edit an active flow and save it with something missing, the flow is switched off automatically. This stops a half-finished flow from reaching clients. Turn it back on when you finish editing.

Waiting and timing

Starting from a CRM event

You can start a flow on these events even if the client did not write:

EventWhen?
Meeting stage changedWhen a meeting’s stage changes
New ad leadWhen a new lead arrives from an ad
Quote accepted / rejectedWhen a quote’s status changes

These flows often start when the 24-hour window is closed. Make the first step a Template; a free-form message is rejected and the flow becomes Failed. If the client has no WhatsApp chat, the flow does not start.

Runs and errors

The Flows list shows In progress, Completed and Failed counts for each flow. The Runs button in the editor lists the last 50 runs with client name, status and error reason.

ErrorMeaning and fix
outside_24h_window24 hours have passed, so a free-form message could not be sent. Put a Template step at that point.
Template error (meta_...)Meta rejected the template: not approved, wrong number of variables or a different line. Check its status on the Templates page.
meta_flow_not_publishedThe form being sent is not published. Publish the form.
loop_or_step_limitThe flow is going in circles. Add a wait or an end to break the loop.
interruptedThe server restarted while the flow was running. Write to the client by hand if needed.

If a CRM action (task, agent, group, stage) fails, the flow does not stop; the error is written to the run record.

Creating a Meta Flow (form)

1. Create a draft

Flows → Meta Flows (forms) tab → New Meta Flow (form). Choose a name, line and category, then click Create and edit. The category tells Meta the purpose (Appointment, Sign up, Contact, Survey and so on); choose the right one.

2. Design the screens

Meta Flow screen editor

3. Save and validate

Save and validate uploads the form to Meta and runs Meta’s check. Errors are listed in the right panel; fix them and save again. The Preview button opens the form in Meta’s preview.

4. Publish

When no errors remain, click Publish. A published form can no longer be changed. If you need a change, create a new form. A published form cannot be deleted; drafts can.

5. See the responses

You send the form to the client with the Send Meta Flow step in a bot flow. When the client fills it in, the responses show as a table with the client’s name on the page that opens when you click the response count in the Meta Flows list.

Example: appointment request

  1. Trigger: Keyword “appointment”.
  2. Send Meta Flow: “Please fill in the appointment form” (form: name, date, preferred time).
  3. Create task: Title “Appointment: {{customer_name}}”.
  4. Text message: “We received your request and will get back to you soon.”
  5. End

You can connect the form’s Timeout exit, set to 60 minutes, to a Text message step that says “If you would like to fill in the form, write to us”.

Frequently asked questions

My flow never starts. Check that the flow is active, the right line is selected and the word appears in the message. The same flow may already be running for the client; check Runs.

The client pressed a button but the flow ended there. That button’s exit is not connected to a step; an unconnected exit counts as the end of the flow. In the editor, make sure every button and the Timeout exit are connected.

Can I write while a flow is running? Yes. Agent messages do not stop the flow. To hand the chat over completely, use the Hand off to human step.

What if I delete a flow? Its running instances are ended too; no more messages go to the client.

Do bot messages affect the “first response time” report? Yes. A bot reply counts like an agent reply.

Limits