What Happens When a Visitor Asks for a Human Agent?

Last updated: April 15, 2026

Learn how Leno AI detects when a visitor wants a human and automatically hands the conversation off to your team.

How the Leno AI Human Agent Handoff Works

The human agent handoff is one of the most important transitions in a live chat experience. When a visitor signals they want to speak with a real person, Leno AI needs to respond quickly and reliably — without the visitor having to repeat themselves to a human agent. Leno AI uses large language model (LLM) classification to understand the intent behind a visitor's message. It does not rely on exact keyword matching, so natural or informal phrasing is handled correctly. Once the intent is detected, the system evaluates three factors: your configured handoff mode, the channel the visitor is using (web widget, Facebook Messenger, WhatsApp, or Instagram), and whether your business is currently within operating hours. Based on these factors, Leno AI takes one of two actions — it either transfers the chat to the unassigned human agent queue, or it presents a contact form for the visitor to leave their details. The full conversation history from the AI session is always preserved and handed off to the human agent.

Phrases and Intents That Trigger a Handoff

Leno AI classifies incoming visitor messages using an AI model trained to understand natural language intent. The 'talk to agent' intent is triggered whenever a visitor expresses a desire to speak with a real person, regardless of how they phrase it. The following are examples of messages that trigger the handoff flow:

"Connect me to an agent" or "I want to talk to a person"
"I need help from a live agent" or "let me speak to someone"
"Transfer me to a human" or "I don't want to talk to a bot"
"Can I speak to someone real?" or "get me a human agent"
"I need human help" or "I want to chat with a real person"

Note: Because Leno AI detects intent — not just keywords — even unusual, indirect, or misspelled phrasing that expresses the desire for a human is typically classified correctly and triggers the handoff.

Two Handoff Outcomes: Transfer or Contact Form

Once a human agent request is detected, Leno AI evaluates your settings and the current context to determine which of two handoff actions to take. The outcome depends on your configured Handoff Mode, the visitor's channel, and whether you are currently within business hours:

Transfer to Queue (Mode 0): The conversation is moved from AI-handled status to the unassigned agent queue. The visitor receives an acknowledgment message and a queue confirmation. An available human agent can then pick up the conversation directly from the Unassigned Chats list.
Contact Form (Mode 1): A contact form appears inside the chat widget asking for the visitor's email address. After the visitor submits their details, the chat status is updated based on your configuration — either moved to the Unassigned queue for follow-up or marked as Resolved.

Important: Transfer to Queue (Mode 0) is the default behavior and is always used on social channels. Contact Form mode (Mode 1) is only available on the web chat widget — Facebook Messenger, WhatsApp, and Instagram always use Transfer regardless of your Mode 1 setting.

Tip: Mode 0 (Transfer to Queue) is the recommended default for most teams because it moves the visitor into the live agent queue immediately, giving them the fastest possible path to a human. Reserve Mode 1 (Contact Form) for time windows when your team is unavailable.

Option 1: Transfer to the Human Agent Queue (Mode 0)

When the handoff mode is set to Transfer (Mode 0), the conversation moves to the unassigned agent queue in real time. Here is the exact sequence of events that occurs from the moment the visitor's request is detected:

Step 1: Leno AI detects the visitor's intent to speak with a human agent using LLM classification.
Step 2: An immediate acknowledgment message is sent to the visitor — for example, "Absolutely! I will connect you with someone from our team."
Step 3: The conversation status changes from AI-Assigned to Queued and the AI agent assignment is cleared.
Step 4: A second message is sent confirming queue placement — for example, "You've been added to the queue. Our team will join the chat as soon as someone is available. Thanks for your patience!"
Step 5: All connected agents are notified in real time via a socket event. The conversation appears in the Unassigned Chats list in the LenoChat agent dashboard.
Step 6: An available agent clicks into the conversation. They can see the full AI conversation history — including the original message that triggered the handoff — before they begin responding.

The visitor's complete Leno AI conversation history is always preserved and handed off to the human agent. The agent sees everything the AI said, so the visitor never has to repeat themselves.

Option 2: Contact Form Mode (Mode 1)

