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

# transfer()

> Hand the call off to another phone number or SIP address

`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.

<Tabs>
  <Tab title="Python">
    ```python signature theme={null}
    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. |
  </Tab>

  <Tab title="TypeScript">
    ```typescript signature theme={null}
    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. |
  </Tab>
</Tabs>

## Example

<Tabs>
  <Tab title="Python">
    ```python example.py theme={null}
    @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.",
        )
    ```
  </Tab>

  <Tab title="TypeScript">
    ```typescript example.ts theme={null}
    agent.onTaskComplete("collect_issue", async (call: guava.Call) => {
      await call.transfer(
        "+18005550199",
        "Let the caller know you're transferring them to a service representative.",
      );
    });
    ```
  </Tab>
</Tabs>


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