Skip to main content

​
What is Telephony?

The Phone Numbers feature enables your AI agents to make and receive calls through various telephony providers. Purchase new numbers, bring your own existing numbers, or connect via SIP trunking to power your conversational AI experiences over traditional phone networks.
Supported Providers:
  • Twilio - Buy numbers or bring your own Twilio numbers
  • Telnyx - Bring your own Telnyx numbers
  • Maqsam - Regional provider for Middle East numbers
  • SIP Trunk - Connect your existing telephony infrastructure

​
How It Works

Phone numbers connect your AI agents to the telephone network:
  1. Add Number - Purchase, import, or configure a phone number
  2. Assign to Agent - Link the number to a specific AI agent
  3. Configure Calls - Set up inbound and outbound call behavior
  4. Start Calling - Make outbound calls or receive inbound calls
  5. Monitor Usage - Track call history and performance

​
Provider Options

Twilio
  • Purchase new numbers directly through the platform
  • Global coverage with local and toll-free numbers
  • Reliable, established telephony infrastructure
  • Pay-as-you-go pricing
Telnyx
  • Bring your own Telnyx numbers
  • Cost-effective for high-volume calling
  • Global reach with competitive rates
  • Advanced SIP features
Maqsam
  • Specialized Middle East coverage
  • Local numbers for MENA region
  • Regional pricing and support
SIP Trunk
  • Connect existing telephony infrastructure
  • Enterprise-grade integration
  • Custom routing and headers
  • Maximum flexibility

​
Common Use Cases

Inbound Customer Support
  • Assign dedicated support numbers to agents
  • 24/7 automated customer service
  • Intelligent call routing and handling
Outbound Sales & Marketing
  • Automated outbound calling campaigns
  • Lead qualification and follow-ups
  • Appointment reminders and confirmations
Two-Way Communication
  • Receive customer inquiries
  • Make proactive outreach calls
  • Handle inbound and outbound on same number

​
Getting Started

Choose your implementation path:

Configure in Dashboard

Add and manage phone numbers using the web interface. Perfect for purchasing numbers, assigning to agents, and testing calls.

Integrate via API

Manage telephony programmatically. Ideal for making outbound calls at scale and automating number management.

​
Learn More

Webhooks

Receive real-time call events and notifications

Outcomes

Extract structured data from phone conversations

Call History

Review and analyze completed calls

Testing

Test your agents with real phone calls

​
Best Practices

Number Management
  • Use clear, descriptive labels for each number
  • Document which agents are assigned to which numbers
  • Monitor usage and costs regularly
  • Keep provider credentials secure
Security
  • Store API keys and auth tokens securely
  • Never commit credentials to source control
  • Enable two-factor authentication on provider accounts
  • Monitor for unusual call patterns
Call Quality
  • Test numbers from different locations and networks
  • Monitor call success rates and failures
  • Ensure proper audio codec configuration for SIP
  • Track customer feedback on call quality
Cost Optimization
  • Choose appropriate provider for your volume
  • Monitor per-minute costs across providers
  • Set up billing alerts to detect issues
  • Review and optimize call duration