Home/Help Center/Flow Builder

Automation

Build Chatbot Flows: Nodes, Triggers and Testing

A working guide to VGraple CRM's Flow Builder: adding nodes, wiring branches, picking a trigger, activating a flow, and testing it safely on your own number.

By Chirag Darji · Updated 11 Nov 2026 · 11 min read

On this page
  1. Before you start
  2. Steps
  3. What you will see
  4. Settings and options
  5. Troubleshooting
  6. Related reading
Booking bot in the Flow Builder canvas: a trigger, a greeting, quick replies that lead to a booking message, an AI answer or a human handoff

Flow Builder is the drag-and-drop canvas where you wire together an automated WhatsApp conversation: a trigger that starts it, a chain of nodes that send messages, branch on a customer's answer, wait, call an API, or bring in a human, and edges that connect them. This article covers how to actually build and test a flow, once you already understand what a single node does; for the field-by-field reference of every node type, see the flow node reference.

Flow Builder: first 5 of 8 steps

  1. 1Open Flow Builder and start a flow
  2. 2Configure the trigger node
  3. 3Add steps to the canvas
  4. 4Connect nodes with edges
  5. 5Fill in each node's settings
The steps on this page, in order.

Before you start

  • Any Owner or Admin can create and edit flows by default; the permission is "Create flows," and most custom roles that include it can too.
  • Flow Builder has no plan gate and no cap on the number of flows or nodes. What a plan sets elsewhere is agent seats and stored contacts; conversations are unlimited on every plan.
  • Testing a flow on a real customer channel requires a connected WhatsApp number. You can build and save a draft flow without one, but the "message yourself" test step needs a live connection.
  • The AI Reply node works on every plan and uses AI credits: 1,000 are free each month, and an AI reply costs 10.
  • Decide your trigger before you start placing nodes. A flow with no trigger set still saves, but it never fires until you configure one; see flow triggers for the six trigger categories.

Steps

  1. Open Flow Builder and start a flow. From the sidebar, open Automation, then Flow Builder, type a name in the Flow name field and click New Flow. Give it a name that describes what it does rather than when you built it ("Price enquiry auto-reply" reads better six months from now than "Flow 3").

Flow Builder list in VGraple CRM with each flow's status, trigger and number of runs

  1. Configure the trigger node. Every new flow starts with a trigger node set to Keyword / Inbound Message. Click it and either type one or more comma-separated keywords, or leave the field blank so the flow catches any inbound message that no keyword flow claimed first. Switch the Trigger Type dropdown if you want a different trigger: Customer goes quiet, Contact enters a Segment, Contact receives a Tag, Contact field changes, Appointment Booked, Appointment Reminder, Appointment Completed, Form Submitted, or New lead arrives.

  2. Add steps to the canvas. Click the green Add step button in the toolbar at the top left of the canvas (or press N) to open the searchable list of step types: Send Message, Send Template, CTA Button, Image Carousel, Quick Replies, Request Location, Contact Card, WhatsApp Form, Send Product, Wait for Reply, Wait until quiet, Delay, Condition, Set Variable, API Call, Action, Human Handoff, AI Agent, AI Reply (simple) and End Flow. Pick one and it appears in the middle of the screen with its settings open; drag it wherever you want it. To add the next step straight after another, click the green + under an exit that has no line yet: the step you pick is placed below, already connected. On steps with several exits (Condition, Wait for Reply and AI Agent) the + shows when you point at or select the step. Tidy up in the same toolbar lines every step up top to bottom with no overlaps (an Undo button shows for 10 seconds afterwards), and the button beside it fits the whole flow on screen. A small map of the whole flow sits at the bottom right and the zoom buttons at the bottom left.

  3. Connect nodes with edges. Drag from the small handle at the bottom of one node to the top of the next to wire them together. A Condition node exposes two handles, labeled true and false, so you can connect a different next step to each outcome; a Quick Replies node with more than one button exposes one handle per button.

  4. Fill in each node's settings. Click any node to open its Step settings on the right side of the screen; the X, Esc or a click on empty canvas closes them, and you can drag the panel's left edge to make it wider. Every step card on the canvas is the same width and shows two lines of its message, and the full text is in the settings. On a phone, use the Add step and Properties buttons in the bottom bar. A Send Message node needs body text; a Send Template node needs a template name, language and variable mapping; a Delay node needs a duration or a relative-to-appointment offset; an AI Reply node needs a system prompt and, optionally, a knowledge base. Use {{name}} and {{phone}} to personalize any message with the contact's own details, or {{variable_name}} for a variable set earlier in the flow (by a Quick Replies choice, an API Call response, or a Set Variable node).

  5. Save and activate. Click Save in the editor, then click Activate on the flow's row in the Flow Builder list. Only Active flows respond to real inbound messages or events; Draft flows exist but never fire.

  6. Test it on your own connected number. Message your own WhatsApp number with the trigger keyword (or trigger the event another way, such as booking a test appointment). There is no separate sandbox environment for flows; the live number is the test environment, so you exercise the exact node graph a real customer will run.

  7. Watch the run counter and refine. Each flow's list entry shows how many times it has executed. Open it again to tighten a reply, add a branch, or connect a Human Handoff node once you have seen it run for real; every change applies to executions that start after you save.

A flow follows one line from each output. If you draw a second line from the same output (for example two lines from the Trigger), the builder refuses it and tells you which step the first line already leads to, and a flow that already has two lines shows a warning above the canvas. A flow with two lines, or a step connected to itself, cannot be switched on until you fix it. To send two things in a row, put the steps one after another: Trigger, then the first message, then the second.

