Connect your Twilio account to enable voice calling features for your AI agents.

​
What You Can Do

  • Enable inbound and outbound voice calls
  • Connect phone numbers to agents
  • Configure voice settings

​
Prerequisites

  • A Twilio account (sign up here)
  • Twilio Account SID and Auth Token
  • At least one Twilio phone number

​
Why Connect Twilio?

Twilio integration enables:
  • Inbound calls: Customers can call your AI agent
  • Outbound calls: Agents can initiate calls
  • Voice conversations: Real-time voice AI interactions
  • Call recording: Record conversations for quality assurance

​
Step-by-Step: Connect Twilio

1

Get Twilio Credentials

  1. Log in to your Twilio Console
  2. Find your Account SID and Auth Token on the dashboard
  3. Copy these values
2

Navigate to Connect Twilio

Go to Settings → Connect Twilio in the sidebar.
3

Enter Credentials

  • Paste your Account SID
  • Paste your Auth Token
4

Connect

Click Connect to link your Twilio account.
5

Verify Connection

You should see a success message and your available phone numbers.
screenshot: twilio connection form

​
Step-by-Step: Assign a Phone Number to an Agent

1

Go to Agent Settings

Navigate to your agent’s Channels tab.
2

Select Phone Channel

Click on the Phone channel option.
3

Choose Phone Number

Select a phone number from your connected Twilio numbers.
4

Configure Settings

Set up voice settings:
  • Voice provider (Google, AWS Polly, ElevenLabs)
  • Language
  • Voice style
5

Save

Click Save to activate the phone channel.

​
Configuration Options

SettingDescription
Account SIDYour Twilio account identifier
Auth TokenSecret key for API authentication
Phone NumbersAvailable numbers from your Twilio account

​
Voice Settings

Once connected, configure voice options for each agent:
SettingOptions
Voice ProviderGoogle TTS, AWS Polly, ElevenLabs, Microsoft Speech
LanguageEnglish, Spanish, French, German, etc.
Voice StyleMale, Female, various accents
Speech SpeedSlow, Normal, Fast

​
Best Practices

Create a separate Twilio account for Boty to keep billing and usage clear.
Begin with a local phone number before adding toll-free numbers.
Use the Playground to test voice interactions before publishing.
Keep an eye on Twilio costs, especially for voice minutes.

​
Troubleshooting

  • Verify Account SID and Auth Token are correct
  • Ensure your Twilio account is active
  • Check that your Twilio account has available balance
  • Purchase a phone number in your Twilio console
  • Ensure the number has voice capabilities enabled
  • Refresh the page after purchasing
  • Verify the phone number is assigned to an agent
  • Check that the agent is published
  • Ensure voice settings are configured
  • Test in the Playground first
  • Check your internet connection
  • Try a different voice provider
  • Adjust speech speed settings

​
Twilio Costs

Twilio charges separately for phone numbers and call minutes. These costs are in addition to your Boty subscription.
Typical Twilio costs:
  • Phone number: ~$1/month
  • Inbound calls: ~$0.0085/minute
  • Outbound calls: ~$0.014/minute
Check Twilio Pricing for current rates.