> For the complete documentation index, see [llms.txt](https://limechatai.gitbook.io/limechat-product-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://limechatai.gitbook.io/limechat-product-guide/whatsapp-marketing/flows/action-nodes/handoff-conversation-to-agent.md).

# Handoff Conversation to Agent

**Node Name:**\
Handoff Conversation to Agent

***

**What it does:**\
Transfers the ongoing conversation from the current automation flow to a selected AI agent (agentic chatbot), allowing that agent to take over and continue the interaction.

***

**When to Use:**

* When you want to switch from rule-based automation to an AI-driven conversational experience<br>
* In high-intent scenarios (e.g., product discovery, conversion flows)<br>
* When a specialized agent (e.g., Sales bot) should handle the conversation<br>
* After collecting initial user inputs via flow and handing over for dynamic conversation<br>

***

**UI Inputs:**

* **Agent Selection**
  * Type: Dropdown (pre-configured agents)<br>
  * Required: Yes<br>
  * Description: Select the agent that should take over the conversation<br>
  * Special Behavior:
    * Options are fetched from available configured agents<br>
    * Currently shows only the Sales agent.<br>
* **Prompt**
  * Type: Text<br>
  * Required: No<br>
  * Description: Initial instruction or context passed to the agent to guide its behavior<br>
  * Special Behavior:
    * Helps define how the agent should start or handle the conversation<br>
* **Configuration Data**
  * Type: Text<br>
  * Required: No<br>
  * Description: Additional structured data or context passed to the agent<br>
  * Special Behavior:
    * Can be used for advanced configurations or metadata<br>
* **Pass Conversation Context**
  * Type: Boolean (True/False toggle)<br>
  * Required: Yes<br>
  * Default: False<br>
  * Description: Determines whether previous conversation history is shared with the agent<br>
  * Special Behavior:
    * True → Agent gets full prior conversation context<br>
    * False → Agent starts fresh without past context<br>

***

**Outputs:**

* **successful**
  * Type: Boolean<br>
  * Meaning:
    * true → Handoff to agent was successful<br>
    * false → Handoff failed<br>

***

**Requirements:**

* **Supported Events:**
  * All (*all*)<br>
* **Required Integrations:**
  * None<br>

***

**Notes:**

* This is a **bot-to-agent (AI agent)** handoff, not a human agent assignment<br>
* Typically used mid-flow to transition into a more flexible, AI-driven experience<br>
* Works best when combined with proper prompt/context setup to guide agent behavior<br>
* If “Pass Conversation Context” is disabled, ensure prompt/config provides enough context for the agent to function properly