> For clean Markdown of any page, append `.md` to the page URL.
> For a complete documentation index, see https://docs.sarvam.ai/llms.txt.
> For full documentation content in one file, see https://docs.sarvam.ai/llms-full.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.sarvam.ai/_mcp/server.

# Exotel

Connect your Exotel account to Voice Agents for inbound and outbound voice calling.

Setup has two parts: add your Exotel credentials on Voice Agents, then configure the call flow on Exotel's dashboard.

**Before you start:** an active Exotel account with admin access to its dashboard, at least one **Exophone** (Exotel's term for a virtual phone number), and Voice Agents access with permission to add telephony connections (**Deploy → Phone Numbers**).

## Watch the setup

## Add the connection on Voice Agents

Voice Agents needs four values from your Exotel account — the **Account SID**, **API Key**, **API Token**, and **Base URL**. Get them from the [Exotel dashboard](https://my.exotel.com), then enter them on Sarvam.

#### Get your Account SID (on Exotel)

In the Exotel dashboard, go to **Settings → API Settings** and copy the **Account SID**.

#### Get your API Key (on Exotel)

On the same page, under **API Credentials**, copy the **API Key**. Click **Create** to generate one if it doesn't exist yet.

#### Get your API Token (on Exotel)

Copy the **API Token** shown alongside the API Key.

The API Token is shown only once when generated. Save it immediately.

#### Find your Base URL (on Exotel)

The Base URL is the API domain for your Exotel account's region. India accounts use `api.in.exotel.com`; Singapore accounts use `api.exotel.com`. Confirm yours from the domain in your Exotel dashboard URL, or on the **API Credentials** page (top of your dashboard, or under **Developer Settings**).

#### Enter and save on Voice Agents

In Voice Agents, go to **Deploy → Phone Numbers → Add Connection**, select **Exotel**, and enter all four values — **Account SID**, **API Key**, **API Token**, and **Base URL** — then click **Save**. The connection now appears under **Deploy → Phone Numbers**.

***

## Configure the call flow on Exotel

Create an Exotel App that routes incoming calls to your Sarvam agent, then assign it to your Exophone.

#### Create a new App

In the Exotel dashboard, open **App Bazaar** and click **Create** to add a new App. Give it a recognizable name (e.g. `sarvam-prod`).

#### Add the Voicebot applet

In the App flow editor, drag the **Voicebot** applet into the **Call Start** flow. (If you don't see it, search for "Voicebot" in the applet list.)

#### Configure the WebSocket URL

In the Voicebot applet, under **"Which bot you want to connect the enduser?"**, enter the Sarvam endpoint that streams call audio to your agent:

```
https://apps.sarvam.ai/api/app-runtime/channels/exotel
```

#### Set recording options

Configure the recording settings (recommended defaults):

| Setting                 | Value     |
| ----------------------- | --------- |
| **Record this?**        | Checked   |
| **Recording Channels?** | Single    |
| **Recording Format?**   | MP3       |
| **Encrypt DTMF?**       | Unchecked |

#### Save the App

Save and close the App editor.

#### Assign to your Exophone

Go to **My Numbers**, open the Exophone you want to use with Sarvam, and assign this App to it. Save the assignment.

***

## After connecting

Once both sides are configured:

#### Add your phone number

In Voice Agents, open your Exotel connection under **Deploy → Phone Numbers** and add the Exophone number. See [Manage Phone Numbers](/conversations/deploy/telephony/manage-numbers).

#### Route calls to an agent

For incoming calls, create an [Inbound deployment](/conversations/deploy/inbounds) to route the number to an agent. To dial out, add the number to a [Campaign](/conversations/deploy/campaigns).

#### Verify with a test call

Place a test call to the number and confirm your agent answers. See [Manage Phone Numbers](/conversations/deploy/telephony/manage-numbers) for the test-call steps.

**Outbound calling** uses this same connection — dial out by adding the number to a [Campaign](/conversations/deploy/campaigns). No separate credentials are required.

{/* TODO: Add Exotel-specific outbound setup steps here once confirmed. */}

## Next

#### [Manage Phone Numbers](/conversations/deploy/telephony/manage-numbers)

Add your number and route it to an agent.

#### [All providers](/conversations/deploy/telephony/bring-your-own)

See other providers.