Prerequisites: This guide assumes you have already completed the Dialer Config setup in your Vodex project and obtained your SIP URI. If you haven’t done this yet, please refer to the Inbound Overview first.
🎯 Configuration Overview
When you complete this setup:- Incoming calls to your Twilio phone number → Automatically answered by Vodex AI
- No human intervention required for call handling
- Consistent AI behavior using your locked Dialer Config settings
- Seamless integration between Twilio and Vodex platforms
⚙️ Step-by-Step Twilio Configuration
Step 1: Complete Dialer Config Setup
Before proceeding, ensure you have:- ✅ Created and tested your reference call in Vodex
- ✅ Attached the call in Dialer Config section
- ✅ Obtained your SIP URI:
sip:xxxxxxxxxx@34.27.110.155:5080 - ✅ Noted down the
xxxxxxxxxxidentifier from your SIP URI
Step 2: Access Twilio SIP Trunking
1
Login to Twilio Console
Navigate to SIP Trunking
- Open your browser and go to Twilio Console
- Login with your Twilio account credentials
- Navigate to Develop → Elastic SIP Trunking → Trunks
2
Create New SIP Trunk
Set Up Trunk
- Click “Create new SIP Trunk” button
- Enter a descriptive name (e.g., “Vodex-AI-Inbound”)
- Add any relevant description for future reference
- Click “Create” to proceed
Step 3: Configure Origination Settings
1
Access Origination Section
Navigate to Origination
- In your newly created SIP Trunk, click on “Origination” tab
- This is where you’ll configure how Twilio routes incoming calls
- Click “Add Origination URI” to create a new route
2
Configure Origination URI
Enter Vodex SIP DetailsOrigination URI:Configuration Parameters:
- URI:
sip:+xxxxxxxxxx@34.27.110.155:5080;transport=tcp - Priority:
10 - Weight:
10
3
Save Configuration
Finalize Setup
- Double-check all parameters are correct
- Verify the SIP URI matches your Vodex configuration
- Click “Save Configuration” or “Add” to apply settings
- Confirm the origination URI appears in your trunk configuration
🔧 Configuration Details
SIP URI Format Breakdown
| Component | Value | Description |
|---|---|---|
| Protocol | sip: | SIP protocol identifier |
| User | +xxxxxxxxxx | Your unique Vodex SIP identifier (with + prefix) |
| Host | 34.27.110.155 | Vodex SIP gateway IP address |
| Port | 5080 | SIP communication port |
| Transport | tcp | Transport protocol for reliable delivery |
Priority and Weight Settings
| Parameter | Recommended Value | Purpose |
|---|---|---|
| Priority | 10 | Lower numbers = higher priority |
| Weight | 10 | Load balancing weight (higher = more traffic) |
Settings Explanation: Priority 10 and Weight 10 are standard values that work well for most configurations. Priority determines route preference (lower numbers get higher priority), while weight handles load distribution among routes with the same priority.
📞 Linking Phone Numbers
Step 4: Connect Phone Number to SIP Trunk
1
Navigate to Phone Numbers
Access Phone Number Management
- In Twilio Console, go to Phone Numbers → Manage → Active Numbers
- Find the phone number you want to connect to Vodex AI
- Click on the phone number to edit its configuration
2
Configure Voice Settings
Set Up Call Routing
- In the phone number configuration, find “Voice & Fax” section
- Set “Configure with” to “SIP Trunk”
- Select your newly created Vodex SIP Trunk from the dropdown
- Save the configuration
3
Test Configuration
Verify Setup
- Call your Twilio phone number from any phone
- The call should be automatically answered by your Vodex AI agent
- Verify the AI responds according to your Dialer Config settings
- Check call quality and conversation flow
🔄 How It Works
Call Flow Process
What Happens During a Call
📥 Call Arrival
📥 Call Arrival
Incoming Call Processing
- Customer dials your Twilio phone number
- Twilio receives the call and checks configuration
- Call is routed to your configured SIP Trunk
- SIP Trunk forwards call to Vodex via Origination URI
🤖 AI Activation
🤖 AI Activation
Vodex AI Engagement
- Vodex SIP Gateway receives the call
- System extracts your unique identifier from SIP URI
- Looks up your attached Dialer Config settings
- Loads the frozen AI agent configuration
- AI answers the call and begins conversation
💬 Conversation Management
💬 Conversation Management
Call Handling
- AI uses your locked prompt and personality settings
- Processes customer input using configured AI model
- Applies custom fields and insights collection
- Maintains consistent behavior throughout the call
- Generates insights and call summary upon completion
✅ Verification and Testing
Testing Your Setup
1
Initial Test Call
Basic Functionality Check
- Call your Twilio phone number from any device
- Verify the call is answered automatically
- Confirm the AI agent responds appropriately
- Test basic conversation flow
2
Quality Assessment
Detailed Testing
- Test different conversation scenarios
- Verify custom fields are being collected
- Check insights generation in your Vodex dashboard
- Assess call quality and response timing
3
Integration Validation
End-to-End Verification
- Confirm calls appear in your Vodex project
- Review transcripts and conversation data
- Verify any webhook integrations are working
- Test multiple concurrent calls if needed
Troubleshooting Common Issues
🚫 Call Not Connecting
🚫 Call Not Connecting
Connection IssuesPossible Causes:
- Incorrect SIP URI in Twilio configuration
- Missing or wrong Vodex SIP identifier
- Twilio trunk not properly linked to phone number
- Double-check your SIP URI format and identifier
- Verify the origination URI is saved correctly
- Confirm phone number is linked to the correct SIP trunk
- Check Twilio console for error logs
📞 AI Not Responding
📞 AI Not Responding
Response IssuesPossible Causes:
- Dialer Config not properly set up in Vodex
- Reference call not attached or configured incorrectly
- SIP identifier mismatch between Twilio and Vodex
- Verify your Dialer Config setup in Vodex project
- Ensure reference call is properly attached
- Check that SIP identifiers match exactly
- Test the reference call directly in Vodex
🔊 Audio Quality Issues
🔊 Audio Quality Issues
Call Quality ProblemsPossible Causes:
- Network connectivity issues
- Incorrect transport protocol
- SIP trunk configuration problems
- Ensure transport=tcp is specified in URI
- Check network connectivity between Twilio and Vodex
- Verify SIP trunk configuration is complete
- Contact support if issues persist
🔧 Advanced Configuration
Multiple Phone Numbers
Scaling Your Setup
Connecting Multiple NumbersYou can connect multiple Twilio phone numbers to the same Vodex AI configuration:
- Same SIP Trunk: Link multiple phone numbers to your existing SIP trunk
- Same AI Agent: All numbers will use the same attached Dialer Config
- Consistent Experience: Customers get the same AI interaction regardless of which number they call
- Centralized Management: Manage all inbound calls from one Vodex configuration
Different AI Agents per Number
Customized Experiences
Multiple ConfigurationsFor different AI behaviors per phone number:
- Create separate SIP Trunks in Twilio for each configuration
- Set up different Dialer Configs in Vodex with unique SIP URIs
- Link each phone number to its corresponding SIP trunk
- Different AI experiences for different business lines or purposes
📋 Configuration Checklist
Pre-Configuration
- Vodex Dialer Config completed
- SIP URI obtained from Vodex (
sip:xxxxxxxxxx@34.27.110.155:5080) - Twilio account with SIP Trunking enabled
- Phone number purchased and active in Twilio
Twilio Configuration
- SIP Trunk created with descriptive name
- Origination URI configured:
sip:+xxxxxxxxxx@34.27.110.155:5080;transport=tcp - Priority set to
10 - Weight set to
10 - Configuration saved successfully
Phone Number Linking
- Phone number configured to use SIP Trunk
- Voice settings updated to route through trunk
- Configuration saved and active
Testing and Validation
- Test call completed successfully
- AI agent responds appropriately
- Call quality is acceptable
- Insights and data collection working
- Integration verified end-to-end
💡 Best Practices
Configuration Management
- Document your setup - Keep records of SIP URIs and configuration details
- Use descriptive names - Name your SIP trunks clearly for easy identification
- Test thoroughly - Always test after making any configuration changes
- Monitor performance - Regularly check call quality and AI performance
Security Considerations
- Protect SIP URIs - Don’t share your SIP identifiers publicly
- Monitor usage - Watch for unexpected call patterns or volumes
- Regular audits - Periodically review your Twilio and Vodex configurations
- Access control - Limit who can modify your SIP trunk configurations
🚀 Next Steps
After completing your Twilio configuration:- Monitor Call Performance - Track call quality and AI behavior
- Optimize AI Prompts - Refine your Dialer Config based on inbound scenarios
- Scale Your Operations - Add more phone numbers as needed
- Integrate Analytics - Connect call data to your reporting systems
- Train Your Team - Ensure staff understand the inbound AI system
Twilio Integration Complete! Your phone number is now powered by Vodex AI. Incoming calls will be automatically answered and handled by your configured AI agent using the locked Dialer Config settings.
Need help with your Twilio configuration? Contact our support team at support@vodex.ai with “Twilio Inbound Setup” in the subject line for assistance with complex configurations or troubleshooting.