BYOP Setup

Bring Your Own Phone numbers from Twilio, Exotel, Plivo, Vobiz or a SIP trunk.

Supported Providers#

Setup Process#

Step 1: Get Provider Credentials#

Twilio#

1. Go to Twilio Console
2. Copy:
   • Account SID
   • Auth Token
   • Phone Number SID

Exotel#

1. Go to Exotel Dashboard
2. Copy:
   • API Key
   • API Token
   • Virtual Number

Plivo#

1. Go to Plivo Console
2. Copy:
   • Auth ID
   • Auth Token
   • Phone Number

Step 2: Add to Platform#

1. Go to Settings > Telephony
2. Click Add Provider
3. Select your provider
4. Enter credentials
5. Test connection

Step 3: Configure Webhook#

Set up webhook URL in your provider:

{{API_BASE_URL}}/api/webhook/{provider}/{workspace_id}

Need your workspace ID? See Finding Your Workspace ID for step-by-step instructions.

Twilio Webhook#

In Twilio Console:

1. Go to Phone Numbers
2. Select your number
3. Set Voice URL to the webhook

Exotel Webhook#

In Exotel Dashboard:

1. Go to App Bazaar
2. Create/edit app
3. Set callback URL

Step 4: Assign Agent#

1. Go to Phone Numbers
2. Your BYOP number should appear
3. Click Assign Agent

Configuration Options#

Per-Number Settings#

{
  "provider": "twilio",
  "phoneNumber": "+919876543210",
  "agentId": "agent_abc123",
  "settings": {
    "recordCalls": true,
    "transcribe": true,
    "maxDuration": 600
  }
}

Fallback Configuration#

{
  "fallback": {
    "onAgentUnavailable": "voicemail",
    "voicemailGreeting": "Please leave a message...",
    "forwardTo": "+919876543211"
  }
}

Troubleshooting#