BYOC (Bring Your Own Carrier)

Overview

BYOC (Bring Your Own Carrier) lets you use your existing phone numbers and SIP trunks with TalkifAI — without porting numbers or changing carriers. This is useful if you:

Already have phone numbers with a carrier
Have existing SIP infrastructure
Need specific carrier features (e.g., local presence, number pools)

How BYOC Works

Your Carrier (Twilio/Telnyx/etc.)
         │
         │  SIP Trunk
         ▼
  LiveKit SIP Server (TalkifAI)
         │
         ▼
  Voice Agent Runtime
         │
         ▼
  AI Agent handles call

TalkifAI connects to your carrier’s SIP trunk. You point your carrier’s inbound calls to TalkifAI’s SIP endpoint and configure outbound calling credentials.

Phone Number Setup

Create a Phone Number

POST /v1/byoc/phone-numbers

{
  "phoneNumber": "+19876543210",
  "inboundAgentId": "agent_support",
  "outboundAgentId": "agent_sales",
  "sipUsername": "your_sip_username",
  "sipPassword": "your_sip_password",
  "terminationUri": "your-trunk.pstn.twilio.com",
  "friendlyName": "Main Support Line"
}

Field	Required	Description
`phoneNumber`	Yes	E.164 format phone number
`terminationUri`	Yes	Your carrier’s SIP termination URI
`inboundAgentId`	No	Agent for incoming calls
`outboundAgentId`	No	Agent for outgoing calls
`sipUsername`	No	SIP authentication username
`sipPassword`	No	SIP authentication password

SIP credentials are encrypted with Fernet before storage. They are never stored in plain text.

Update a Phone Number

PUT /v1/byoc/phone-numbers/{phoneNumber}

{
  "inboundAgentId": "agent_new_support",
  "sipPassword": "updated_password"
}

Delete a Phone Number

DELETE /v1/byoc/phone-numbers/{phoneNumber}

This removes the phone number and all associated SIP trunks from TalkifAI.

Trunk Management

Refresh Trunks for One Number

If a trunk has issues, recreate it:

POST /v1/byoc/trunks/refresh

{
  "phoneNumber": "+19876543210"
}

Refresh All Trunks (Bulk)

For system-wide maintenance or after SIP credential rotation:

POST /v1/byoc/trunks/refresh-all

Refreshing all trunks causes a brief interruption in call handling (typically under 30 seconds). Do this during off-peak hours.

Carrier Setup Guides

Twilio

Create Elastic SIP Trunk

Go to Twilio Console → Elastic SIP Trunking → Trunks → Create Trunk
Name it (e.g., TalkifAI)

Set Origination URI

Add TalkifAI’s SIP endpoint:

sip:livekit.talkifai.dev:5061;transport=tls

Set Termination URI

Note your Termination URI (e.g., your-trunk.pstn.twilio.com) Use this as terminationUri when creating the phone number in TalkifAI.

Add Credentials

Create a Credential List with username/password for outbound authentication.

Telnyx

Create SIP Connection

Go to Telnyx Portal → Voice → SIP Connections → Create

Point to TalkifAI

Set the SIP URI to:

livekit.talkifai.dev:5061

Enable TLS/SRTP for secure media.

Assign Phone Number

In Telnyx Portal, assign your phone number to the SIP Connection.

Security Best Practices

Always use TLS — Add ;transport=tls to your SIP URIs
Rotate SIP passwords regularly
IP ACL — Whitelist TalkifAI’s IP ranges in your carrier settings
Use SRTP — Encrypt media streams, not just signaling

Troubleshooting

Problem	Likely Cause	Fix
Calls not connecting	Wrong Origination URI	Verify SIP endpoint in carrier settings
Authentication failed	Wrong SIP credentials	Update credentials in TalkifAI BYOC settings
Audio quality issues	No TLS/SRTP	Enable secure transport
Agent not answering	No inbound agent assigned	Set `inboundAgentId` for the phone number

Getting Started

Building Agents

Voice & Audio

Telephony

Intelligence & Memory

Analytics & Insights

Organization & Settings

Guides

BYOC (Bring Your Own Carrier)

Overview

How BYOC Works

Phone Number Setup

Create a Phone Number

Update a Phone Number

Delete a Phone Number

Trunk Management

Refresh Trunks for One Number

Refresh All Trunks (Bulk)

Carrier Setup Guides

Twilio

Telnyx

Security Best Practices

Troubleshooting

​Overview

​How BYOC Works

​Phone Number Setup

​Create a Phone Number

​Update a Phone Number

​Delete a Phone Number

​Trunk Management

​Refresh Trunks for One Number

​Refresh All Trunks (Bulk)

​Carrier Setup Guides

​Twilio

​Telnyx

​Security Best Practices

​Troubleshooting

Overview

How BYOC Works

Phone Number Setup

Create a Phone Number

Update a Phone Number

Delete a Phone Number

Trunk Management

Refresh Trunks for One Number

Refresh All Trunks (Bulk)

Carrier Setup Guides

Twilio

Telnyx

Security Best Practices

Troubleshooting