transfer()

call.transfer() hands the active call off to another phone number or SIP address. It is a soft transfer — the agent notifies the caller before bridging, so there’s no abrupt silence or dead air.

Python
TypeScript

signature

call.transfer(
    destination: str,
    instructions: str | None = None,
)

Parameter	Type	Description
`destination`	`str`	The phone number or SIP address to transfer the call to.
`instructions`	`str \| None`	What the agent should say before bridging. Defaults to a generic “I’ll transfer you now” message.

signature

await call.transfer(
  destination: string,
  instructions?: string,
): Promise<void>

Parameter	Type	Description
`destination`	`string`	The phone number or SIP address to transfer the call to.
`instructions`	`string`	What the agent should say before bridging. Defaults to a generic “I’ll transfer you now” message.

Example

Python
TypeScript

example.py

@agent.on_task_complete("collect_issue")
def on_issue_collected(call: guava.Call):
    call.transfer(
        destination="+18005550199",
        instructions="Let the caller know you're transferring them to a service representative.",
    )

example.ts

agent.onTaskComplete("collect_issue", async (call: guava.Call) => {
  await call.transfer(
    "+18005550199",
    "Let the caller know you're transferring them to a service representative.",
  );
});

Getting started

Agent SDK

CLI reference

WebRTC

SIP calling

Phone numbers

Deployments

Compliance

Release notes

Example

​Example

Example