Skip to main content
The dialer uses Twilio for voice calls. This guide walks you through connecting your Twilio account and getting your first phone number.

​
Prerequisites

​
Step 1: Get your Twilio credentials

1

Log in to Twilio

Go to console.twilio.com and sign in.
2

Find your credentials

On the Twilio Console dashboard, locate your Account SID and Auth Token. Click the eye icon to reveal the Auth Token.
3

Copy both values

You’ll need these in the next step.

​
Step 2: Connect Twilio to Consuelo

1

Open Consuelo settings

Go to Settings → Dialer in the Consuelo CRM.
2

Enter your credentials

Paste your Account SID and Auth Token into the corresponding fields.
3

Save

Click Save. Consuelo validates the credentials against the Twilio API.
If the credentials are valid, the dialer sidebar status indicator will update. If they’re invalid, you’ll see a “Phone system error” banner with the error message.

​
Step 3: Provision a phone number

1

Go to Phone Numbers

In Settings → Dialer → Phone Numbers, click Add Number.
2

Search by area code

Enter the area code you want (e.g. 512 for Austin, TX). The system searches Twilio’s available number inventory.
3

Select and provision

Choose a number from the results and click Provision. Twilio assigns the number to your account and Consuelo registers it as a caller ID.
4

Set as primary (optional)

Click Set as Primary to make this your default caller ID.

​
Step 4: Verify the connection

Open the dialer (Cmd+D / Ctrl+D). You should see:
  • No error banner in the sidebar
  • At least one number in the Call from dropdown
  • The Twilio config status shows as connected
If you see a banner, check the message:
BannerFix
”Connect your phone system”Go to Settings → Dialer and enter your Twilio credentials
”Pick a phone number”Credentials are valid but no numbers are provisioned — add one
”Phone system error”Credentials are invalid or expired — re-enter them

​
Twilio configuration modes

Consuelo supports two Twilio configuration modes:
ModeDescription
HostedConsuelo manages a Twilio sub-account for you. Simpler setup, Consuelo handles TwiML app configuration.
BYOK (Bring Your Own Key)You provide your own Twilio Account SID and Auth Token. Full control over your Twilio account.
The status indicator adapts its messages based on which mode you’re using.

​
Token refresh

The dialer uses Twilio voice tokens for browser-based calling. Tokens are:
  • Fetched from GET /v1/voice/token when the dialer initializes
  • Valid for 60 minutes
  • Auto-refreshed at 50 minutes (before expiry)
  • Refreshed on-demand when Twilio fires a tokenWillExpire event
You don’t need to do anything — token management is automatic.
If your network blocks WebRTC traffic or UDP ports, calls will fail even with valid Twilio credentials. Check with your IT team if you’re on a corporate network.

​
Next steps