This is the full example of the Outbound Call Quickstart.
Prerequisites
- Node.js 20 or higher
- A Twilio account with:
- Account SID
- Auth Token
- Phone Number
- An Ultravox API key
Set-up and Installation
1
Get the Source Code
Copy all the code locally from the
twilio-outbound-quickstart-js
example.2
Install the Required Dependencies
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
Configuring Variables
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:User speaks first
Start the Call
Once you’ve configured and saved everything, start the call:Next Steps
- Check out the Inbound Phone Call example.
- Ultravox Realtime provides telephony integrations for Telnyx, Twilio, Plivo, and Exotel. Learn more here.