Working with Nodes

Nodes are the individual steps in a conversation flow. Each node performs a specific action -- sending a message, calling an API, making a decision, or handing off to a human agent.

Adding Nodes

There are three ways to add a node to the canvas:

1. Drag from Nodes Panel: Open the left sidebar, find the node type you want, and drag it onto the canvas.
2. Right-click menu: Right-click on the canvas and select Add Node to open a searchable picker.
3. Quick-add from edge: Drag from an existing node's output handle and release on empty space. A node picker appears, and the new node is automatically connected.

Node Categories

Nodes are organized into categories in the Nodes Panel:

Category	Node Types	Purpose
Conversation	Send Message, Quick Replies, Rich Content, Collect Input	Send content to the user or collect input
AI & Knowledge	LLM Response, RAG Query, KB Search	Generate AI responses and search knowledge bases
Logic & Flow Control	Condition, Set Variable, Intent Router, Loop, Delay, End	Control execution flow and manage data
Integration	API Call, Handoff, Email, SMS, Salesforce	Connect to external systems and live agents
NLU & AI Agents	Dialogflow CX, Google ADK, CX Agent Studio, CX Multi-Agent	NLU, intent detection, and agent delegation
Voice	IVR Menu, Voice Prompt, Voice Input	Voice-specific interactions (TTS, ASR, DTMF)
Authentication	Authenticate	SSO-based user authentication
Visual	Group, Sticky Note	Canvas organization (non-executable)

imageNodes panel in left sidebar showing expandable categories: Conversation, AI & Knowledge, Logic & Flow Control, Integration, NLU & AI Agents, Voice, Authentication, and Visual

The Nodes Panel with node categories

Configuring a Node

Click any node on the canvas to open the Config Panel on the right side. The panel shows:

• Node Name: A display label (editable). Use descriptive names like "Check account status" instead of "API Call 1".
• Node Type: Read-only, shows the type (e.g., llm_response, condition).
• Properties: Type-specific settings. Each node type has different configuration options.

TIP

Give every node a descriptive name. When you have dozens of nodes on the canvas, clear names make the flow much easier to understand and debug.

imageConfig panel on the right side showing node name, type, integration selector, system prompt, temperature, and output variable fields for an LLM Response node

The Config Panel showing node properties

Common Node Properties

These properties appear on most node types:

Property	Description
Name	Display name shown on the canvas
Description	Optional note explaining what this node does
Output Variable	The variable name where this node stores its result
Enabled	Toggle to enable/disable the node (disabled nodes are skipped)

Duplicating Nodes

Select one or more nodes and:

• Press Ctrl+D, or
• Right-click and select Duplicate

Duplicated nodes are placed slightly offset from the originals. Their configuration is copied, but edges are not duplicated -- you need to reconnect the new nodes.

Deleting Nodes

Select one or more nodes and:

• Press Delete or Backspace, or
• Right-click and select Delete

WARNING

Deleting a node removes all edges connected to it. You cannot delete the Start node -- every flow requires exactly one.

Copy and Paste

You can copy nodes across flows:

1. Select nodes and press Ctrl+C.
2. Switch to another flow (or stay in the same one).
3. Press Ctrl+V to paste. Nodes appear near the center of the current viewport.

Node States

Nodes display visual indicators on the canvas:

Indicator	Meaning
Blue border	Currently selected
Green dot	Node executed successfully (in test mode)
Red dot	Node encountered an error (in test mode)
Gray overlay	Node is disabled
Yellow badge	Node has validation warnings (e.g., missing configuration)

Validation

The flow builder validates your configuration in real time. Common validation issues:

• A node with no incoming connections (unreachable)
• A required field left empty (e.g., LLM Response without an integration)
• A Condition node with no rules defined
• Circular references that could cause infinite loops

Validation warnings appear as yellow badges on affected nodes and are listed in the Issues tab of the bottom panel.