> ## Documentation Index
> Fetch the complete documentation index at: https://docs.phonely.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Transfer Flow

> Learn how to route callers between flows while keeping the same live call active.

The Transfer Flow block lets your AI agent route a caller from the current flow to one or more sub-flows, without ending the call.

From the caller’s perspective, the transition is seamless, they remain in the same call while the agent switches conversational context behind the scenes.

This block supports multiple destinations, centralized transition logic, and a simpler configuration model for complex routing.

## Key Features

### 1. Multiple Flow Destinations

You can add multiple sub-flows inside a single transfer flow block. Each destination represents a possible routing outcome.

This removes the need for:

* A primary routing block
* Multiple downstream transfer blocks
* Duplicated logic across flows

### 2. Transition Conditions

Transition conditions appear only when more than one destination is configured.

Each destination can have a plain-text condition that describes when a caller should be routed to that flow.

<Tip>
  Phonely will use this condition to determine when to route to this flow based on the caller's request, asking clarifying questions if needed. Be as descriptive as possible.
</Tip>

### 3. Global Transition Conditions

Transition logic is now managed globally at the workflow level.

This means:

* Transition conditions are defined once.
* Any updates automatically propagate everywhere they’re used.

### 4. Simplified Exit Logic

The Transfer Flow block:

* Does not inject variables into exit conditions
* Focuses on fast, consistent routing.
* Preserves advanced logic under the global workflow configuratio

## Setup

1. Open your agent in **Agent** **Design**.
2. Click the **➕** button on the canvas and select Transfer Flow.

<img src="https://mintcdn.com/phonely/J2LKh_EYahA12J9K/assets/new-transfer-flow.png?fit=max&auto=format&n=J2LKh_EYahA12J9K&q=85&s=ba477d9ded790413a05133d84a5f52bb" alt="New Transfer Flow" title="New Transfer Flow" style={{ width:"70%" }} width="1852" height="1692" data-path="assets/new-transfer-flow.png" />

3. Under **Available Sub-Flows**.
4. Open the **Flow** dropdown.
5. Select the sub-flow you want to route to.

<img src="https://mintcdn.com/phonely/ROyEq1IIii0PKodQ/assets/select-subflows-for-routing-destinations.png?fit=max&auto=format&n=ROyEq1IIii0PKodQ&q=85&s=93f300898d6bdf8e8013b7767a00a5a5" alt="Select Subflows For Routing Destinations" title="Select Subflows For Routing Destinations" style={{ width:"59%" }} width="3096" height="2648" data-path="assets/select-subflows-for-routing-destinations.png" />

6. To add another possible routing destination with a different subflow, click the **Add Flow Destination** button.
7. Repeat to add multiple destinations if needed. Select the respective subflow for each destination.

<img src="https://mintcdn.com/phonely/J1SHiOdv0Kh5Te7B/assets/add-flow-destinations.png?fit=max&auto=format&n=J1SHiOdv0Kh5Te7B&q=85&s=55411b322dfdde931ce9a869f8078906" alt="Add Flow Destinations" title="Add Flow Destinations" style={{ width:"58%" }} width="1892" height="1848" data-path="assets/add-flow-destinations.png" />

Each destination appears as a separate routing option inside the block.

### Define Transition Conditions

If you configure **multiple destinations**, a **Transition Condition** field appears.

Use this field to describe:

* When the caller should be routed to that destination.
* How the intent differs from other flows.

<img src="https://mintcdn.com/phonely/Uef2tIM2gQ6eJm8s/assets/defining-transition-condition.png?fit=max&auto=format&n=Uef2tIM2gQ6eJm8s&q=85&s=a94e844098c07ee25b6bf0d5a07c64c1" alt="Defining Transition Condition" title="Defining Transition Condition" style={{ width:"58%" }} width="3088" height="2984" data-path="assets/defining-transition-condition.png" />

> These conditions connect to the global transition rules defined in your workflow.

### Advanced Settings

#### Interim Message

Enable Interim Message if you want the agent to say something during the transition, such as:

> “Let me connect you to the right place.”

You can also configure:

* Prompt-generated messages or type a fixed message.
* Post-interim message delay.

<img src="https://mintcdn.com/phonely/E7CiyfSBryDgLxkE/assets/transfer-flow-advanced-settings.png?fit=max&auto=format&n=E7CiyfSBryDgLxkE&q=85&s=b83cbbad9c174492993dd2c41227d67c" alt="Transfer Flow Advanced Settings" title="Transfer Flow Advanced Settings" style={{ width:"59%" }} width="2992" height="2496" data-path="assets/transfer-flow-advanced-settings.png" />

#### Call Outcome Tagging

Add a tag to indicate the outcome of the call for better analysis in the analytics section.

## Save

Click **Done** to finish the setup.
