Twilio is launching a new Console. Some screenshots on this page may show the Legacy Console and therefore may no longer be accurate. We are working to update all screenshots to reflect the new Console experience. Learn more about the new Console.
In this guide, we'll show you how to use Programmable Voice to make outbound phone calls from your Node.js applications. It's pretty easy - all you'll need is the Twilio module for Node.js, a voice-capable Twilio phone number, your account credentials, and five minutes to have a boatload of fun at your keyboard. Let's get started!
(warning)
Warning
If you are sending SMS messages to the U.S. or Canada, before proceeding further please be aware of updated restrictions on the use of Toll-Free numbers for messaging, including TF numbers obtained by purchasing them. These restrictions do not apply to Voice or other uses outside of SMS messaging. Please click here for details.
In the Twilio console, search for and purchase an available phone number capable of making outbound calls. You'll use this phone number as the "From" phone number when you initiate an outbound call.
There are a few key parameters to drill into when making the outbound call.
"From" - the voice-enabled Twilio phone number you added to your account earlier
"To" - the person you'd like to call
"Twiml" - Instructions in the form
TwiML
that explains what should happen when the other party picks up the phone
"Url" - Optionally, instead of passing the
Twiml
parameter, you can provide a Url that returns
TwiML
Voice instructions.
What is TwiML?
TwiML is the Twilio Markup Language, which is just to say that it's an XML document with special tags defined by Twilio to help you build your SMS and voice applications. TwiML is easier shown than explained. Here's some TwiML you might use to respond to an incoming phone call:
_10
<?xml version="1.0" encoding="UTF-8"?>
_10
<Response>
_10
<Say>Thanks for calling!</Say>
_10
</Response>
And here's some TwiML you might use to respond to an incoming SMS message:
_10
<?xml version="1.0" encoding="UTF-8"?>
_10
<Response>
_10
<Message>We got your message, thank you!</Message>
_10
</Response>
Every TwiML document will have the root <Response> element and within that can contain one or more verbs. Verbs are actions you'd like Twilio to take, such as <Say> a greeting to a caller, or send an SMS <Message> in reply to an incoming message. For a full reference on everything you can do with TwiML, refer to our TwiML API Reference.
Make an outbound call with hosted TwiML
This uses the Url parameter
Node.js
_14
// Download the helper library from https://www.twilio.com/docs/node/install
_14
// Find your Account SID and Auth Token at twilio.com/console
_14
// and set the environment variables. See http://twil.io/secure
Great work! In a few lines of code, you've placed an outbound phone call from your Node.js code. If you're using Programmable Voice with Node.js, you might enjoy these other guides as well.