Chatflow builder
The visual editor for designing chatflow conversation trees.
The Chatflow builder opens when you click into a Chatflow from the list at /chatflows. It gives you a drag-and-drop canvas to lay out the conversation your bot will have, a node palette on the left, and a save control in the heading bar.
Layout
The builder has three areas:
- Node palette — a collapsible panel on the left listing all eight node types. Type in the search box to filter.
- Canvas — the main editing area where you position and connect nodes. Powered by the same graph library as the Workflow canvas.
- Node config modal — opens when you click Configure inside a node card. This is where you set the node's message text, options, fields, or script.
A Test button in the heading bar opens the test panel on the right so you can simulate a conversation without leaving the builder.
Building a conversation
Add a node
Drag a node type from the palette and drop it onto the canvas. A node card appears at the drop position.
Every Chatflow must have exactly one Start node. The Start node sends the bot's opening message; drag it first.
Connect nodes
Hover over a node to reveal its handles — a circle on the right edge (source) and one on the left edge (target). Drag from a source handle to a target handle to draw an edge.
Decision nodes have multiple source handles: one per configured option plus an else handle for replies that do not match any option.
Configure a node
Click Configure inside any node card to open its configuration modal. Each node type has its own set of fields — for example, Message lets you write the text the bot sends, and Form Input lets you define the fields you want to collect.
Close the modal to return to the canvas. The node card previews the saved configuration.
Save
Click Save in the heading bar to persist the current nodes and edges. EzFlow stores the graph; no versioning or commit step is required for Chatflows.
How it differs from the Workflow canvas
| Chatflow builder | Workflow canvas | |
|---|---|---|
| Node palette | Eight conversation-specific node types | Dozens of node types across categories |
| Versioning | No branches or commits — save replaces the current definition | Branch and commit model |
| Triggers | None — a Chatflow is started by the CHATFLOW Workflow node | Trigger node required as entry point |
| AI builder | Not available | AI-assisted builder panel |
Related
- Node types — what each node does and when to use it
- Sessions — how in-progress conversations are tracked
- Chatflows overview — the difference between Chatflows and Workflows