Call transfer agent

Transfer an active call to any E.164 phone number or department via SIP REFER from a LiveKit AI agent.

View on GitHub

Clone and run the full working example

Getting started

git clone https://github.com/vobiz-ai/Vobiz-Livekit-Call-Transfer-Example.git
cd Vobiz-Livekit-Call-Transfer-Example
pip install -r requirements.txt
python agent.py dev

Overview

The AI agent handles the conversation and, when instructed, performs a cold SIP REFER transfer to any phone number. The agent constructs the SIP URI dynamically - the caller is transferred and the agent disconnects.

How it works

Caller requests a transfer (e.g. “Transfer me to sales” or “Transfer me to +1 555 000 1234”).
The agent calls the transfer_call function tool.
The agent sends a SIP REFER to sip:+15550001234@your-vobiz-domain.
Vobiz routes the call to the destination.
The agent leaves the room - the transfer is complete.

Agent function tool

@llm.function_tool(description="Transfer the caller to an E.164 phone number directly")
async def transfer_call(context: llm.FunctionContext, phone_number: str):
    sip_uri = f"sip:{phone_number}@{VOBIZ_SIP_DOMAIN}"
    await context.room.local_participant.perform_rpc(
        destination_identity="sip",
        method="transfer",
        payload=sip_uri
    )

Preset department transfers

Configure preset destinations in .env and map them to named tools:

Command	Destination
”Transfer to billing”	`BILLING_NUMBER`
”Transfer to support”	`SUPPORT_NUMBER`
”Transfer me to [number]“	Any E.164 number

Environment variables

.env

LIVEKIT_URL=wss://your-project.livekit.cloud
LIVEKIT_API_KEY=APIxxxxxxxxxxxxx
LIVEKIT_API_SECRET=secretxxxxxxxxxx
VOBIZ_SIP_DOMAIN=your-domain.sip.vobiz.ai
OPENAI_API_KEY=sk-...
BILLING_NUMBER=+919XXXXXXXXX
SUPPORT_NUMBER=+919XXXXXXXXX

Guides

LiveKit Templates

Server Templates

Industries

Compare Platforms

Call transfer agent

View on GitHub

Getting started

Overview

How it works

Agent function tool

Preset department transfers

Environment variables

View on GitHub

​Getting started

​Overview

​How it works

​Agent function tool

​Preset department transfers

​Environment variables

Getting started

Overview

How it works

Agent function tool

Preset department transfers

Environment variables