Outbound Phone Calls
Connect outbound Twilio calls to an Ultravox agent in 5 minutes or less.
This is the full example of the Outbound Call Quickstart.
This guide will help you set up and make your first automated call using Ultravox and Twilio.
Prerequisites
- Node.js 20 or higher
- A Twilio account with:
- Account SID
- Auth Token
- Phone Number
- An Ultravox API key
Set-up and Installation
Get the Source Code
Copy all the code locally from the twilio-outbound-quickstart-js
example.
Install the Required Dependencies
or
Making Your First Outbound Call
The AI assistant will introduce itself as Steve and have a conversation with the recipient. To make a call you need to update the variables for keys and phone numbers. You may also update the system prompt.
Update Configuration
TWILIO_ACCOUNT_SID
: Your Twilio Account SID from the Twilio ConsoleTWILIO_AUTH_TOKEN
: Your Twilio Auth TokenTWILIO_PHONE_NUMBER
: The Twilio phone number to make calls fromDESTINATION_PHONE_NUMBER
: The recipient’s phone numberULTRAVOX_API_KEY
: Your Ultravox API keySYSTEM_PROMPT
: Instructions for the AI agent’s behavior
User Speaks First
By default, Ultravox Realtime defaults to having the agent speak first. This is exactly what you want for an inbound call you want the agent to answer. However, this is not what is wanted for outbound calls where someone can be expected to answer the call with something like “Hello”.
When creating the call in Ultravox, you need to address this by setting the first speaker to user:
Start the Call
Once you’ve configured and saved everything, start the call:
or
Next Steps
- Check out the Inbound Phone Call example.
- Ultravox Realtime provides telephony integrations for Telnyx, Twilio, Plivo, and Exotel. Learn more here.