Skip to main content
Exotel is a cloud telephony provider operating in India and South-East Asia. It follows the same webhook → WebSocket pattern as Twilio: Exotel calls your server when a call arrives, Rapida responds with passthru XML that opens a WebSocket media stream.

​
Vault Credentials

In the Rapida dashboard go to Credentials → Create Credential, select provider type Exotel:
KeyDescription
api_keyExotel API key
api_secretExotel API secret
account_sidExotel Account SID

​
Setup

1

Set the required env var

# docker/assistant-api/.assistant.env
PUBLIC_ASSISTANT_HOST=your-hostname.com   # Must be publicly reachable HTTPS
For local development, replace with your ngrok domain — see the ngrok guide.
2

Configure the ExoPhone app

In the Exotel Dashboard → ExoPhones, select your ExoPhone and assign it an App. Set the passthru URL to:
https://{PUBLIC_ASSISTANT_HOST}/v1/talk/exotel/call/{assistantId}
Replace {assistantId} with the numeric assistant ID from the Rapida dashboard.
3

Attach vault credential to the assistant

In the assistant’s Phone Deployment, select the Exotel vault credential.
4

Test inbound call

Call your Exotel number. Rapida responds with Exotel passthru XML that connects a WebSocket stream at:
wss://{PUBLIC_ASSISTANT_HOST}/v1/talk/exotel/ctx/{contextId}
Exotel’s servers originate calls from India and SEA regions. Ensure PUBLIC_ASSISTANT_HOST is reachable from those regions. Avoid using localhost or VPN-only addresses.

​
Audio Spec

PropertyValue
Encodingμ-law (PCMU) 8-bit
Sample rate8000 Hz
ChannelsMono

ngrok — Local Testing

Expose localhost to Exotel for development

Twilio

Alternative global PSTN provider

Telephony Overview

All providers and URL routing reference

Configuration

PUBLIC_ASSISTANT_HOST and other env vars