PulbotDocumentation

Your first flow

A flow is a visual automation: it defines what happens when a message arrives on your channel. You build it by connecting nodes (steps) on a canvas. Each node executes a tool (logic, API call, AI, condition, etc.).

When to use it

When you want your bot to respond to messages automatically, run logic, or call an external API — without writing code.

Steps

  1. 1In the dashboard, click «Flows» in the left sidebar.
  2. 2Click «New flow» and give it a descriptive name (e.g. «WhatsApp Welcome»).
  3. 3The empty canvas opens. Click «+ Add node» in the left panel.
  4. 4Add a Trigger node first: select the channel from which messages will arrive.
  5. 5Add a second node with the logic you want to execute (e.g. send a reply message).
  6. 6Connect the nodes: drag from the Trigger's output point to the next node's input.
  7. 7Click «Run» (top right) to test the flow with a simulated event.
  8. 8When ready, activate «Production mode» so the flow runs with real incoming messages.

Reference

Canvas
The workspace where you drag and connect nodes. Supports zoom and pan.
Node
A unit of execution. Each node has one associated tool with its own configuration.
Trigger
Special start node. Defines which channel and condition starts the flow.
Transition
Arrow connecting two nodes. Defines execution order and condition (always, on success, on error).
Connectors
Securely stored credentials for an external service (WhatsApp, OpenAI, HTTP Basic, etc.). Nodes reference the connector, not the secret directly.
Variables
Data that travels through the flow. Referenced as {{variableName}} in downstream node configs.
Production mode
When active, the flow runs with real channel events.
Export
Button in the top bar (download icon). Saves the flow as a reusable .json template.

Common errors

«No nodes to execute»
The canvas is empty. Add at least a Trigger and one action node.
«The flow has no Trigger»
Add a Trigger node and connect it to the rest of the flow.
«Disable production mode to test»
You can't simulate a flow in production mode. Disable it first.
Node turns red after run
The node failed. Click it to see the detailed error in the right panel.

Next step

Read the key concepts to better understand each element of the flow builder.

¿Necesitas ayuda?