Documentation | Guava

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.

Signature

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

Parameter	Type	Default	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.

Example

@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.",
    )