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

# Transfer call step

> Hand the caller to a person or another line with a Transfer call step: set the number, choose warm or cold transfer, add SIP headers and handle failure.

A Transfer call step hands the caller over to another phone number or SIP address, such as your support line or a specific team. With a cold transfer the caller goes straight through. With a warm transfer the agent first reaches someone, briefs them, and only then connects the caller.

## Before you start

The agent needs a phone number in the flow's global settings (**Phone number**, "Assign a phone number for calls."). Without one, the panel warns: "Transfer call won't work unless a phone number is added to the global flow settings." See [Phone numbers](https://docs.tryhamsa.com/agents/connect/phone-numbers.md).

## Add a Transfer call step

**1. Add the step**

On the canvas, click **Add node** and choose **Transfer call** ("Transfer call to another number").

**2. Set the destination**

Under **Transfer configuration**, enter **Transfer to phone number**.

**3. Choose the transfer type**

Pick **Cold transfer** or **Warm transfer** in **Transfer type**.

**4. Write the transfer message**

Open **Transfer message** and write what the agent says before the transfer, such as "I'm connecting you to our billing team now."

**5. Connect On Failure**

Connect **On Failure** to a step that tells the caller and offers another way forward.

![The Transfer to support panel: Transfer configuration with E.164 selected and a phone number entered, Transfer type set to Warm transfer, and the Transfer message and Custom SIP headers sections](https://mintcdn.com/hamsa-452fa79a/Rl78D_qJIpinmg19/images/agents/flow/steps/transfer-call-step-light.webp?fit=max\&auto=format\&n=Rl78D_qJIpinmg19\&q=85\&s=4e390b784a40a2defc44fc33022bb87e)

## Fields

| Field | What it does | Default |
| - | - | - |
| **Transfer to phone number** | Where the call goes. Choose **E.164** to enter a phone number (checked as you type: "Phone number is required", "Please enter a valid phone number"), or **String** to enter a variable or any text ("Enter variable or string (e.g. `{{phone_number}}`)"), which isn't checked. | **E.164** |
| **Transfer type** | **Cold transfer** or **Warm transfer**. See [Cold or warm](#cold-or-warm). | **Cold transfer** |
| **Transfer message** | What the agent says before the transfer starts, for both types. **Static** speaks your text ("This message will be played before transferring the call"); **Prompt** lets the agent write it ("AI will generate an appropriate transfer message"). Leave it empty to say nothing. | **Prompt**, empty |
| **Custom SIP headers** | "Attach custom SIP headers to the outgoing transfer call." Click **Add header** and fill in **Header name** and **Value**. A value can be static or a `{{variable}}`. Both are required: "Header 1 is missing a name", "Header 1 is missing a value". | None |

With **String**, the value you enter (after variables are filled in) is dialed like this:

| Value | Dialed as |
| - | - |
| `+` followed by 7 to 15 digits, such as `+14155550123` | That phone number |
| Starts with `tel:` or `sip:` | Used as written |
| Anything else, such as `1001` or `support@pbx.example.com` | A SIP address: `sip:1001` |

Use **String** to transfer to a number you got during the call, or to an extension or SIP address on your own phone system.

## Cold or warm

| Option | What the caller experiences | When to use it |
| - | - | - |
| **Cold transfer** | The agent hands the call to the destination right away. The caller leaves the agent and the destination's phone system takes over. | The destination is a queue or an IVR, or nobody needs context. |
| **Warm transfer** | The caller hears hold music while the agent calls the destination. When someone answers, the agent gives them a summary of the call, then connects the caller. | A person answers and should know who's calling and why before they pick up. |

On a warm transfer:

* The agent tries up to 3 times, for up to 5 minutes in total, waiting up to 90 seconds for each attempt to be answered.
* While the caller waits, the agent tells them every 30 seconds that everyone is still busy and asks them to stay on the line.
* If nobody takes the call, the hold music stops, the agent apologizes that no one is available and offers to keep helping, and the call takes **On Failure**.

## Transitions

| Transition | Taken when |
| - | - |
| **On Failure** | The transfer couldn't be made: the destination rejected it, nobody answered a warm transfer, or the call can't be transferred. |

**On Failure** is created with the step and can't be removed. There's no success path: once the transfer goes through, the caller is with the destination and the flow ends.

You can also add **Skip if** to this step: when its conditions already hold as the call arrives, the call goes straight to its target and the step doesn't run. See [Skip if](https://docs.tryhamsa.com/agents/flow/transitions.md#skip-if).

## How it works on a call

1. Any hold music from an earlier step stops. What the caller said while the flow was working stays in the transcript but isn't answered.
2. The step's local variables are set, and variables in the number and header values are filled in. Headers whose value comes out empty are left off.
3. The agent speaks the transfer message, if there is one. It can't be interrupted.
4. The transfer starts: cold right away, warm as described above.
5. If it fails, the call takes **On Failure** and the agent is back with the caller.

## Good to know

* Test transfers on a phone call. In a browser test there's no phone line to transfer.
* The **E.164** check in the panel is stricter than what's dialed: if a number you need is refused, enter it with **String**.
* **Confirm before proceeding**, in the **Global** section, makes the agent check with the caller before transferring.

## Related

> [card] [Transfer to agent step](https://docs.tryhamsa.com/agents/flow/steps/transfer-agent.md)
>
> Hand the call to another agent instead of a phone line.

> [card] [Phone numbers](https://docs.tryhamsa.com/agents/connect/phone-numbers.md)
>
> Add the number your agent calls from.

> [card] [Bring your own number](https://docs.tryhamsa.com/agents/connect/bring-your-own-number.md)
>
> Connect your own SIP trunk, for transfers to your PBX.

> [card] [Global steps](https://docs.tryhamsa.com/agents/flow/global-steps.md)
>
> Make transfer reachable from anywhere, such as "talk to a person".


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.