Contact Form mode is designed for situations where no live agent is immediately available — most commonly outside of business hours — and you want to capture the visitor's contact details for follow-up. When Mode 1 is active and a visitor requests a human agent, a contact form appears directly inside the chat widget. The form collects the visitor's email address. After submission, Leno AI sends a thank-you message and updates the chat status based on your configured post-submission setting. You can choose to move the chat to the Unassigned queue (so an agent reviews and follows up manually) or mark it as Resolved if no further action is needed from the team. You can also optionally enable an email notification so your team receives an alert whenever a visitor submits the contact form. Contact Form mode is only available on the web chat widget. On Facebook Messenger, WhatsApp, and Instagram, Leno AI always uses Transfer to Queue regardless of your Mode 1 configuration — this is because those platforms do not support the widget UI needed to render the contact form.

Placeholder image — replace with actual screenshot of contact form mode in LenoChat widget

Configuring Handoff Settings in the Admin Panel

You can configure how Leno AI handles human agent requests from the Handoff section of your Leno AI settings. The settings are split into two independent sections — one for During Business Hours and one for Outside Business Hours — giving you full control over the handoff experience depending on when a visitor reaches out. Follow these steps to access and configure your handoff settings:

Step 1: Log in to your LenoChat admin panel.
Step 2: Navigate to Settings → Leno AI → Handoff.
Step 3: Under the During Business Hours section, select your Handoff Mode: Mode 0 (Transfer to Queue) or Mode 1 (Contact Form).
Step 4: If you selected Mode 1, set the Chat Status After Form Submission — choose Unassigned to add the chat to the agent queue for follow-up, or Resolved to close it automatically.
Step 5: Optionally enable Send Email Notification to receive an alert when a visitor submits the contact form during business hours.
Step 6: Repeat the configuration for the Outside Business Hours section. Many teams set Transfer during hours and Contact Form outside hours to maximize coverage.
Step 7: Click Save to apply your changes. Updates take effect immediately for all new conversations.

Handoff Settings Reference

Setting	Available Values	Default	Notes
Handoff Mode (During Hours)	Transfer (0) / Contact Form (1)	Transfer (0)	Social channels always use Transfer
Handoff Mode (Outside Hours)	Transfer (0) / Contact Form (1)	Transfer (0)	Social channels always use Transfer
Contact Form Status (During)	Unassigned (1) / Resolved (5)	Unassigned (1)	Chat status after form submission
Contact Form Status (Outside)	Unassigned (1) / Resolved (5)	Resolved (5)	Chat status after form submission
Send Email Notification (During)	Enabled / Disabled	Disabled	Notifies team when visitor submits form
Send Email Notification (Outside)	Enabled / Disabled	Disabled	Notifies team when visitor submits form

Tip: Use different handoff modes for During and Outside business hours to match your team's availability. Set Transfer to Queue during hours for immediate agent pickup, and Contact Form outside hours to capture visitor details when no agents are online — ensuring no visitor inquiry goes unanswered.

Customizing the Handoff Messages

Leno AI sends one or two messages to the visitor during each handoff. You can fully customize all of these messages from the Leno AI Message Templates settings to match your brand voice and communication style. There are four message templates associated with the 'visitor requests human agent' scenario:

Transfer Acknowledgment (S1 — Transfer): Sent immediately when a transfer is initiated. Default: "Absolutely! I will connect you with someone from our team."
Transfer Queue Confirmation (S2 — Transfer): Sent after the chat enters the agent queue. Default: "You've been added to the queue. Our team will join the chat as soon as someone is available. Thanks for your patience!"
Contact Form Prompt (S1 — Contact Form): Sent when the contact form is displayed. Default: "Please fill out the form below and we'll get back to you as soon as possible."
Post-Submission Thank You (S2 — Contact Form): Sent after the visitor submits the form. Default: "Thank you! Our team has received your request and will contact you soon."

To edit these messages, navigate to Settings → Leno AI → Message Templates. Changes take effect immediately after saving and apply to all new conversations.

How Agents Are Notified of a Handoff

When a visitor's conversation is transferred to the human agent queue, every connected agent is notified in real time. The LenoChat notification center alerts agents of new unassigned conversations so no request is missed. The conversation appears in the Unassigned Chats list with the visitor's full AI conversation history intact, allowing the agent to review the context before they begin responding. Agents can see the customer's name, the channel the conversation came from (widget, Facebook Messenger, WhatsApp, or Instagram), and the original message that triggered the handoff. The chat status is displayed as Queued to clearly distinguish it from AI-handled conversations. When Contact Form mode is used and a visitor submits their details, agents who have email notifications enabled will also receive an email with the visitor's contact information and a direct link to the conversation in the dashboard.

