Exotel

Key	Description
`api_key`	Exotel API key
`api_secret`	Exotel API secret
`account_sid`	Exotel Account SID

Key

Description

api_key

Exotel API key

api_secret

Exotel API secret

account_sid

Exotel Account SID

Setup

Set PUBLIC_ASSISTANT_HOST

PUBLIC_ASSISTANT_HOST is the public HTTPS hostname Exotel will use to reach your server — for webhooks and the WebSocket media stream.

Production
Local Development (ngrok)

Set it in docker/assistant-api/.assistant.env:

PUBLIC_ASSISTANT_HOST=your-server.com   # no https:// prefix

Also update connection.media in ui/src/configs/config.production.json:

{
  "connection": {
    "media": "https://your-server.com"
  }
}

Exotel’s servers originate from India/SEA and cannot reach localhost. Use ngrok to create a public HTTPS tunnel:1. Install and authenticate ngrok

# macOS
brew install ngrok/ngrok/ngrok

# Linux
curl -sSL https://ngrok-agent.s3.amazonaws.com/ngrok.asc \
  | sudo tee /etc/apt/trusted.gpg.d/ngrok.asc >/dev/null
echo "deb https://ngrok-agent.s3.amazonaws.com buster main" \
  | sudo tee /etc/apt/sources.list.d/ngrok.list
sudo apt update && sudo apt install ngrok

ngrok config add-authtoken <your-authtoken>

Get your authtoken at dashboard.ngrok.com.2. Start the tunnel (keep this running)

ngrok http 8080
# Forwarding  https://abc123.ngrok-free.app -> http://localhost:8080

3. Update two files with the ngrok hostname

File	Field	Value
`docker/assistant-api/.assistant.env`	`PUBLIC_ASSISTANT_HOST`	`abc123.ngrok-free.app` (no `https://`)
`ui/src/configs/config.development.json`	`connection.media`	`https://abc123.ngrok-free.app` (with `https://`)

# docker/assistant-api/.assistant.env
PUBLIC_ASSISTANT_HOST=abc123.ngrok-free.app

// ui/src/configs/config.development.json
{
  "connection": {
    "media": "https://abc123.ngrok-free.app"
  }
}

4. Rebuild

make rebuild-assistant

Exotel may have higher latency to ngrok tunnels depending on region. For best results during testing, use an ngrok region closest to Exotel’s traffic origin (India): ngrok http 8080 --region=in (if available on your plan).

Configure the ExoPhone app

In 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}?x-api-key={apiKey}

Replace {assistantId} with the numeric assistant ID from the Rapida dashboard.

Attach vault credential to the assistant

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

Verify

curl https://{PUBLIC_ASSISTANT_HOST}/readiness/
# Expected: {"status":"ok"}

Property	Value
Encoding	μ-law (PCMU) 8-bit
Sample rate	8000 Hz
Channels	Mono

Property

Value

Encoding

μ-law (PCMU) 8-bit

Sample rate

8000 Hz

Channels

Mono

Getting Started

Dashboard (UI)

Web API

Assistant API

Integration API

Endpoint API

Document API

Vault Credentials

Setup

What Rapida Returns

Audio Spec

Twilio

Vonage

Telephony Overview

Configuration

​Vault Credentials

​Setup

​What Rapida Returns

​Audio Spec

Twilio

Vonage

Telephony Overview

Configuration

Vault Credentials

Setup

What Rapida Returns

Audio Spec