Skip to main content
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

1

Get the Source Code

Copy all the code locally from the twilio-outbound-quickstart-js example.
2

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 Console
  • TWILIO_AUTH_TOKEN: Your Twilio Auth Token
  • TWILIO_PHONE_NUMBER: The Twilio phone number to make calls from
  • DESTINATION_PHONE_NUMBER: The recipient’s phone number
  • ULTRAVOX_API_KEY: Your Ultravox API key
  • SYSTEM_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:
or

Next Steps

  1. Check out the Inbound Phone Call example.
  2. Ultravox Realtime provides telephony integrations for Telnyx, Twilio, Plivo, and Exotel. Learn more here.