Telephony Providers

Configure Twilio, Telnyx, or Vonage for your voice AI assistants

Burki Voice AI supports Twilio, Telnyx, and Vonage as telephony providers. You can use different providers for different assistants, enabling cost optimization, global coverage, and redundancy.

---

Provider Comparison

Choose the provider that best fits your needs:

Twilio

Established Platform

• Global presence and reliability
• Extensive documentation
• Media Streams for real-time audio
• SMS/MMS messaging support
• Wide range of phone numbers

Telnyx

Developer-Focused

• Call Control API
• Competitive pricing
• SMS/MMS messaging support
• Global carrier-grade network
• WebRTC and SIP support

Vonage

Global Communications

• Part of Ericsson ecosystem
• Strong international coverage
• WebSocket audio streaming
• SMS/MMS messaging support
• 10DLC compliance tools
• Regional API endpoints (EU, APAC)

---

Feature Comparison

Feature	Twilio	Telnyx	Vonage
Voice Calls	Yes	Yes	Yes
SMS/MMS	Yes	Yes	Yes
Call Recording	Yes	Yes	Yes
Call Transfer	Yes	Yes	Yes
Real-time Audio	Media Streams	Call Control	WebSocket
Global Numbers	Yes	Yes	Yes
Regional Compliance	-	-	EU, APAC endpoints
10DLC Support	Yes	Yes	Yes

---

Setting Up Telephony

Using Burki Cloud

The easiest way to get started:

1. Purchase a Number

   Go to Phone Numbers → Purchase in your dashboard. Search by country, area code, or pattern.

2. Assign to Assistant

   Select the number and assign it to an assistant. Burki handles all webhook configuration automatically.

3. Start Receiving Calls

   Your assistant is ready! Calls to the number will be handled by your AI assistant.

Using Your Own Provider Account (BYO)

If you have existing Twilio, Telnyx, or Vonage accounts:

1. Add Credentials

   Go to Settings → Provider Keys → Telephony and enter your provider credentials.

2. Sync Your Numbers

   Go to Phone Numbers → Sync to import your existing numbers from the provider.

3. Assign to Assistants

   Your synced numbers can now be assigned to assistants just like Burki-purchased numbers.

---

Provider Setup Guides

Twilio

Twilio Setup

1. Get Your Credentials

• Sign up at Twilio Console
• Find your Account SID and Auth Token in the dashboard

2. Add to Burki

• Go to Settings → Provider Keys → Telephony
• Select Twilio and enter your credentials
• Click Save

3. Sync Numbers

• Go to Phone Numbers → Sync
• Your Twilio numbers will appear and can be assigned to assistants

Burki automatically configures Twilio webhooks when you sync numbers. No manual webhook setup required.

Twilio Features

• Inbound/Outbound calls
• Call recording
• Call transfer
• Real-time audio streaming
• SMS/MMS capabilities
• Global phone numbers

Telnyx

Telnyx Setup

1. Get Your Credentials

• Sign up at Telnyx Portal
• Create a Call Control Application and note the Connection ID
• Find your API Key in the API Keys section

2. Add to Burki

• Go to Settings → Provider Keys → Telephony
• Select Telnyx and enter your API Key and Connection ID
• Click Save

3. Sync Numbers

• Go to Phone Numbers → Sync
• Your Telnyx numbers will appear and can be assigned to assistants

Burki automatically configures Telnyx webhooks when you sync numbers.

Telnyx Features

• Inbound/Outbound calls
• Call recording
• Call transfer
• WebRTC support
• SMS/MMS capabilities
• Competitive pricing

Vonage

Vonage Setup

1. Get Your Credentials

• Sign up at Vonage Dashboard
• Create an application with Voice capability enabled
• Note your API Key, API Secret, Application ID, and download the Private Key

2. Add to Burki

• Go to Settings → Provider Keys → Telephony
• Select Vonage and enter your credentials
• Paste the full private key content (including BEGIN/END markers)
• Click Save

3. Sync Numbers

• Go to Phone Numbers → Sync
• Your Vonage numbers will appear and can be assigned to assistants

Burki automatically configures Vonage webhooks when you save credentials. Your Vonage Application will be updated to point to Burki.

Vonage Features

• Inbound/Outbound calls
• Call recording
• Call transfer (blind transfer)
• WebSocket audio streaming
• SMS/MMS capabilities
• 10DLC compliance support
• Voicemail detection (AMD)
• DTMF tone sending
• Global phone numbers

Regional Configuration

Vonage supports regional API endpoints for data residency compliance. Configure in your organization settings:

Region	Use Case
US (default)	North America
Europe	EU data residency, GDPR
Asia Pacific	APAC compliance

10DLC Compliance (US)

For US SMS messaging, you need 10DLC registration:

1. Register your brand in Vonage Dashboard under 10DLC
2. Create a campaign for your use case
3. Add your Brand ID and Campaign ID in Organization Settings

Burki will automatically link newly purchased Vonage numbers to your 10DLC campaign.

---

Per-Assistant Configuration

Each assistant can use different telephony credentials:

1. Edit Assistant

   Go to your assistant’s settings page.

2. Configure Telephony

   In the Telephony section, you can:

   • Use organization defaults (recommended)
   • Override with assistant-specific credentials
3. Assign Numbers

   Assign phone numbers that use the appropriate provider credentials.

Best Practice: Use organization-level credentials as defaults, and only override at the assistant level when you have specific requirements (e.g., different regions, different billing accounts).

---

Mixed Provider Setup

You can use different providers for different use cases:

Use Case	Recommended Approach
US/Canada focus	Any provider works well
EU data residency	Vonage with Europe region
APAC compliance	Vonage with Asia Pacific region
Cost optimization	Compare pricing for your call volumes
Existing relationship	Use your current provider with BYO

---

Troubleshooting

Calls Not Connecting

Check:

• Credentials are valid in Settings → Provider Keys
• Phone number is assigned to an assistant
• Provider account has sufficient balance
• Number has voice capability enabled

Poor Audio Quality

Try:

• Check your internet connection stability
• Ensure the caller has good reception
• Review call logs for any errors
• Contact support if issues persist

Numbers Not Syncing

Check:

• Credentials are correct and have proper permissions
• Numbers are active in your provider account
• Numbers have voice capability enabled
• Try re-syncing from Phone Numbers → Sync

SMS Not Sending

Check:

• Number has SMS capability
• Provider account has SMS enabled
• For US numbers: 10DLC registration is complete
• Message content doesn’t violate carrier policies

---

Best Practices

• Start with one provider and add others for specific use cases
• Test thoroughly before going live with production traffic
• Monitor costs and usage patterns in your provider dashboards
• Keep credentials secure and rotate them periodically
• Use regional endpoints for compliance requirements (Vonage EU/APAC)
• Set up 10DLC for US SMS messaging before sending at scale

---

Next Steps

Phone Number Management

Purchase and manage phone numbers

Call Management

Configure call handling and transfers

Messaging

Set up SMS and MMS messaging

BYO API Keys

Use your own provider accounts