Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tryhamsa.com/llms.txt

Use this file to discover all available pages before exploring further.

​
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