The canvas
Each node is one step from Node types — a box with a type, its own configuration, and a position. Edges connect them. This is a direct view of what actually gets saved: the same nodes-and-edges structure the engine walks when a real conversation runs the flow.Add a node
Drag one in from the library, or click a library entry to drop it, unconnected, at the centre of the
viewport — clicking doesn’t draw an edge to it. To append a node after the one you’re working on
instead, use the separate “append” control on the selected node’s Step panel, which both creates the
node and connects it for you.
Connect it
Draw an edge from one node to the next.
branch_on_reply is the exception — its edges come from the
match clauses in its own configuration rather than from a line you draw, so the canvas renders those
connections for you once the clauses exist. Configuring those clauses from the canvas is coming
soon — see Branching and variables for what that means today.Select it
Click a node to open its configuration in the side panel.
The side panel does three jobs
The panel on the right is one surface with three states, not three separate panels:
Selecting a node switches the panel to Step automatically. Deselecting, or toggling the simulator on, switches it back.
The simulator panel
Opening the simulator replaces the library/inspector view with a chat log: type a message, see how the flow responds, reset and try again. It runs against the graph exactly as it sits on your canvas — including edits you haven’t saved anywhere yet. That’s worth its own page — see Testing and simulation for what it faithfully reproduces and what it doesn’t.Saving what you build
The header shows Save draft and Publish while a flow isn’t live — both write your graph somewhere, and what they actually do is not fully explained by the labels. Once the flow is live, Publish is replaced by the Live toggle, and Save draft becomes the only save control — it still republishes immediately. Read Versions and publishing before you rely on any of them.Who can do this
Building and editing a flow requires an account administrator. See Roles and permissions.Next
Node types
What each block in the library actually does.
Versions and publishing
What the two save controls really do, and what happens to conversations already running.
Testing and simulation
What the simulator gets right, and the node types it fakes.
Branching and variables
How connections work for branch_on_reply specifically.