Skip to main content
The Conditional node acts as a decision point within your flow: it evaluates information you already have about the user and decides which path to take. Think of it as a fork in the road — depending on what the user responds or the data they have, the conversation will follow one route or another. The node panel is organized into two tabs:
  • General — define the paths, their rules, and the sensitive data protection (DLP).
  • Events — register tracking events that fire when the node runs, feeding your metrics.

Key concept: paths and rules

Before configuring, it is important to understand two concepts:
  • Path: a route the conversation can follow. Each path has a descriptive name and one or more rules that must be met for it to activate.
  • Rule: an individual condition that compares a variable against a value. For example: “the user’s age is greater than or equal to 18”.
If a path has multiple rules, all of them must be met for that path to activate (AND logic). If you need it to activate when any of the conditions is met, create separate paths for each one.

Default path: “Otherwise”

Every Conditional node automatically includes a path called “Otherwise” (fallback). This path activates when none of the other paths are met. It is your safety net to ensure the conversation always has a path to follow.

Step-by-step configuration

1

Create a new path

Click “New path” to add your first condition. Give it a descriptive name that helps you quickly identify what it evaluates (for example: “Adult”, “Premium customer”, “Business hours”).
2

Configure the first rule

Each rule has three parts:
  1. Variable — the data you want to evaluate (for example, {{$memory.age}})
  2. Operator — how you want to compare that data (for example, “Greater than or equal”)
  3. Value — what you compare it against (for example, 18)
3

Add more rules if needed

If you need multiple conditions to be met at the same time, click ”+” inside the same path to add additional rules. All rules within a path are evaluated with AND logic (all must be true).
4

Create additional paths

Repeat the process for each alternative route you need. Each path is evaluated in order: the first one that is met will be the one executed.
5

Connect the following nodes

Each path (including “Otherwise”) has a connection point on the right. Drag a line from each point to the node that should execute on that route.

Available operators

Operators define how the variable is compared to the value. They are organized into four categories:

Equality comparison

Numeric comparison

Type validation (Is of type / Is not of type)

The Is of type and Is not of type operators allow you to verify whether a variable corresponds to a specific data type. Instead of entering a value, you select the type from a list: Example: {{$memory.email}} Is of type → Email verifies that what the user entered has an email address format.

Empty check

The Empty and Not empty operators do not require a comparison value — they only evaluate whether the variable has content or not.

Regular expressions (Regex)

Regular expressions are an advanced tool. If you are not familiar with regex, the other operators cover most common scenarios.

Evaluation logic

The Conditional node evaluates paths from top to bottom, in the order they appear in the panel. The first path whose rules are met will be the one executed.
You can reorder paths by dragging them with the grab icon (⠿) that appears to the left of each path. This is important because the order affects which one is evaluated first.

AND vs OR logic


View modes

The configuration panel offers two display modes you can toggle with the view button in the upper corner:
  • Expanded view: shows each rule as a card with descriptive labels (Variable, Operator, Value). Ideal when you are configuring conditions for the first time.
  • Compact view: shows each rule on a single horizontal line. Ideal when you already know the conditions and want a quicker overview.
Beyond reordering paths, you can delete any of them with the trash icon in each card’s header and add rules to a path with the + button. Removing a path automatically disconnects the node linked to that output.

DLP (Data Loss Prevention)

At the bottom of the General panel you’ll find the DLP section, which automatically masks sensitive data flowing through the node before it is stored in logs or sent to integrations. Enable the “Enable DLP” toggle to open the info-type selector.
1

Enable DLP

Turn on the toggle to reveal the type selector.
2

Select the sensitive data types

Choose which types must be detected and masked:
Credit card number is always selected and cannot be disabled: it is the minimum type protected whenever DLP is active.
DLP applies to the values the node evaluates. It does not modify the message the user sees or the contents of your memory — it only masks sensitive information in the records left by the node’s execution.

Events

The Events tab lets you register up to 10 tracking events per node, each with a name and up to 5 custom properties in the payload. Every time the Conditional runs, the active events fire and feed your Metrics panels.
1

Add an event

Click “Add event” and enter a name in snake_case (for example, premium_path_activated). If the name does not match the format, you’ll see the error “Must be snake_case”.
2

Define the payload (optional)

Under “Event properties” add up to 5 key/value pairs. The value can be plain text or an evaluable variable such as {{$context.user_id}} or {{$memory.customer_type}}.
3

Enable or disable events

Each event has an independent toggle. Disabled events do not fire but are kept so you can reactivate them later. From each item’s menu you can edit or delete them.
See the full node events guide for limits, best practices, and analysis examples.

Practical examples

A flow that needs to verify whether the user is of legal age:The “Adult” path activates if the age is 18 or more. Any other case continues through “Otherwise”.
A flow that directs premium customers from Colombia to a special flow:In “Premium Colombia”, both rules must be met (AND): the country must be Colombia and the customer type must be premium. If only the first is met, the flow moves on to evaluate “Regular Colombia”.
A flow that validates whether the user entered an email address:If the data has an email format, it continues through “Valid email”. If not, you can use the “Otherwise” path to ask the user to enter it again.
A flow that detects keywords in the user’s message:Each path is independent (OR logic): if the message contains “cancel”, it follows the first route; if it contains “help”, the second, and so on.