Skip to main content

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.

Accept inbound calls on a Vobiz phone number and route them to a LiveKit AI voice agent.

View on GitHub

Clone and run the full working example

​
Getting started

git clone https://github.com/vobiz-ai/Livekit-vobiz-inbound.git
cd Livekit-vobiz-inbound
pip install -r requirements.txt
python agent.py dev

​
Overview

When someone calls your Vobiz number, the call is routed via SIP to LiveKit. A dispatch rule automatically spawns your AI agent into a room where the caller is connected. The agent handles the conversation using LiveKit’s real-time audio pipeline.

​
How it works

  1. Caller dials your Vobiz number.
  2. Vobiz SIP routes the call to your LiveKit SIP URI (configured as inbound_destination on your trunk).
  3. LiveKit receives the call and applies the dispatch rule.
  4. The dispatch rule auto-spawns your agent into the call room.
  5. The AI agent greets the caller and handles the conversation.

​
Setup requirements

  • A Vobiz SIP trunk with inbound_destination set to your LiveKit SIP URI
  • A LiveKit inbound SIP trunk with your Vobiz phone number
  • A LiveKit dispatch rule configured to auto-spawn your agent
When entering the LiveKit SIP URI as the Vobiz inbound_destination, remove the sip: prefix. Enter your-id.sip.livekit.cloud not sip:your-id.sip.livekit.cloud.

​
Environment variables

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

​
Resources