LenoChat notification center showing a new unassigned conversation from a human agent handoff request

Common Issues & Solutions

Visitor's human agent request is not being detected

If Leno AI is not responding to phrases like 'talk to a person' or 'connect me to an agent', verify that Leno AI is enabled and in Agent mode under Settings → Leno AI. The human agent detection relies on LLM classification which requires a fully active AI agent setup. If Leno AI is configured in Copilot mode rather than Agent mode, the automatic intent detection and handoff flow may not trigger — Copilot mode is designed for agent-assisted responses only.

Contact form is not appearing when expected

Contact Form mode (Mode 1) is only available on the web chat widget. If the visitor is connecting via Facebook Messenger, WhatsApp, or Instagram, Leno AI will always use Transfer to Queue regardless of your Mode 1 setting. Also verify that you have set Handoff Mode to Mode 1 (not Mode 0) in Settings → Leno AI → Handoff for the correct time window (During or Outside hours depending on when the issue occurs).

Transferred chat is not appearing in the Unassigned Chats list

After a successful transfer, the conversation should appear in the Unassigned Chats list with Queued status. If it is not showing, try refreshing the agent dashboard — the real-time socket event may have been missed if the connection was momentarily interrupted. If another agent has already assigned themselves to the conversation, it will appear under Assigned Chats instead. If the issue persists, verify the agent's browser connection and check that the LenoChat server is reachable.

Agents are not receiving email notifications for contact form submissions

Email notifications for contact form submissions are disabled by default. To enable them, navigate to Settings → Leno AI → Handoff and toggle on Send Email Notification for the relevant time window (During or Outside hours). Ensure your notification email address is correctly configured in your account settings. Check your spam folder for the first few notification emails, as they may be filtered before the sender address is trusted.

Frequently Asked Questions

What happens to the Leno AI conversation history when a visitor is transferred to a human agent?

The full conversation history is preserved when the handoff occurs. The human agent can see every message exchanged between the visitor and Leno AI, including the specific message that triggered the handoff. This gives the agent complete context before they begin responding, so the visitor never needs to repeat themselves.

Can I set different handoff behavior for business hours and outside business hours?

Yes. Leno AI has independent handoff mode settings for During Business Hours and Outside Business Hours. For example, you can configure Transfer to Queue during hours so agents can pick up chats immediately, and Contact Form outside hours so visitors can leave their details for follow-up. Go to Settings → Leno AI → Handoff to configure both periods independently.

Does the contact form handoff work on Facebook Messenger and WhatsApp?

No. Contact Form mode is only available on the web chat widget. When a visitor requests a human agent on Facebook Messenger, WhatsApp, or Instagram, Leno AI will always use Transfer to Queue regardless of your Contact Form setting. This is because the contact form requires a widget UI that these social platforms do not support.

How do I change the message Leno AI sends when transferring a visitor to a human agent?

You can customize all handoff messages from Settings → Leno AI → Message Templates. Look for the 'Visitor Requests Human Agent' section where you can edit four templates: the immediate acknowledgment, the queue confirmation, the contact form prompt, and the post-submission thank-you message. Changes apply to all new conversations immediately after saving.

Will the visitor be told what is happening while they wait in the queue for a human agent?

Yes. When Transfer to Queue is used, Leno AI sends two messages to the visitor: an immediate acknowledgment confirming the handoff is in progress, and a second message confirming they have been added to the queue with an indication that an agent will join soon. Both messages are fully customizable from the Message Templates settings.

What is the difference between Handoff Mode 0 and Mode 1?

Mode 0 (Transfer to Queue) moves the conversation to the Unassigned Chats list immediately, where any available agent can pick it up. Mode 1 (Contact Form) instead displays a contact form in the widget and waits for the visitor to submit their email address, after which the chat status is updated based on your post-submission setting. Mode 0 is best for real-time support; Mode 1 is best for capturing leads when agents are unavailable.

Can Leno AI detect human agent requests in languages other than English?

Yes. Leno AI's message classification is powered by a large language model that understands natural language across multiple languages. The 'talk to agent' intent detection works in all the languages supported by Leno AI's multi-language feature. The handoff process behaves identically regardless of the language the visitor is using.