LiveKit

Create an outbound trunk

The outbound trunk tells LiveKit where to send the SIP INVITE and which credentials to use.

{
  "trunk": {
    "name": "Vonyx outbound",
    "address": "43.204.9.41",
    "numbers": ["91XXXXXXXXXX"],
    "destination_country": "in"
  }
}

Pass the credentials as flags so they stay out of the file:

lk sip outbound create outbound-trunk.json \
  --auth-user "your_trunk_username" \
  --auth-pass "your_trunk_password"

The command prints SIPTrunkID: ST_…. Save it. You can list trunks later with lk sip outbound list.

You can also create the trunk in LiveKit Cloud under Telephony → SIP trunks → Create new trunk → JSON editor, with Trunk direction set to Outbound. That editor takes the object without the trunk wrapper and accepts auth_username and auth_password directly.

Leave transport unset (auto) or set it to UDP or TCP. Don't turn on media encryption: Vonyx doesn't support TLS or SRTP.

Place a test call from the CLI

Create a SIP participant. LiveKit dials sip_call_to through the trunk and puts the callee in room_name.

{
  "sip_trunk_id": "ST_xxxxxxxx",
  "sip_call_to": "91XXXXXXXXXX",
  "room_name": "vonyx-test",
  "participant_identity": "callee",
  "participant_name": "Test callee",
  "wait_until_answered": true
}

lk sip participant create sip-participant.json

With wait_until_answered, the command returns once the callee picks up. This call has no agent in the room, so you only confirm that the phone rings and the call connects.

Dial from your agent

In your agent's entrypoint, read the number from the job metadata and create the SIP participant in the agent's own room. This follows LiveKit's outbound example for the Python livekit-agents / livekit-api packages.

import json
 
from livekit import agents, api
 
# server = AgentServer(...)  # from the LiveKit voice AI quickstart
 
@server.rtc_session(agent_name="YOUR_AGENT_NAME")
async def entrypoint(ctx: agents.JobContext):
    phone_number = json.loads(ctx.job.metadata or "{}").get("phone_number")
 
    if phone_number:
        try:
            await ctx.api.sip.create_sip_participant(api.CreateSIPParticipantRequest(
                room_name=ctx.room.name,
                sip_trunk_id="ST_xxxxxxxx",      # your Vonyx outbound trunk
                sip_call_to=phone_number,        # 91XXXXXXXXXX
                participant_identity=phone_number,
                wait_until_answered=True,
            ))
        except api.SipCallError as e:
            print(f"call failed: {e.sip_status_code} {e.sip_status}")
            ctx.shutdown()
            return
 
        participant = await ctx.wait_for_participant(identity=phone_number)
        # session = AgentSession(...)
        # await session.start(room=ctx.room, participant=participant, agent=Assistant())
        # Let the callee speak first on outbound calls.

To place a different caller ID per call, set sip_number on the request to another of your Vonyx numbers instead of creating a new trunk.

Dispatch the agent with a number

Start a job for the agent in a new room and pass the number to dial:

lk dispatch create \
  --new-room \
  --agent-name YOUR_AGENT_NAME \
  --metadata '{"phone_number": "91XXXXXXXXXX"}'

From a backend, use lkapi.agent_dispatch.create_dispatch(api.CreateAgentDispatchRequest(agent_name=..., room=..., metadata=...)) instead.

Find your LiveKit SIP endpoint

Your SIP URI is on the Project settings page in LiveKit Cloud and looks like sip:abc123xyz.sip.livekit.cloud. The SIP endpoint is the same value without sip:.

You can also build it from the CLI: run lk project list --json, take the ProjectId (for example p_abc123xyz) and drop the p_ prefix.

To keep calls in India, you can use the region endpoint abc123xyz.india.sip.livekit.cloud instead.

Create an inbound trunk

The inbound trunk accepts calls to your Vonyx number.

{
  "trunk": {
    "name": "Vonyx inbound",
    "numbers": ["91XXXXXXXXXX"]
  }
}

lk sip inbound create inbound-trunk.json

Save the trunk ID it prints.

Add a dispatch rule that sends calls to your agent

The dispatch rule puts each caller in a new room (prefixed call-) and dispatches your agent to it through room_config.agents. The agent_name must match the name in your agent's rtc_session decorator.

{
  "dispatch_rule": {
    "name": "Vonyx to agent",
    "trunk_ids": ["ST_inbound_xxxxxxxx"],
    "rule": {
      "dispatch_rule_individual": {
        "room_prefix": "call-"
      }
    },
    "room_config": {
      "agents": [{ "agent_name": "YOUR_AGENT_NAME" }]
    }
  }
}

lk sip dispatch create dispatch-rule.json

If you leave out trunk_ids, the rule matches every inbound trunk. In the agent, ctx.job.metadata is empty on inbound calls unless you set metadata on the agent entry, so the code above skips dialing and the agent can greet the caller.

Point Vonyx at LiveKit

In the Vonyx console, open your trunk, turn on Inbound calls and set the Inbound address to your SIP endpoint, for example abc123xyz.sip.livekit.cloud. Leave out sip: and any user part. See Inbound calls.

Vonyx then forwards calls to the attached number from 43.204.9.41.