VoIP BYOK (Twilio)

The BYOK (Bring Your Own Keys) model lets you use your own Twilio account with SellerCockpit. This gives you full control over your Twilio billing, phone numbers, and configuration.

When to Use BYOK

Choose BYOK if you:

• Already have a Twilio account you want to use
• Want direct control over Twilio billing
• Need specific Twilio features not available in Platform VoIP
• Prefer to manage your own phone number inventory
• Have enterprise requirements for account isolation

For most users, we recommend Platform VoIP for its simplicity.

Prerequisites

To use VoIP with BYOK, you need:

1. A Twilio account (sign up at twilio.com)
2. A Twilio phone number with Voice capabilities
3. API credentials (Account SID, API Keys)
4. A modern web browser with microphone access

Setup Guide

Step 1: Create Twilio Account

1. Sign up at twilio.com
2. Complete account verification
3. Add billing information (required for outbound calls)

Step 2: Get a Phone Number

1. In Twilio Console, go to Phone Numbers > Manage > Buy a number
2. Select your country and desired area code
3. Choose a number with Voice capabilities
4. Purchase the number

Step 3: Create TwiML App

1. Go to Voice > TwiML Apps in Twilio Console
2. Click Create new TwiML App
3. Name it “SellerCockpit”
4. Leave Voice URLs empty (SellerCockpit handles routing)
5. Save and note the TwiML App SID (starts with AP...)

Step 4: Generate API Keys

1. Go to Account > API keys & tokens
2. Click Create API key
3. Give it a friendly name (e.g., “SellerCockpit Production”)
4. Select Standard key type
5. Important: Save both the SID and Secret immediately - you won’t see the secret again!

Step 5: Enable the Add-on

1. In SellerCockpit, go to Settings > Add-ons
2. Find Twilio Calling (BYOK) in the list
3. Click Enable

Step 6: Configure Credentials

1. Go to Settings > Twilio
2. Enter your credentials:

Field	Where to Find
Account SID	Twilio Console dashboard (starts with AC...)
API Key SID	From Step 4 (starts with SK...)
API Key Secret	From Step 4
TwiML App SID	From Step 3 (starts with AP...)
Phone Number	Your Twilio number in E.164 format (e.g., +14155551234)

3. Select region: US1 (recommended)
4. Click Save Settings
5. Click Test Connection to verify

Region Selection

Important: Use US1 region for best compatibility.

Region	Location	Notes
US1	Virginia, USA	Recommended for all customers
IE1	Ireland	May cause TwiML fetch errors (Error 31000)

Even if you’re based in Europe, US1 is recommended as it has better TwiML app compatibility.

Phone Number Format

Your phone number must be in E.164 format:

• Correct: +14155551234
• Correct: +442071234567
• Incorrect: (415) 555-1234
• Incorrect: 415-555-1234

Troubleshooting

Error 31000: TwiML Fetch Failed

This is the most common error. Solutions:

1. Switch to US1 region in Settings > Twilio
2. Verify TwiML App SID is correct
3. Ensure no Voice URLs are configured in your TwiML app
4. Check Twilio account isn’t suspended

Call Won’t Connect

1. Verify all credentials are entered correctly
2. Check API Key SID starts with SK...
3. Ensure Account SID starts with AC...
4. Test connection button in settings
5. Check browser console for errors

”Twilio credentials incomplete” Error

One or more required fields are missing:

• Account SID
• API Key SID
• API Key Secret
• TwiML App SID
• Phone Number

Go to Settings > Twilio and fill in all fields.

Invalid API Key Secret

The secret may have been entered incorrectly. Since you can’t view it again in Twilio:

1. Go to Twilio Console > API Keys
2. Delete the existing key
3. Create a new API key
4. Immediately copy the new secret
5. Update in SellerCockpit

Costs

With BYOK, you pay Twilio directly:

Item	Approximate Cost
Phone number rental	~$1/month
Outbound calls	$0.01-0.02/minute (varies by destination)
Inbound calls	~$0.01/minute
Recording storage	Minimal (stored in your Supabase)

SellerCockpit does not charge additional fees for BYOK VoIP usage.

Security Best Practices

• Never share API credentials - Treat them like passwords
• Rotate API keys quarterly - Create new keys and update SellerCockpit
• Enable 2FA on Twilio - Protect your Twilio account
• Monitor usage - Check Twilio dashboard for unusual activity
• Use environment variables - If building integrations, never hardcode secrets

Using BYOK with Platform VoIP

You can only use one VoIP method at a time:

• If BYOK is enabled, Platform VoIP is disabled
• If Platform VoIP is enabled, BYOK is disabled

To switch, disable one add-on before enabling the other in Settings > Add-ons.

---

Need help? Contact support at support@sellercockpit.com