The warning above the canvas has one button for each line that causes a problem, for example Remove the line to the first message (the one that runs) and Remove the line to the second message (never runs). Press a button to remove that line, then press Save. You do not need to find the thin line on the canvas, which helps on a tablet or phone. On a touch screen the lines, the delete cross, the connection dots and the zoom buttons are larger, and a line connects when you drop it near a dot. To connect two steps, touch the dot under the first step and drag to the dot above the second.

What you will see

An active flow with a keyword or catch-all trigger answers a matching WhatsApp message within seconds of it arriving, day or night, without anyone on your team touching a keyboard. The flow's run counter on the Flow Builder list increases by one for every execution, whether it started from your own test message or a real customer's. Inside the conversation thread, every message a flow sends is visible exactly like a message an agent sent manually, including a logged entry when a free-form node could not send because the 24-hour window was closed.

Settings and options

Setting or fieldWhat it doesDefault
Flow statusDraft, Active, Paused or Archived; only Active flows respond to real triggersDraft
Trigger typeKeyword / Inbound Message, Customer goes quiet, Contact enters a Segment, Contact receives a Tag, Contact field changes, Appointment Booked, Appointment Reminder, Appointment Completed, Form Submitted, or New lead arrivesKeyword / Inbound Message
KeywordsComma-separated list; leave blank to catch any message no keyword flow claims firstBlank
Run counterHow many times the flow has started an execution0
24-hour window guardApplies automatically to every free-form send node; template nodes are unaffectedAlways on, not configurable
Opt-out and block checkRuns before every node in the graph, including on resume after a waitAlways on, not configurable
Version historyNot available; duplicate a flow before a risky edit to keep a fallback copyNot saved

Troubleshooting

SymptomLikely causeFix
Nothing happens when I message the trigger keywordThe flow is still in Draft statusClick Activate on the flow's row in the Flow Builder list
A step after the Trigger never runs, or the builder refused a lineTwo lines were drawn from the same output, and a flow follows only the firstPress the Remove the line button in the warning above the canvas, then connect the steps one after another
I cannot tap or delete a line on my tabletA line is thin and there is no Backspace key on a touch screenUse the Remove the line buttons in the warning, or tap the line and press the red cross that appears on it
Two nodes seem connected but the flow skips oneThe edge was dragged to the wrong handle, commonly on a Condition or Quick Replies node with several handlesDelete the edge and reconnect it from the exact labeled handle (true, false, or the specific button)
A scheduled message never arrives after a multi-day DelayA free-form node hit the closed 24-hour service window and logged a failed message instead of sendingOpen the conversation to confirm, then switch that step to a Send Template node, which is unaffected by the window
The flow ran once for a contact and never againOnly one active execution of a given flow per contact is allowed at a time; a second trigger while one is still running or waiting is a no-opThis is expected behavior; if you want repeatable triggers, check whether the earlier execution finished or is still waiting on a Wait for Reply or Delay step
A conversation that was waiting part-way through a flow continued differently, or stopped, after you edited the flowRuns read the flow as it is now, so a waiting run follows your edit, and a run waiting at a step you deleted endsStart the conversation again from your own number to test the new version; make large edits while no run is waiting
The AI Reply node tells the customer their message was passed to your team, and the chat shows Needs a personNo usable AI connection or no AI credits left, or the connection saved on the node has since been removedCheck the connections in Settings, then AI; VGraple AI needs no key, and the node falls back to another usable connection automatically

Once your nodes are in place, check flow triggers for every way a flow can start, and the flow node reference for the exact fields each node type takes. If this is your very first flow, the shorter build your first flow walkthrough covers the same ground with fewer moving parts.

Frequently asked questions

What is the difference between Flow Builder and the AI chatbot?
Flow Builder is the canvas where you wire together a scripted conversation from 20 node types, including an AI Reply node for open-ended turns. The AI chatbot is one of those nodes, or a separate chat widget on your website; Flow Builder is the tool you use to place it inside a larger, more predictable conversation.
Can I edit a flow that is already active and being used by customers?
Yes. Edits save immediately and apply at once, to new runs and to runs already waiting part-way through a conversation: a waiting run carries on through the flow as it is now, and a run waiting at a step you deleted ends there. Make big changes while no test or customer run is waiting, or on a copy of the flow.
How many nodes can one flow have?
There is no node-count limit in the product. In practice, flows with dozens of nodes get harder to read on the canvas, so most businesses split a genuinely large conversation into two flows connected by a Human Handoff or a shared tag rather than building one enormous graph.
Does Flow Builder have undo or version history?
Not yet. There is no saved history of past versions and no rollback button; a flow only has draft, active, paused and archived states. Duplicate a flow before making a risky change so you have a working copy to fall back on.
Why does my flow only reply once and then stop?
Most likely the flow ends after one Send Message node with nothing connected after it, which is valid but leaves the conversation with nowhere to go. Add a Quick Replies node, a Condition node, or a Human Handoff node after the first reply so the conversation has a next step.
Can two flows run for the same contact at the same time?
A contact can only have one active execution of any single flow running or waiting at once; starting the same flow again while one is in progress is a no-op. Different flows (for example a keyword flow and a sequence) can run in parallel for the same contact, since each is tracked as its own execution.
What happens to a flow execution if the contact opts out mid-conversation?
The executor checks the contact's opt-out and blocked status before running every node, not just at the start. A STOP received while a flow is mid-run, including while it is sitting in a Delay or Wait for Reply step, cancels the execution the moment it would otherwise resume.

Run your WhatsApp on VGraple CRM

Free forever plan, official Meta WhatsApp Business API, set up in 15 minutes. No card needed.