Flow builder basics

A bot in Zapito is one flow: a small graph of nodes on a canvas. A message arrives at a trigger, walks the wires through your logic, and a reply (or a human handoff) comes out the other end.

The canvas

• Pan by dragging the background, zoom with the scroll wheel.
• Add nodes from the node library (the panel on the left), or let the AI builder wire them for you.
• Connect nodes by clicking an output port, then the input port of the next node. Curved wires show the message path.
• Click a node to open its config drawer — every field is described in the node reference.

Two kinds of connections

• Flow wires (solid) carry the conversation: trigger → agent → condition → reply / handoff.
• Resource wires (dashed, into the agent’s bottom port) attach capabilities: a Knowledge Base or a Custom Tool. They don’t carry messages — they tell the agent what it knows and can use.

A typical support flow

WhatsApp Trigger ── AI Agent ── Confidence Check ──(Confident)── Send Reply
                       ▲                └─────────(Unsure)────── Human Handoff
                       ┆
                Knowledge Base

The agent answers from your knowledge, reports how confident it is, and the confidence check routes sure answers to the customer while unsure ones go to a teammate.

Testing

The Test chat panel runs your flow against the real engine — same code as production channels. Each turn shows a trace: which trigger fired, what the model replied and with what confidence, which branch the condition took. Wires animate along the path while a test runs.

Saving and bot states

Changes save automatically (debounced — closing the tab flushes a final save). From the bot card menu you can pause a bot: paused bots are silenced on every channel until you resume them. Deleting a bot removes its flow and channel connections.