***

id: 55017455-9739-466f-9469-bda459dcf3f1
title: Send outbound calls from LiveKit
subtitle: Route LiveKit calls onto the PSTN with SignalWire
description: Route LiveKit Calls onto the PSTN with SignalWire.
slug: /ai/livekit/outbound
--------------------------

This guide will help you set up outbound SIP calls using LiveKit and SignalWire.
Follow these steps to configure your SIP domain, SWML script, and LiveKit settings efficiently.

## Prerequisites

Before getting started, you'll need the following:

* a [SignalWire Space][signup]
* a [LiveKit account][livekit]
* a [SignalWire phone number][buy-phone]

## Setup

<Steps>
  ### Create a SWML Script

  {/* Shared component: Create SWML Script instructions */}

  To create a SWML script, navigate to the **Resources** tab in your [SignalWire Dashboard](https://my.signalwire.com), click **+ Add New**, and select **SWML Script**.

  * Log in to your SignalWire Dashboard and navigate to the [**Resources**](https://my.signalwire.com/?page=resources) tab on the left-hand sidebar.
  * Click **Add**, select **Script**, and then choose **SWML Script**.
  * Paste the following SWML code snippet into the editor:

  ```yaml title="SWML"
  version: 1.0.0
  sections:
    main:
      - connect:
          answer_on_bridge: true
          from: "+1XXXXXXXXXX"
          to: "%{call.to.replace(/^sip:/i, '').replace(/@.*/, '')}"
  ```

  Be sure to replace `"+1XXXXXXXXXX"` with a phone number from your SignalWire account.

  ### Add SIP address

  * Save the SWML script and navigate to the **Addresses & Phone Numbers** section within the script.
  * Click **Add** and select **SIP Address** to add your SIP domain application.
  * Configure this SIP address based on your requirements, and save it.
  * After configuration, note down your unique SIP domain.

  Example SIP domain: `test-space-live-kit.dapp.signalwire.com`.
</Steps>

Now, let’s configure LiveKit for outbound SIP calling.
Follow along with LiveKit’s documentation for [outbound SIP trunk setup](https://docs.livekit.io/sip/trunk-outbound/).

<Steps>
  ### Create an outbound trunk

  Use the following JSON configuration for creating an outbound SIP trunk, ensuring you update the given fields:

  ```json
  {
     "trunk": {
        "name": "My Outbound SIP Trunk",
        "address": "test-space-livekit.dapp.signalwire.com",
        "numbers": ["+15105550100"],
        "auth_username": "<username>",
        "auth_password": "<password>",
        "transport": 3
     }
  }
  ```

  Update placeholders in the above JSON with the following:

  | Placeholder                   | Replace with                                                                             |
  | :---------------------------- | :--------------------------------------------------------------------------------------- |
  | `"address"`                   | The SIP domain you created previously (e.g., `test-space-live-kit.dapp.signalwire.com`). |
  | `numbers`                     | A SignalWire phone number.                                                               |
  | `<username>` and `<password>` | The credentials provided by SignalWire Support. Contact Support if needed.               |

  Submit this request and save the generated `Trunk ID`.
  If you forget to save the Trunk ID, use LiveKit’s CLI tool to retrieve the trunk configurations.

  ### Create SIP participant

  To initiate outbound calls through your configured trunk, you'll need to create a SIP participant in LiveKit.
  This process establishes the connection and manages the call flow.
  For detailed instructions on creating SIP participants and handling outbound calls,
  refer to LiveKit's comprehensive guide to
  [Creating a SIP Participant](https://docs.livekit.io/sip/outbound-calls/#creating-a-sip-participant).

  If you're working with LiveKit AI agents for outbound calls, please see
  the [LiveKit AI Agent Telephony Guide](https://docs.livekit.io/agents/start/telephony/).

  ### Final checks

  * Ensure the trunk address matches exactly with the one created previously.
  * Phone numbers must be in E.164 format (e.g., "+15105550100") to ensure proper routing and connectivity.
</Steps>

You’re now ready to make your first outbound SIP call using LiveKit and SignalWire.
If you encounter any issues, verify the configurations for both SignalWire and LiveKit.

***

## Next steps

### Record calls

Record calls by creating a SWML script with recording logic and slightly modifying your outbound SWML script.

<Steps>
  ### Create a second script

  In your new script, paste the following SWML:

  ```yaml title="record.yaml"
  version: 1.0.0
  sections:
    main:
    - record_call:
        format: mp3
  ```

  ### Update the outbound SWML script

  Then, modify your existing outbound SWML script by adding the `confirm` parameter under the `connect` method,
  and setting its value to the URL for the new recording script.

  The result should look like this:

  ```yaml title="outbound.yaml"
  version: 1.0.0
  sections:
    main:
      - connect:
          answer_on_bridge: true
          confirm: "your-recording-script-url"
          from: "+1XXXXXXXXXX"
          to: "%{call.to.replace(/^sip:/i, '').replace(/@.*/, '')}"
  ```
</Steps>

These recordings can be accessed in the Dashboard in **Storage > Recordings**,
or using the
[Recordings List API endpoint](/docs/apis/relay-rest/recordings/list-recordings).

### View logs

Access call logs in the
[Logs](https://my.signalwire.com/?page=logs)
tab of your SignalWire Dashboard.

{/* Links */}

[signup]: https://signalwire.com/signup "Sign up for a SignalWire Space."

[livekit]: https://cloud.livekit.io/login "Sign up for a LiveKit account."

[buy-phone]: /docs/platform/phone-numbers "Buy a phone number in the SignalWire dashboard."