Exotel Integration

Exotel is a built-in, non-SIP integration handled on its own page at /dashboard/carriers/exotel, reached from the Integrations card on the carrier list.

Data

The page loads GET /api/v1/integrations/exotel and the bot list in parallel. The integration object reports credentials_configured, account_sid, api_base_url, status, and a dids array. The header badge reads Configured or Not configured.

Credentials

The Credentials section has view and edit modes. Edit collects:

Field	Notes
Account SID	Exotel account SID
API Base URL	defaults to `https://api.exotel.com`
API Key	masked once configured; placeholder shows “Unchanged”
API Token	password field; masked once configured

Save PUTs only the changed fields to /api/v1/integrations/exotel. When already configured, API Key and API Token display as a •••••••• mask and are only sent when re-entered.

Phone numbers

The Phone Numbers table shows Number, Label, Bot, WebSocket URL, and Flow URL, with edit/remove per row. Adding a number requires credentials to be configured first.

Add: POST /api/v1/integrations/exotel/dids
Edit: PUT /api/v1/integrations/exotel/dids/{did_id}
Remove: DELETE /api/v1/integrations/exotel/dids/{did_id}

The WebSocket URL is only generated once a bot is assigned (otherwise the cell reads “Assign a bot first”). The Flow URL is required for an Exotel test call (otherwise “Required for Exotel test call”). Both URLs have click-to-copy buttons.

Field	Notes
Phone Number	e.g. `+919876543210`; disabled when editing
Label	optional, e.g. “Sales Line”
Assign Bot	drives WebSocket URL generation
Exotel Flow URL	e.g. `https://my.exotel.com/{sid}/exoml/start_voice/{flow_id}`

Exotel routes calls through Voicebot Applets rather than a direct SIP trunk. The WebSocket URL is what you point the Exotel Voicebot applet at; the Flow URL is used to trigger Exotel test calls.

Carriers

SIP carriers and DIDs.