Skip to content

👤 Human Handoff Node

Purpose

The Human Handoff node transfers the conversation from the automated assistant to a live human agent. It's a terminal node — the bot conversation ends here and a real person takes over.

Business Scenario

Use the Human Handoff node when you need to:

  • Escalate complex issues — questions the AI can't answer or situations requiring human judgement
  • Handle complaints — sensitive matters that need a personal touch
  • Close sales — transfer warm leads to your sales team
  • Provide VIP service — route high-value customers directly to agents
  • Create a safety net — always give customers the option to talk to a person

Configuration

Field Description
Title Internal name (e.g., "Transfer to Support")
Handoff Message The message sent to the customer before transferring (e.g., "Connecting you to a team member. Please hold…")
Agent Group Optional. The target queue or group name in your helpdesk (e.g., "support", "sales", "billing")

Properties

Property Type Required Default Description
title Text No "" Internal node name
handoffMessage Text Yes "Connecting you to a human agent…" Message sent before transfer
agentGroup Text No — Target agent queue/group

Inputs

Handle Type Description
Top (↑) Target Receives a connection from any preceding node

Outputs

None. Human Handoff is a terminal node — there are no outgoing connections.

Terminal Node

Once the conversation is handed off, automated replies are paused for that customer and the agent handles the conversation from this point.

What Happens After a Handoff

Every handoff creates a work item in the Action Center with its own ticket reference:

  1. The customer receives your handoff message, and automated replies are paused for that conversation.
  2. A ticket appears in the Action Center work queue, where your team can assign it to an agent, filter by My Queue, add internal notes, and see the full activity history.
  3. When the agent completes the handoff, the assistant automatically resumes for that customer — no keyword or manual reset needed.

Handoffs can also come from the assistant itself

Besides this node, a customer can reach a human via the Question node's recovery menu (Talk to Human, shown after repeated invalid input). Those handoffs land in the same Action Center queue.

Connection Rules

  • ✅ Can receive connections from any node type
  • ❌ No outgoing connections — the conversation ends here (no "dead end" warning)
  • ✅ Multiple nodes can connect to a single Human Handoff (common pattern)

Example Flow Diagram

Support Escalation Pattern

flowchart TD
    A["🤖 AI Chat<br/><em>Let me search for an answer...</em>"] --> B["📋 Was that helpful?"]
    B -->|"Yes!"| C["💬 Great! Anything else?"]
    B -->|"No, talk to agent"| D["👤 Human Handoff<br/><em>Connecting you to a team member...</em>"]
    C --> E["📋 Main Menu"]

    style D fill:#ffe4e6,stroke:#f43f5e,stroke-width:2px

Multi-Department Routing

flowchart TD
    A["📋 Department Menu<br/><em>Who would you like to speak with?</em>"] -->|"Sales"| B["👤 Sales Handoff<br/><em>agent group: sales</em>"]
    A -->|"Support"| C["👤 Support Handoff<br/><em>agent group: support</em>"]
    A -->|"Billing"| D["👤 Billing Handoff<br/><em>agent group: billing</em>"]

    style B fill:#ffe4e6,stroke:#f43f5e,stroke-width:2px
    style C fill:#ffe4e6,stroke:#f43f5e,stroke-width:2px
    style D fill:#ffe4e6,stroke:#f43f5e,stroke-width:2px

Best Practices

  • ✅ Write a reassuring handoff message — let the customer know help is coming.
  • ✅ Set expectations — mention typical wait times if possible (e.g., "You'll be connected within 2 minutes.").
  • ✅ Use Agent Groups to route to the right team — sales leads to sales, complaints to support.
  • ✅ Always offer Human Handoff as a menu option — customers should never feel trapped by the bot.
  • ✅ Place at the end of escalation paths — after AI Chat fails or after capturing complaint details.

Common Mistakes

Mistake What Happens Fix
No handoff message Customer sees nothing before transfer Add a clear handoff message
Handoff is unreachable Customers can never reach an agent Ensure it's connected to a menu option or fallback path
Wrong agent group name Handoff goes to the wrong queue or fails Verify the group name matches your helpdesk configuration
Using handoff as the only response Every question goes to an agent Add AI Chat or FAQ responses first; use handoff as a last resort
  • 🤖 AI Chat — Try AI first, then escalate to Human Handoff
  • 📋 Menu — Offer "Talk to Agent" as a menu option
  • 📥 Question — Capture details before handoff so the agent has context
  • ✉️ Send Email — Notify agents via email alongside the handoff