Configure with Telnyx

​

Overview

This guide walks you through configuring a Telnyx SIP trunk to work with SubVerse AI for both inbound and outbound calls.

​

Prerequisites

• Active Telnyx account
• Purchase a Telnyx phone number
• Access to Telnyx Mission Control Portal

​

Step 1: Get Your SubVerse SIP URI

Before configuring Telnyx, you need to obtain your SIP URI from SubVerse:

1. Log in to your SubVerse dashboard
2. Navigate to Integrations → Telephony
3. Copy your SIP URI (it will look like: sip:xxxxx.sip.livekit.cloud)

​

Step 2: Create a SIP Connection

1. Log in to Telnyx Mission Control Portal
2. Navigate to Voice → SIP Connections
3. Click Create SIP Connection
4. Select Credentials as the authentication method
5. Enter a Connection Name (e.g., “SubVerse AI Connection”)
6. Click Create

​

Step 3: Configure Authentication

​

Set Up Credentials

1. In your SIP Connection settings, go to Authentication
2. Click Add Credential
3. Enter:
   • Username: Your chosen username
   • Password: Your chosen strong password
4. Click Save

​

Configure IP Authentication (Optional)

If you prefer IP-based authentication:

1. In Authentication settings, enable IP Authentication
2. Add IP ranges:
   • 0.0.0.0/1
   • 128.0.0.0/1
3. Click Save

​

Step 4: Configure for Inbound Calls

Configure the connection to route incoming calls to SubVerse.

​

Set Inbound Settings

1. In your SIP Connection, go to Inbound
2. Under Inbound Settings, configure:
   • Codecs: Select PCMU and PCMA
   • DTMF Type: RFC 2833 or Inband
   • Inbound SIP URI: Your SubVerse SIP URI (from Step 1)
3. Enable Send SIP OPTIONS
4. Click Save

​

Configure Origination URI

1. In the Inbound section, find Origination URI
2. Enter your SubVerse SIP URI
3. Set Priority: 1
4. Enable the URI
5. Click Save

​

Step 5: Configure for Outbound Calls

Configure settings for outbound calls from SubVerse through Telnyx.

​

Set Outbound Settings

1. In your SIP Connection, go to Outbound
2. Under Outbound Settings, configure:
   • Outbound Voice Profile: Select or create a profile
   • Codecs: Select PCMU and PCMA
   • Localization: Select your preferred region
3. Enable Generate Ring Tone
4. Click Save

​

Configure Termination URI

1. In the Outbound section, note your Termination SIP URI
2. It will look like: sip:yourconnection.sip.telnyx.com
3. Copy this URI - you’ll need it for SubVerse configuration

​

Step 6: Associate Phone Number

​

Assign Number to SIP Connection

1. Navigate to Numbers → My Numbers
2. Find your phone number
3. Click on the number to edit
4. Under Connection, select your SIP Connection
5. Configure:
   • Connection Type: SIP Connection
   • Connection: Select your SubVerse connection
6. Click Save

​

Step 7: Configure in SubVerse Dashboard

Now that Telnyx is configured, add the trunk to SubVerse:

​

For Outbound Calls

1. Go to SubVerse Integrations → Telephony
2. Click Add Outbound Trunk
3. Enter:
   • Name: Descriptive name (e.g., “Telnyx Outbound”)
   • Phone Number: Your Telnyx number with country code (e.g., +1xxxxxxxxxx)
   • SIP Address: Your Telnyx termination URI (e.g., yourconnection.sip.telnyx.com)
   • Auth Username: Username from Step 3
   • Auth Password: Password from Step 3
4. Click Save

​

For Inbound Calls

1. Go to SubVerse Integrations → Telephony
2. Click Add Inbound Trunk
3. Enter:
   • Name: Descriptive name (e.g., “Telnyx Inbound”)
   • Phone Number: Your Telnyx number with country code (e.g., +1xxxxxxxxxx)
   • Auth Username: Username from Step 3
   • Auth Password: Password from Step 3
4. Click Map Voicebot Usecase and select your voice agent
5. Click Save

​

Testing Your Configuration

​

Test Inbound Calls

1. Call your Telnyx phone number
2. The call should be routed to your SubVerse voice agent
3. Check the call appears in SubVerse Call History

​

Test Outbound Calls

1. Create a workflow or use the voice agent interface
2. Make a test call using your configured Telnyx number
3. Verify the call connects successfully
4. Check the call appears in SubVerse Call History

​

Troubleshooting

​

Inbound Calls Not Working

Check:

• Origination URI is correctly configured in Telnyx
• SIP URI matches exactly what’s shown in SubVerse dashboard
• Phone number is associated with the SIP connection
• Voice agent is mapped to the inbound trunk in SubVerse

Solution:

• Verify SIP URI in Telnyx matches SubVerse
• Check Telnyx call logs for errors
• Ensure phone number is active
• Verify SIP connection status is “Active”

​

Outbound Calls Not Working

Check:

• Credentials are correctly configured
• Username and password match in both Telnyx and SubVerse
• Termination URI is correctly configured
• SIP address in SubVerse matches Telnyx connection

Solution:

• Verify credentials are correct
• Check Telnyx connection status
• Review call logs for authentication errors
• Ensure sufficient Telnyx account balance

​

Call Quality Issues

Check:

• Codec configuration (PCMU/PCMA recommended)
• Network connectivity
• Telnyx service status
• Region-specific routing

Solution:

• Verify codec settings match on both sides
• Use region-based SIP endpoints for better latency
• Check Telnyx status page
• Contact SubVerse support for assistance

​

Authentication Failures

Check:

• Credentials are entered correctly
• IP authentication ranges (if using IP auth)
• SIP connection is enabled

Solution:

• Re-enter credentials carefully
• Verify IP ranges include required addresses
• Check SIP connection status in Telnyx portal

​

Advanced Configuration

​

Codec Optimization

For best call quality:

• Enable PCMU (G.711 μ-law) - Primary
• Enable PCMA (G.711 A-law) - Secondary
• Disable other codecs unless specifically needed

​

DTMF Configuration

Configure DTMF for interactive voice response:

• Recommended: RFC 2833
• Alternative: Inband
• Ensure both Telnyx and SubVerse use the same method

​

Failover Configuration

Set up multiple origination URIs for redundancy:

1. Add primary SubVerse SIP URI with Priority 1
2. Add backup SIP URI with Priority 2
3. Enable both URIs

​

Additional Resources

• Telnyx SIP Trunking Documentation
• Telnyx SIP Configuration Guide
• Telnyx Mission Control Portal
• Telnyx Support

​

Next Steps