Nodes & Connections
Nodes are the building blocks of your bot. Each node does one specific thing, and you connect them together to create flows.
What is a Node?
A node is a single step in your bot's flow. It could:
- Send a message
- Ask a question
- Check a condition
- Store data
- And much more!
Node Anatomy
Every node has these parts:
1. The Title Bar
Shows the node type and helps you identify what it does at a glance.
2. Input Sockets (Left Side)
Where data and flow comes in. The main one is usually labeled "In" or has a ⚡ icon.
3. Output Sockets (Right Side)
Where data and flow goes out. The main one is usually "Next" or "Out".
4. Configuration Panel
When you click a node, settings appear on the right side of the screen.
Connecting Nodes
To make your bot do things in sequence, you connect nodes with wires.
How to Connect
- Find the output dot on the right side of a node
- Click and drag to the input dot on another node
- A wire appears connecting them
The Flow Direction
Flows always move left to right:
- Left = Where the flow comes from
- Right = Where the flow goes to
Types of Connections
There are two types of connections:
⚡ Flow Connections (White/Yellow)
These control the order of execution. They're like saying "do this, then do that."
🔌 Data Connections (Colored)
These pass information from one node to another.
| Color | Data Type | Example |
|---|---|---|
| 🟢 Green | Text | "Hello world" |
| 🔵 Blue | Number | 42 |
| 🟣 Purple | True/False | true |
| 🟠 Orange | List | ["apple", "banana"] |
Example: Passing Data
Let's say we want to make a greeting dynamic:
- String Node creates the text "Hello!"
- Send Message receives that text and sends it
The string node's output (green dot) connects to the Send Message's text input.
Multiple Outputs
Some nodes have multiple outputs for different situations:
Condition Node Example
The condition has two outputs — one for each possible result.
Disconnecting Nodes
To remove a connection:
- Click the wire and press Delete, OR
- Drag the wire away from the dot
Tips for Clean Flows
- Keep flows left-to-right for readability
- Leave space between nodes
- Avoid crossing wires when possible
- Group related nodes together
Common Connection Patterns
Sequential (Do A then B)
Branching (Either A or B)
Merging (Both lead to same place)
Next Steps
- The Visual Editor → — Learn the interface
- Node Reference → — See all available nodes