Create SIP Trunk

Create a SIP trunk in Vobiz to handle voice traffic. Instead of reading separate documentation, just follow these quick steps:

1. Log in to the Vobiz Console
2. In the left sidebar, navigate to SIP Trunk > Outbound Trunks > Trunks
3. Click + Create Trunk
4. Enter a Trunk Name (e.g., "LiveKit Integration") and an optional Description
5. Under Authentication & Linking, select a Credential from the Credentials List (or click + Create New Credential if you don't have one)
6. Click + Create Trunk at the bottom right to save

Get Phone Number

Purchase a phone number for outbound caller ID or inbound calls.

See: Vobiz Phone Numbers Documentation

Get LiveKit Credentials

1. Go to LiveKit Cloud Dashboard
2. Select your project
3. Navigate to Settings → API Keys
4. Copy these values:

LIVEKIT_URL=wss://your-project.livekit.cloud
LIVEKIT_API_KEY=APIxxxxxxxxxxxxx
LIVEKIT_API_SECRET=secretxxxxxxxxxx

Initialize LiveKit API Client

from livekit import api as livekit_api

lk = livekit_api.LiveKitAPI(
    url="YOUR_LIVEKIT_URL",
    api_key="YOUR_LIVEKIT_API_KEY",
    api_secret="YOUR_LIVEKIT_API_SECRET"
)

Create Outbound Trunk

Connect LiveKit to your Vobiz SIP trunk:

trunk = await lk.sip.create_sip_outbound_trunk(
    livekit_api.CreateSIPOutboundTrunkRequest(
        trunk=livekit_api.SIPOutboundTrunkInfo(
            name="Vobiz Trunk",
            address="YOUR_VOBIZ_SIP_DOMAIN",      # From Vobiz trunk response
            auth_username="YOUR_VOBIZ_USERNAME",  # From Vobiz trunk response
            auth_password="YOUR_VOBIZ_PASSWORD",  # From Vobiz trunk response
            numbers=["YOUR_PHONE_NUMBER"]         # Your Vobiz phone number
        )
    )
)

# Save trunk.sip_trunk_id - you'll need it for making calls

Step 1: Get LiveKit SIP URI

1. Go to LiveKit Cloud Dashboard
2. Select your project
3. Go to Settings → Project
4. Find SIP URI field

sip:your-sip-uri.sip.livekit.cloud

Step 2: Update Vobiz Trunk Inbound Destination

Update your Vobiz trunk to route calls to LiveKit.

See: Vobiz Update Trunk Documentation

PATCH https://api.vobiz.ai/api/v1/account/{auth_id}/trunks/{trunkId}

{
  "inbound_destination": "your-sip-uri.sip.livekit.cloud"
}

Step 3: Create LiveKit Inbound Trunk

Via LiveKit Dashboard (Recommended):

1. Go to Telephony → Trunks
2. Click Create new trunk → Inbound
3. Configure:
   • Phone Numbers: Your Vobiz number (e.g., +918071387434)
   • Allowed Addresses: 0.0.0.0/0 (restrict in production)
4. Click Create
5. Save the Trunk ID

Step 4: Create Dispatch Rule

Configure LiveKit to auto-spawn your AI agent when calls arrive.

Via LiveKit Dashboard:

1. Go to Telephony → Dispatch Rules
2. Click Create new dispatch rule
3. Configure:
   • Rule Type: Individual
   • Room Prefix: call-
   • Match Trunks: Select your inbound trunk
4. Expand "Agent dispatch" section
5. Set Agent Name: voice-assistant (must match your agent)
6. Click Create