This node only works during phone calls instead of web calls. It’s available for Retell numbers and imported numbers.

Call transfer node is used to transfer the call to another number. The agent will not speak when it’s in this node. If you want the agent to say things like Let me transfer you right away before performing the actual transfer, you can do so by putting a conversation node (with skip response turned on) before this node.

​
When Can Transition Happen

Transition happens when transfer fails. There’s already a pre-populated edge for this, feel free to connect that to a node to handle transfer failure.

​
Configure Transfer

1

Setup Transfer To Target

Set it to be either

2

Configure Transfer Type

Choose between cold transfer or warm transfer:

  • Cold transfer: The call is transferred to a destination number and that’s it.
  • Warm transfer: After the call is transferred to the destination number, the AI agent attempts to first detect if the other side is a human, then speaks whisper and three-way messages (more details in Step 4).
3

Configure Caller ID for Cold Transfer (Optional)

For cold transfers, you can configure how the caller ID appears to the next agent:

  1. Retell Agent’s number: The transfer destination will see the Retell agent’s number

  2. Transferree’s Number: The transfer destination will see the number that the user is calling from. Please note that you have to configure following in your telephony provider in order to make it work, because this option internally is simply transferring via SIP REFER, and some telephony provider have the ability to set caller id for SIP REFER.

    • enable SIP REFER
    • enable transfer to PSTN
    • set caller id as transferee
4

Configure Settings for Warm Transfer

For warm transfers, you can configure the following settings:

  • On-hold music: The audio played to the caller while they are on hold. The default is a standard ringtone.
  • Agent detection timeout: The maximum amount of time the AI agent will wait to determine whether the transfer target is a human. The caller is connected only if human detection succeeds within this timeframe. Otherwise, the transfer is marked as failed. The default timeout is 30 seconds.
  • Whisper message (optional): A message spoken privately to the transfer target before connecting them to the original caller.
  • Three-way message (optional): A message spoken to both the transfer target and the original caller once the connection is established.
5

Add Custom SIP Headers (Optional)

Add custom SIP headers for outbound calls. These headers are forwarded to your SIP provider on the SIP INVITE and can be used for custom routing, tagging, or metadata.

All header names must start with X-

​
Rest of Node Settings

  • Global Node: read more at Global Node
  • LLM: choose a different model for this particular node. Will be used for function argument generation, and potentially speak during execution message generation.

This node only works during phone calls instead of web calls. It’s available for Retell numbers and imported numbers.

Call transfer node is used to transfer the call to another number. The agent will not speak when it’s in this node. If you want the agent to say things like Let me transfer you right away before performing the actual transfer, you can do so by putting a conversation node (with skip response turned on) before this node.

​
When Can Transition Happen

Transition happens when transfer fails. There’s already a pre-populated edge for this, feel free to connect that to a node to handle transfer failure.

​
Configure Transfer

1

Setup Transfer To Target

Set it to be either

2

Configure Transfer Type

Choose between cold transfer or warm transfer:

  • Cold transfer: The call is transferred to a destination number and that’s it.
  • Warm transfer: After the call is transferred to the destination number, the AI agent attempts to first detect if the other side is a human, then speaks whisper and three-way messages (more details in Step 4).
3

Configure Caller ID for Cold Transfer (Optional)

For cold transfers, you can configure how the caller ID appears to the next agent:

  1. Retell Agent’s number: The transfer destination will see the Retell agent’s number

  2. Transferree’s Number: The transfer destination will see the number that the user is calling from. Please note that you have to configure following in your telephony provider in order to make it work, because this option internally is simply transferring via SIP REFER, and some telephony provider have the ability to set caller id for SIP REFER.

    • enable SIP REFER
    • enable transfer to PSTN
    • set caller id as transferee
4

Configure Settings for Warm Transfer

For warm transfers, you can configure the following settings:

  • On-hold music: The audio played to the caller while they are on hold. The default is a standard ringtone.
  • Agent detection timeout: The maximum amount of time the AI agent will wait to determine whether the transfer target is a human. The caller is connected only if human detection succeeds within this timeframe. Otherwise, the transfer is marked as failed. The default timeout is 30 seconds.
  • Whisper message (optional): A message spoken privately to the transfer target before connecting them to the original caller.
  • Three-way message (optional): A message spoken to both the transfer target and the original caller once the connection is established.
5

Add Custom SIP Headers (Optional)

Add custom SIP headers for outbound calls. These headers are forwarded to your SIP provider on the SIP INVITE and can be used for custom routing, tagging, or metadata.

All header names must start with X-

​
Rest of Node Settings

  • Global Node: read more at Global Node
  • LLM: choose a different model for this particular node. Will be used for function argument generation, and potentially speak during execution message generation.