Concepts
Understand nodes, edges, flow lifecycle, and versioning in the Flow Builder.
Nodes
Nodes are the building blocks of every flow. Each node has a specific role and configurable properties.
Node categories
| Category | Purpose | Examples |
|---|---|---|
| Agent | Handle conversation segments | Main Agent, Agent |
| Provider | Supply AI services to the flow | LLM, TTS, STT |
| Action | Execute side effects during a call | Function, Webhook, End Call, Forward Call, TTS Say |
Every flow requires at minimum: one Main Agent node, one LLM provider, one TTS provider, and one STT provider.
Edges
Edges are the connections between nodes. They define how data and conversation flow through the graph.
- Agent → Agent: Transition edges. The conversation transfers from one agent to another when a defined condition is met.
- Provider → Agent: Service edges. Connect an LLM, TTS, or STT provider to the agents that use it.
- Agent → Action: Trigger edges. Actions fire during or after an agent's conversation turn.
Draw an edge by dragging from a node's output handle to another node's input handle.
Flow lifecycle
Every flow moves through a defined set of states:
DRAFT → TESTING → PUBLISHED → ARCHIVED| State | Editable | Callable | Assignable to numbers |
|---|---|---|---|
| DRAFT | Yes | No | No |
| TESTING | Yes | Test calls only | No |
| PUBLISHED | No | Yes | Yes |
| ARCHIVED | No | No | No |
State transitions
- DRAFT → TESTING — Enable test mode to start making test calls
- TESTING → PUBLISHED — Publish the flow after validation passes. Creates an immutable snapshot.
- PUBLISHED → ARCHIVED — Retire the flow. Removes it from active use and unassigns all phone numbers.
A published flow cannot be edited. To make changes, create a new version from the published flow — this starts a new draft with the same configuration.
Versioning
Each time you publish a flow, Talkif creates a new version. Previous versions are preserved and accessible in the version history.
- Published versions are immutable — they cannot be modified
- You can view any previous version's configuration
- Creating a new version from a published flow copies all nodes, edges, and configuration into a new draft
- Phone numbers always point to a specific published version