ZenotiHelp

Agent handover

ZTZenoti Docs Team Updated May 4, 2026 2 min readGuide

Transfer a conversation from SmartBot AI to a human agent in ezConnect when a guest needs personalized assistance that the AI cannot provide.

Audience: Administrators and staff managing the transition from AI to human-assisted conversations.

Before you begin

  • SmartBot must be provisioned and active.
  • Your organization must have ezConnect set up to receive handover conversations.
  • The agent handover message can be customized in General Settings.

How agent handover works

Triggering a handover

Agent handover is initiated under either of two trigger conditions:

  • Explicit guest request β€” A guest asks to speak with a person ("speak to staff", "agent please", or similar intent). This trigger is deterministic.
  • AI-judged repeat question β€” The AI detects that the guest has asked the same complicated question a second time without obtaining a satisfactory answer. This is a signal that the FAQ knowledge base did not resolve the request. The exact heuristic for this trigger is governed by the AI agent prompt and may evolve.

The agent handover option is available at any point in any conversation, including during active booking, cancellation, or FAQ flows.

What happens during handover

  1. SmartBot sends one of two configured messages to the guest β€” a Sorry message informing them of the transfer, or a confirmation that a staff member has been notified. Which message appears is governed by the configured agent handover prompt in General Settings.
  2. Dual notification is emitted simultaneously:
  • ezConnect receives a handover notification so the assigned human agent can pick up the conversation with full conversation context preserved.
  • The SmartBot Inbox displays a handover popup with an option to switch to ezConnect for the conversation.
  1. After the handover, the guest can continue using SmartBot for unrelated questions in the same conversation. Handover does not lock the conversation against further bot interactions.

Fallback when ezConnect is not in use

For organizations that do not use ezConnect, SmartBot provides a fallback in which it returns the business's contact information instead of attempting an in-product transfer. The guest then reaches the business through the published phone number or email rather than through ezConnect.

Handover message customization

You can customize the message SmartBot sends to guests when a handover occurs. This message is set in General Settings under the agent handover configuration.

Viewing handed-over conversations

In the SmartBot Inbox, you can filter conversations by Agent Handover to see all conversations that have been transferred to a human agent. This helps supervisors monitor how frequently handovers occur and identify recurring questions that the AI cannot answer β€” which is the input to the Inbox-to-FAQ feedback loop (see Manage SmartBot FAQs).

Was this article helpful?
Your feedback helps us improve our documentation.