Overview

Documentation Index

Fetch the complete documentation index at: https://docs.kapso.ai/llms.txt

Use this file to discover all available pages before exploring further.

Workflows are directed graphs where nodes execute sequentially. Each node performs a specific action—sending messages, waiting for input, routing logic, or executing code.

​

Node categories

Start node - Entry point

• Triggers when a message arrives or API calls the workflow
• Every workflow has exactly one Start node
• Automatically advances to the first connected node

Action nodes - Execute and continue

• Send messages (text, templates, interactive)
• Execute functions
• Call webhooks and connected app actions
• Set workflow variables
• Call other workflows
• Transfer to human agents (handoff)
• Execute immediately and advance to next node

Wait nodes - Pause for input

• Halt workflow execution until user responds
• Store response in {{last_user_input}} or custom variable
• Resume execution when message arrives

Decide nodes - Route execution

• Branch workflow to different paths
• Use AI to interpret intent or custom function logic
• Return label determines which edge to follow

Agent nodes - AI conversations

• Multi-turn conversations with tool access
• Can call webhooks, functions, and app integrations
• Maintains execution at node until complete_task tool is called
• New user messages automatically injected during conversation

​

Execution flow

Workflows follow edges between nodes. Execution continues until:

• Reaching a Wait node (pauses for user input)
• Reaching an Agent node (remains at node until agent calls complete_task)
• Reaching a Handoff node (stops, transfers to human)
• No more connected nodes (workflow completes)

​

Learn more