> ## Documentation Index
> Fetch the complete documentation index at: https://docs.burki.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Telephony Providers

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

<Callout type="info">
  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.
</Callout>

***

## Provider Comparison

Choose the provider that best fits your needs:

<CardGroup cols={3}>
  <Card title="Twilio" icon="phone">
    **Established Platform**

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

  <Card title="Telnyx" icon="bolt">
    **Developer-Focused**

    * Call Control API
    * Competitive pricing
    * SMS/MMS messaging support
    * Global carrier-grade network
    * WebRTC and SIP support
  </Card>

  <Card title="Vonage" icon="globe">
    **Global Communications**

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

***

## 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:

<Steps>
  <Step title="Purchase a Number">
    Go to **Phone Numbers** → **Purchase** in your dashboard. Search by country, area code, or pattern.
  </Step>

  <Step title="Assign to Assistant">
    Select the number and assign it to an assistant. Burki handles all webhook configuration automatically.
  </Step>

  <Step title="Start Receiving Calls">
    Your assistant is ready! Calls to the number will be handled by your AI assistant.
  </Step>
</Steps>

### Using Your Own Provider Account (BYO)

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

<Steps>
  <Step title="Add Credentials">
    Go to **Settings** → **Provider Keys** → **Telephony** and enter your provider credentials.
  </Step>

  <Step title="Sync Your Numbers">
    Go to **Phone Numbers** → **Sync** to import your existing numbers from the provider.
  </Step>

  <Step title="Assign to Assistants">
    Your synced numbers can now be assigned to assistants just like Burki-purchased numbers.
  </Step>
</Steps>

***

## Provider Setup Guides

<Tabs>
  <Tab title="Twilio">
    ### Twilio Setup

    **1. Get Your Credentials**

    * Sign up at [Twilio Console](https://console.twilio.com/)
    * 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

    <Note>
      Burki automatically configures Twilio webhooks when you sync numbers. No manual webhook setup required.
    </Note>

    ### Twilio Features

    * Inbound/Outbound calls
    * Call recording
    * Call transfer
    * Real-time audio streaming
    * SMS/MMS capabilities
    * Global phone numbers
  </Tab>

  <Tab title="Telnyx">
    ### Telnyx Setup

    **1. Get Your Credentials**

    * Sign up at [Telnyx Portal](https://portal.telnyx.com/)
    * 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

    <Note>
      Burki automatically configures Telnyx webhooks when you sync numbers.
    </Note>

    ### Telnyx Features

    * Inbound/Outbound calls
    * Call recording
    * Call transfer
    * WebRTC support
    * SMS/MMS capabilities
    * Competitive pricing
  </Tab>

  <Tab title="Vonage">
    ### Vonage Setup

    **1. Get Your Credentials**

    * Sign up at [Vonage Dashboard](https://dashboard.vonage.com/)
    * 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

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

    ### 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.
  </Tab>
</Tabs>

***

## Per-Assistant Configuration

Each assistant can use different telephony credentials:

<Steps>
  <Step title="Edit Assistant">
    Go to your assistant's settings page.
  </Step>

  <Step title="Configure Telephony">
    In the **Telephony** section, you can:

    * Use organization defaults (recommended)
    * Override with assistant-specific credentials
  </Step>

  <Step title="Assign Numbers">
    Assign phone numbers that use the appropriate provider credentials.
  </Step>
</Steps>

<Tip>
  **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).
</Tip>

***

## 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

<AccordionGroup>
  <Accordion title="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
  </Accordion>

  <Accordion title="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
  </Accordion>

  <Accordion title="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**
  </Accordion>

  <Accordion title="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
  </Accordion>
</AccordionGroup>

***

## 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

<CardGroup cols={2}>
  <Card title="Phone Number Management" icon="hashtag" href="/phone-number-management">
    Purchase and manage phone numbers
  </Card>

  <Card title="Call Management" icon="phone-arrow-right" href="/call-management">
    Configure call handling and transfers
  </Card>

  <Card title="Messaging" icon="message" href="/messaging">
    Set up SMS and MMS messaging
  </Card>

  <Card title="BYO API Keys" icon="key" href="/byo-api-keys">
    Use your own provider accounts
  </Card>
</CardGroup>