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

# Twilio Integration

> Configure Twilio as your telephony provider for Ringg API - Complete setup guide for inbound and outbound calls

## Prerequisites

Before starting the integration, ensure you have:

* Active Twilio account with API access
* Account SID and Auth Token from Twilio Console
* At least one Twilio phone number
* Active Ringg workspace with admin access

## Step 1: Twilio Account Setup

### Create a Twilio Account

1. Sign up at [Twilio Console](https://console.twilio.com)
2. Complete account verification process
3. Add credits to your account for phone number rental and calls

### Obtain API Credentials

Navigate to your Twilio dashboard and locate your API credentials:

<CodeGroup>
  ```bash Credentials theme={null}
  ACCOUNT_SID=AC********************************
  AUTH_TOKEN=********************************
  ```
</CodeGroup>

## Step 2: Phone Number Configuration

### Purchase a Phone Number

1. Navigate to **Phone Numbers** → **Manage** → **Buy a number** in Twilio Console
2. Select your preferred country and number type:
   * **Local Numbers**: Best for regional presence
   * **Toll-free Numbers**: Professional appearance for customer service
   * **Mobile Numbers**: Available in select countries
3. Complete the purchase

### Configure Voice Settings

Your Twilio numbers will be automatically configured for voice calls when you add them to Ringg.

## Step 3: Connect Twilio to Ringg

### Add Twilio as Your Telephony Provider

<Steps>
  <Step title="Navigate to Integrations">
    Go to your Ringg dashboard and click **Integrations** → **Telephony Integration**
  </Step>

  <Step title="Select Twilio Provider">
    Click **"Add Telephony Provider"** and select **Twilio**

    <img src="https://mintcdn.com/ringgai-0da73d20/NBLu_wbRuI7Dt5RA/images/byot_provider_selection.png?fit=max&auto=format&n=NBLu_wbRuI7Dt5RA&q=85&s=5f057d8b9cc2f09ad86247dfe189cd91" alt="BYOT Provider Selection" width="1930" height="874" data-path="images/byot_provider_selection.png" />
  </Step>

  <Step title="Enter Credentials">
    Fill in your Twilio credentials:

    <img src="https://mintcdn.com/ringgai-0da73d20/NBLu_wbRuI7Dt5RA/images/provider_creds.png?fit=max&auto=format&n=NBLu_wbRuI7Dt5RA&q=85&s=90888d3b8846493754e7c882f27acb8b" alt="Provider Credentials Form" width="1920" height="870" data-path="images/provider_creds.png" />

    * **Account SID**: Your Twilio Account SID
    * **Auth Token**: Your Twilio Auth Token
  </Step>

  <Step title="Test Connection & Save">
    Click **"Test Connection"** to verify your credentials are working and save them
  </Step>
</Steps>

Now provider is added to your ringg workspace

<img src="https://mintcdn.com/ringgai-0da73d20/NBLu_wbRuI7Dt5RA/images/provider_added.png?fit=max&auto=format&n=NBLu_wbRuI7Dt5RA&q=85&s=65646e4f3f3c4c0737470c9a1799a8c1" alt="Provider Successfully Added" width="1922" height="871" data-path="images/provider_added.png" />

## Step 4: Use Twilio Number in Ringg Dashboard

## Number Management

For comprehensive number management features, including:

* Buy Number
* Import numbers from telephony
* Attach number to agent

See our detailed [Number Management Guide](/telephony/number-management).

## Step 5: Test Your Integration

### Test Inbound Calls

1. **Basic Functionality Test**
   * Call your Twilio number from any phone
   * Verify the AI assistant answers and responds appropriately
   * Check that the conversation flows naturally

2. **Dashboard Verification**
   * Monitor the call in your Ringg dashboard
   * Verify call logs appear in both Ringg and Twilio
   * Check that recordings and transcriptions are generated

### Test Call Quality

<AccordionGroup>
  <Accordion title="Audio Quality Checklist">
    * Clear, crisp audio without distortion
    * No echo or feedback issues
    * Appropriate volume levels
    * Minimal latency in conversation
  </Accordion>

  <Accordion title="AI Assistant Performance">
    * Assistant responds promptly to caller input
    * Conversation flows naturally without awkward pauses
    * Assistant understands and responds accurately
    * Proper handling of interruptions and overlapping speech
  </Accordion>

  <Accordion title="Call Completion">
    * Calls complete successfully without dropping
    * Proper call termination when conversation ends
    * Accurate call duration tracking
    * Complete transcription capture
  </Accordion>
</AccordionGroup>

## Troubleshooting

### Common Issues

<AccordionGroup>
  <Accordion title="Connection Issues">
    **Problem**: Unable to connect Twilio account to Ringg

    **Solutions**:

    * Verify Account SID and Auth Token are correct
    * Ensure Twilio account has sufficient credits
    * Check that API access is enabled in Twilio console
    * Verify account is not suspended or restricted
  </Accordion>

  <Accordion title="Import Problems">
    **Problem**: Numbers not appearing during import

    **Solutions**:

    * Confirm numbers are active in your Twilio account
    * Check that numbers have voice capabilities enabled
    * Verify regional availability (some numbers may be restricted)
    * Ensure proper account permissions for API access
  </Accordion>

  <Accordion title="Call Quality Issues">
    **Problem**: Poor audio quality or dropped calls

    **Solutions**:

    * Check your internet connection stability
    * Verify Twilio service status for your region
    * Test with different phone numbers and devices
    * Contact Twilio support if issues persist regionally
  </Accordion>

  <Accordion title="AI Assistant Not Responding">
    **Problem**: Calls connect but AI assistant doesn't respond

    **Solutions**:

    * Verify assistant is properly assigned to the number
    * Check assistant configuration and status
    * Review webhook logs for any errors
    * Ensure assistant has proper knowledge base setup
  </Accordion>
</AccordionGroup>

### Debug Tools

<CardGroup cols={2}>
  <Card title="Ringg Call Logs" icon="list">
    Monitor real-time call events and status in your dashboard
  </Card>

  <Card title="Twilio Console Logs" icon="terminal">
    Review API calls and webhook deliveries in Twilio Console
  </Card>

  <Card title="Webhook Testing" icon="gear">
    Test webhook connectivity and payload delivery
  </Card>

  <Card title="Audio Diagnostics" icon="chart-line">
    Analyze call quality metrics and performance data
  </Card>
</CardGroup>

## Support Resources

<CardGroup cols={2}>
  <Card title="Twilio Documentation" icon="book" href="https://www.twilio.com/docs/">
    Official Twilio API documentation and guides
  </Card>

  <Card title="Twilio Support" icon="headset" href="https://support.twilio.com/">
    Technical support and troubleshooting assistance
  </Card>

  <Card title="Ringg Community" icon="users" href="https://discord.com/invite/nWXREVz2vy">
    Join our Discord community for tips and support
  </Card>

  <Card title="Contact Support" icon="envelope" href="mailto:admin@ringg.ai">
    Reach out to our team for integration assistance
  </Card>
</CardGroup>