LiveKit integration

Documentation Index

Fetch the complete documentation index at: https://docs.vobiz.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Overview

​

Prerequisites

​

Part 1: Vobiz setup

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 (for example, “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

​

Part 2: LiveKit setup

1. Go to the LiveKit Cloud Dashboard and select your project.
2. Go to Settings > API Keys.
3. You need these three values:

   Variable	Where to find
   LIVEKIT_URL	Settings > General
   LIVEKIT_API_KEY	Settings > API Keys
   LIVEKIT_API_SECRET	Settings > API Keys

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

​

Part 3: Connect LiveKit to Vobiz (outbound)

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"
)

trunk = await lk.sip.create_sip_outbound_trunk(
    livekit_api.CreateSIPOutboundTrunkRequest(
        trunk=livekit_api.SIPOutboundTrunkInfo(
            name="Vobiz Trunk",
            address="YOUR_VOBIZ_SIP_DOMAIN",       # sip_domain from Vobiz
            auth_username="YOUR_VOBIZ_USERNAME",   # username from Vobiz
            auth_password="YOUR_VOBIZ_PASSWORD",   # password from Vobiz
            numbers=["YOUR_PHONE_NUMBER"],         # your Vobiz phone number
        )
    )
)

# Save trunk.sip_trunk_id - you'll need it to make calls

​

Part 4: Make outbound calls

participant = await lk.sip.create_sip_participant(
    livekit_api.CreateSIPParticipantRequest(
        sip_trunk_id="YOUR_TRUNK_ID",   # from Part 3
        sip_call_to="+1234567890",      # number to call (E.164)
        room_name="call-room",          # LiveKit room name
    )
)

1. LiveKit creates the call via Vobiz
2. The person answers and joins the LiveKit room as a participant
3. Your AI agent joins the same room
4. The conversation begins

​

Part 5: Configure inbound calling

1. In the LiveKit Cloud Dashboard, go to Settings > Project and find the SIP URI field.
   sip:your-sip-uri.sip.livekit.cloud
   
2. Update your Vobiz trunk to route inbound calls to LiveKit. See Update Trunk.
   Remove the sip: prefix when entering the destination in Vobiz. LiveKit shows sip:your-sip-uri.sip.livekit.cloud but you enter your-sip-uri.sip.livekit.cloud.
   PATCH https://api.vobiz.ai/api/v1/account/{auth_id}/trunks/{trunk_id}
   
   {
     "inbound_destination": "your-sip-uri.sip.livekit.cloud"
   }
   
3. In the LiveKit dashboard, go to Telephony > Trunks and click Create new trunk > Inbound. Configure:
   • Phone Numbers: Your Vobiz number (for example, +918071387434)
   • Allowed Addresses: 0.0.0.0/0 (restrict this in production)
   Click Create and save the Trunk ID.
4. Go to Telephony > Dispatch Rules and click Create new dispatch rule. Configure:
   • Rule Type: Individual
   • Room Prefix: call-
   • Match Trunks: Select your inbound trunk
   Expand the Agent dispatch section and set Agent Name to voice-assistant (must match your agent exactly). Click Create.

​

Part 6: SIP call transfer

• Say “Transfer me” or “Transfer me to a live agent” → transfers to the default configured number
• Say “Transfer me to +1 555 000 1234” → transfers to the requested number

​

Troubleshooting

• Verify address in the LiveKit trunk matches your exact Vobiz sip_domain
• Check that credentials (auth_username, auth_password) match exactly
• Common mistake: using sip.vobiz.ai instead of your specific domain

• Verify credentials in Vobiz Console under Trunks
• Ensure the LiveKit trunk uses the same credentials

• Check your balance at Vobiz Console and top up if needed

• Confirm inbound_destination has the sip: prefix removed
• Verify your Vobiz phone number is added to the LiveKit inbound trunk
• Check that allowed_addresses is set to 0.0.0.0/0 in the LiveKit trunk

• Confirm the agent is running
• Verify the dispatch rule has “Agent dispatch” configured
• Check that the agent name matches exactly (for example, voice-assistant)
• Confirm the dispatch rule is linked to the correct inbound trunk

​

Quick reference

​

Resources

• SIP Trunks
• Phone Numbers
• Balance & Billing
• Console

• LiveKit Agents
• SIP Integration
• Python SDK

• Inbound starter
• Outbound & transfer starter

• Vobiz: support@vobiz.ai
• LiveKit: livekit.io/support