Skip to main content
Immediately stops workflow execution and transfers the conversation to human agents. Sets the workflow status to ‘handoff’ and prevents further automated processing.

​
Configuration

  • id: Unique node identifier
No other configuration needed - handoff nodes simply trigger the transfer.

​
Workflow library example

workflow.addNode("handoff_to_team", {
  type: "handoff",
  reason: "needs_human",
  contextData: {
    priority: "{{vars.priority}}"
  }
});

​
How it works

  1. Stops execution: Immediately halts automated workflow processing
  2. Sets status: Changes workflow execution status from ‘running’ to ‘handoff’
  3. Prevents messages: Blocks further automated message processing
  4. Requires intervention: Human agents must manually handle the conversation

​
Usage patterns

Escalation workflow