The Exotel page is where you connect the platform to your Exotel account and manage the Exotel phone numbers (DIDs) that route inbound calls to your bots. Exotel is a built-in integration, separate from generic SIP carriers — so it has its own page rather than appearing in the carrier list. Open it from Dashboard → Carriers, then select the Exotel integration card, or go directly to /dashboard/carriers/exotel. The page has two parts:

Credentials

Your Exotel account details. These must be saved before you can add numbers.

Phone numbers

The Exotel DIDs you manage, each with an assigned bot and its WebSocket and Flow URLs.
You must save valid credentials first. Until you do, the Add Number button stays disabled and the phone-numbers section tells you to configure credentials first.

​
Top-bar buttons

These buttons sit at the top of the page.
ButtonWhat happens when you click
Back to CarriersReturns you to the Carriers page without saving.
EditSwitches the credentials section into edit mode, replacing the read-only values with input fields for Account SID, API Base URL, API Key, and API Token. Hidden once you are already editing.
CancelExits edit mode without saving any credential changes. Only shown while you are editing the credentials.
SaveSaves the credential changes. While saving, the button is disabled and reads “Saving…”. On success you return to view mode and see a confirmation message; on failure an error message appears. Only shown while you are editing the credentials.
Add NumberOpens the Add / Edit number dialog to add a new Exotel phone number. Disabled until credentials are configured.

​
Configuration status

A badge at the top of the page tells you whether your Exotel account is connected.
BadgeMeaning
Configured (green)Valid credentials have been saved. You can add and manage phone numbers.
Not configured (grey)No credentials saved yet. The Add Number button is disabled until you save credentials.

​
Credentials

The credentials section holds the details the platform uses to talk to your Exotel account. In view mode the values are read-only — click Edit to change them.
FieldWhat to enterRequired
Account SIDYour Exotel account identifier. Shown read-only, or — when empty. In edit mode, a text field with the placeholder “Exotel Account SID”.No
API Base URLThe base URL of the Exotel API. Defaults to https://api.exotel.com if left blank. In edit mode, a URL field with the same value as its placeholder.No
API KeyThe Exotel API key used to authenticate. In view mode it shows •••••••• when credentials are saved, or — when none are set. In edit mode the placeholder reads “Unchanged” if a key is already saved, so you can leave it blank to keep the existing one.No
API TokenThe Exotel API token — the secret half of the credentials. In view mode it shows •••••••• when credentials are saved, or — when none are set. In edit mode it is a masked password field; the placeholder reads “Unchanged” if a token is already saved, so leaving it blank keeps the existing one.No
For security, the API Key and API Token are never shown in full and are not pre-filled when you edit. If you only need to change the Account SID or Base URL, leave the key and token blank — the saved values stay in place. Type into a field only when you want to replace that value.

​
Edit the credentials

1

Click Edit

Click Edit in the top bar. The four credential fields become editable.
2

Enter your details

Fill in the Account SID and API Base URL. Enter a new API Key and API Token only if you are setting them for the first time or rotating them — otherwise leave them blank to keep the saved values.
3

Save

Click Save. The button shows “Saving…” while it works. On success the section returns to view mode, the status badge updates, and a confirmation appears. To discard your changes instead, click Cancel.

​
Phone numbers (DIDs)

The phone-numbers section lists every Exotel DID you manage. Each row shows the number, its label, the bot that answers it, and the two URLs Exotel needs to route calls.

​
Columns

ColumnWhat it shows
NumberThe Exotel phone number, in monospace.
LabelThe optional descriptive name you gave the number, or blank.
BotThe bot assigned to answer inbound calls, or — if none is assigned.
WebSocket URLThe connection URL Exotel uses to stream the call to the bot. Shown with a Copy button. If no bot is assigned, it reads “Assign a bot first” instead.
Flow URLThe Exotel Flow URL for this number. Shown with a Copy button. If none is set, it reads “Required for Exotel test call”.
ActionsThe Edit and Remove buttons for the row (see below).

​
Empty states

WhenWhat you see
Credentials saved, no numbers yet”No phone numbers configured. Add a number to get started.”
No credentials saved”Configure credentials first, then add phone numbers.”

​
Row buttons

ButtonWhat happens when you click
Copy (WebSocket URL)Copies the number’s WebSocket URL to your clipboard and shows a “URL copied” message. Only present once a bot is assigned.
Copy (Flow URL)Copies the number’s Exotel Flow URL to your clipboard and shows a “URL copied” message. Only present once a Flow URL is set.
EditOpens the Add / Edit number dialog with this number’s details pre-filled. An icon-only (pencil) button.
RemovePermanently removes this number from the integration and shows a success or error message. An icon-only (trash) button.
Remove deletes the number immediately, with no confirmation step. Make sure you are removing the right row before clicking it.

​
Add / Edit number dialog

This dialog opens when you click Add Number in the top bar, or Edit on a row. Its title reads Add Number when you are adding and Edit Number when you are editing.

​
Fields

FieldWhat to enterRequired
Phone NumberThe Exotel phone number, for example +919876543210. Required when adding a new number. When editing an existing number this field is disabled (read-only) — you cannot change a number after it is created.Yes (when adding)
LabelAn optional descriptive name for the number, for example “Sales Line”.No
Assign BotA dropdown of your available bots, plus a None option. Pick the bot that should answer inbound calls on this number. The bot you choose is what populates the row’s WebSocket URL.No
Exotel Flow URLThe Exotel Flow URL for this number, for example https://my.exotel.com/{sid}/exoml/start_voice/{flow_id}. Used to route inbound calls inside Exotel and to place test calls from the Exotel side.No

​
Buttons

ButtonWhat happens when you click
CancelCloses the dialog without saving. Disabled while a save is in progress.
Add NumberSaves the new number and closes the dialog, then refreshes the list. Disabled while saving and while the Phone Number field is empty. Shown only when adding.
Save ChangesSaves your edits to an existing number and closes the dialog, then refreshes the list. Disabled while saving. Shown only when editing. On error, an error message appears and the dialog stays open.
Assign a bot and set the Flow URL before going live. The WebSocket URL only appears once a bot is assigned, and the Flow URL is what lets you place a test call from within Exotel — the platform flags it as “Required for Exotel test call” until you add one.

​
Setting up a number end to end

1

Save your credentials

Enter and Save your Exotel Account SID, Base URL, API Key, and API Token. The status badge should read Configured.
2

Add the number

Click Add Number, enter the Exotel phone number, give it a label, choose the bot that should answer it, and add the Exotel Flow URL. Click Add Number to save.
3

Copy the URLs into Exotel

Use the Copy buttons on the new row to copy the WebSocket URL and the Flow URL, then paste them into the matching configuration in your Exotel account so inbound calls reach the bot.
4

Place a test call

With the Flow URL in place, run a test call from Exotel to confirm the number connects to the bot.