Exotel

View as Markdown

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

Connecting your Exotel account to Voice Agents, end to end.

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, then enter them on Sarvam.

1

Get your Account SID (on Exotel)

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

2

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.

3

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.

4

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

5

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.

1

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

2

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

3

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
4

Set recording options

Configure the recording settings (recommended defaults):

SettingValue
Record this?Checked
Recording Channels?Single
Recording Format?MP3
Encrypt DTMF?Unchecked
5

Save the App

Save and close the App editor.

6

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:

1

Add your phone number

In Voice Agents, open your Exotel connection under Deploy → Phone Numbers and add the Exophone number. See Manage Phone Numbers.

2

Route calls to an agent

For incoming calls, create an Inbound deployment to route the number to an agent. To dial out, add the number to a Campaign.

3

Verify with a test call

Place a test call to the number and confirm your agent answers. See Manage Phone Numbers for the test-call steps.

Outbound calling uses this same connection — dial out by adding the number to a Campaign. No separate credentials are required.

Next