Understanding Nodes & Handlers

Node types

There are different types of nodes, and each one is designed to handle a specific task within a flow.

• Trigger Node: A Trigger defines how a user enters a flow. It is the entry point that allows a flow to start automatically in response to an Instagram event.
• Instagram Node: sends content (text/image/movie/buttons/quick replies/cards/gallery)
• Condition Node: checks rules (tags, fields, follower status, etc.) and branches
• User Input Node: asks a question and saves the user’s answer into a field
• Action Node: updates contact data (tags/fields)
• Delay Node: waits before moving to the next step (up to your platform limit)
• Another Flow Node: runs a different flow and returns

 Editing a Node by Node Settings Panel

To edit any node in the Flow Builder, you must first click on the node itself.

Below is an example of a Trigger node’s settings panel.

When you click on a node, its settings panel opens on the left side of the screen.
This panel is where you configure everything related to that node.

For example, with the Trigger Node, you can:

• Select the trigger type (for example, when a user sends a message)
• Configure keywords that activate the flow

If you don’t see the settings panel, there are two possible reasons:

1. Make sure the node is selected.
   Click on the node in the canvas to display its settings panel.
2. The settings panel may be collapsed.
   If the node is selected but the panel is still not visible, click the panel toggle icon (highlighted below) to expand the settings panel.

What is a Handler?

Handlers are the connection points used to continue a flow.

A handler appears as a circular element and can belong to a node, a button, or a quick reply.

Handlers are marked with red circles in the image below.

Handlers are used to define what happens next when the flow continues or when a user interacts with an element.

Each handler connects the current step to the next part of the flow.

Adding the Next Node

To add a new node:

1. Move your mouse over the handler of the node, button, or quick reply where you want the flow to continue
2. Slightly move the mouse until the hand icon (👆) appears
3. Click the hand icon to open the node picker
4. Select the node type you want to add

The selected node will be connected automatically.

For example, in the image below, we selected the Instagram node from the node picker.

What is a Connection Line

Elements are connected through paths that define the execution order. A connection represents the transition from one step to the next.

Removing Connection Line

Sometimes you may want to edit a flow and remove an existing connection between two steps to change the structure.

Solution 1: Delete the connection using the trash icon

Click the connection line to select it.
Once selected, a red outlined trash icon appears on the line.

Move your mouse over the trash icon.
When hovered, the icon turns solid red, indicating it’s ready to be clicked. Click the trash icon to delete the connection.

Solution 2: Delete the connection using the keyboard

Click on the connection line to select it.
Once selected, press the Delete key on your keyboard to remove the connection.

 Removing connections allows you to safely reorganize and refine your flow logic.

Reconnecting Elements (Drag & Connect)

Sometimes while editing a flow, you may already have two elements with content configured and want to connect them together without recreating anything.

You can change existing connections or connect elements by dragging handlers, without deleting nodes or losing their content.

1. Move your mouse over the handler of the source element (the node, button, or quick reply you want the flow to continue from).
2. Slightly move the mouse until the cursor changes to a plus (+) icon.
3. Click and hold the left mouse button, then drag the connection line toward the destination element’s handler.
4. Release the mouse over the destination handler to create the new connection.

Once connected, a new connection line appears between the two elements.