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

# Exotel Integration

> Configure Exotel as your telephony provider for Ringg API - Inbound and Outbound call setup

## Prerequisites

Before starting the integration, ensure you have:

* Exotel account with API access
* Account SID and API Key/Token from Exotel dashboard
* At least one Exotel phone number (ExoPhone)
* Account on Ringg

## Step 1: Exotel Account Setup

### Create an Exotel Account

1. Sign up at [Exotel Dashboard](https://my.exotel.com)
2. Complete KYC verification (required for Indian accounts)
3. Add credits to your account

### Obtain API Credentials

Navigate to Settings → API Settings in your Exotel dashboard:

<CodeGroup>
  ```bash Credentials theme={null}
  ACCOUNT_SID=example1234
  API_KEY=a1b2*********ci9j0
  API_TOKEN=z9y************t3s2r1q0
  SUB_DOMAIN=api.exotel.com
  APP_ID=345*******4234
  ```
</CodeGroup>

## Step 2: ExoPhone Configuration

### Provision an ExoPhone

1. Go to **ExoPhones** in your Exotel dashboard
2. Click **Buy Number** or **Rent Number**
3. Select your preferred region (Delhi, Mumbai, Bangalore, etc.)
4. Complete the purchase

# Outbound

## Step 3: Connect Exotel to Ringg

### Add Exotel as Your Telephony Provider

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

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

    <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="Create Applet">
    go to your exotel console

    click on aapp bazar opions

    create a custom app

    <img src="https://mintcdn.com/ringgai-0da73d20/NBLu_wbRuI7Dt5RA/images/exotel_dashboard.png?fit=max&auto=format&n=NBLu_wbRuI7Dt5RA&q=85&s=442fff8e7fe6ac8af3aa217f7545c4f5" alt="Exotel Dashboard" width="1924" height="871" data-path="images/exotel_dashboard.png" />

    give the name to the app

    <img src="https://mintcdn.com/ringgai-0da73d20/NBLu_wbRuI7Dt5RA/images/exotel_new_app_name.png?fit=max&auto=format&n=NBLu_wbRuI7Dt5RA&q=85&s=b2fffdbd74126989e6c0c8db48e25979" alt="Exotel Dashboard" width="1925" height="873" data-path="images/exotel_new_app_name.png" />

    drag and drop voicebot to the applet

    <img src="https://mintcdn.com/ringgai-0da73d20/NBLu_wbRuI7Dt5RA/images/exotel_applet.png?fit=max&auto=format&n=NBLu_wbRuI7Dt5RA&q=85&s=bf6fe249496f492dc48414fb80ad5f97" alt="Exotel Dashboard" width="1919" height="874" data-path="images/exotel_applet.png" />

    add this url to it
    wss\://use1-api.ringg.ai/pc/v1/exotel/ws

    <img src="https://mintcdn.com/ringgai-0da73d20/NBLu_wbRuI7Dt5RA/images/exotel_voicebot.png?fit=max&auto=format&n=NBLu_wbRuI7Dt5RA&q=85&s=3e3ca2dbd95a89163b2cc2f98eb79538" alt="Exotel Dashboard" width="1925" height="874" data-path="images/exotel_voicebot.png" />
  </Step>

  <Step title="Enter Credentials">
    Fill in your Exotel 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 Exotel Auth ID
    * **API\_KEY**: Your Exotel Auth Token
    * **API\_TOKEN**: Your Exotel Auth ID
    * **SUB\_DOMAIN**: Your Exotel Auth Token
    * **APP\_ID** : Your Applet app id
  </Step>

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

<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 Exotel Numbers

## 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: Configure Inbound Calls

### Attach Numbers to AI Assistants

<Steps>
  <Step title="Go to Numbers Management">
    Navigate to **Numbers** → **Manage Numbers** in your dashboard
  </Step>

  <Step title="Select Your Exotel Number">
    Click on the Exotel number you want to configure
  </Step>

  <Step title="Assign AI Assistant">
    Choose which AI assistant should handle inbound calls to this number
  </Step>

  <Step title="Configure Call Settings">
    Set up:

    * Call recording preferences
    * Transcription options
    * Webhook notifications
  </Step>

  <Step title="Save Configuration">
    Click **"Save"** to apply your settings
  </Step>
</Steps>

<img src="https://mintcdn.com/ringgai-0da73d20/NBLu_wbRuI7Dt5RA/images/attach_inbound_number.png?fit=max&auto=format&n=NBLu_wbRuI7Dt5RA&q=85&s=eeb6571d8db45f63876763fd645b1c72" alt="Attach Inbound Number" width="1926" height="940" data-path="images/attach_inbound_number.png" />