Skip to contentSkip to navigationSkip to topbar
Rate this page:
On this page

Make Outgoing Call Widget


Studio uses Widgets to represent various parts of Twilio's functionality that can then be stitched together in your Studio Flow to build out robust applications that require no coding on your part.

(information)

Info

New to Twilio Studio? Check out our Getting Started Guide!

The Make Outgoing Call Widget allows you to dial the phone number of the contact who reaches your Studio Flow. You can use this Widget to reach your contact with an automated call or follow up by adding voice messages.

A rectangular widget titled 'call_user' with '(Make Outgoing Call Widget v2)' underneath. The contact's phone number is listed as the variable {{contact.channel.address}} and attached handlers include Answered, Busy, No Answer, and Call Failed.

Please note that the Make Outgoing Call Widget uses the Twilio Voice Calls API to make calls.

(warning)

Warning

The Make Outgoing Call widget has been upgraded and now supports enhanced call recording options and Answering Machine Detection. Any existing Flows using v1 will continue to work as before and show the old functionality of the widget. But for any new instances of the widget added to a Flow, only v2 of the widget will be available. For Flows that still rely on v1, refer to Make Outgoing Call v1 documentation.


Required configuration for Make Outgoing Call

required-configuration-for-make-outgoing-call page anchor

The Make Outgoing Call Widget requires two pieces of information, Number to call and Number to make call from, to function properly.

Both of these required values are determined at runtime of your Studio Flow execution, and are set to the phone number that called or messaged your Studio Flow and the phone number connected to your Flow, respectively. Studio determines these numbers by the values provided in the REST API request to create the Execution and cannot be changed in the widget configuration.

NameDescriptionDefault
Number to callThe phone number of the contact whose call or message reached your Studio Flow{{contact.channel.address}}
Number to make call fromThe phone number Studio will use as your caller ID when placing the call to your user. This is always the Twilio phone number connected to your Studio Flow{{flow.channel.address}}

Optional configuration for Make Outgoing Call

optional-configuration-for-make-outgoing-call page anchor

The Make Outgoing Call Widget also accepts a number of configuration options that you can use to customize the call that your Studio Flow makes to the user. These options allow you to record the call, detect an answering machine on the other end of the call, send digits, set a timeout on the call, and configure this Widget for SIP calls.

Optional configuration: record the phone call

optional-configuration-record-the-phone-call page anchor

If Record Call is set to On, you can also specify the number of recording channels, a recording status callback URL, and to trim silence on the call:

NameDescriptionOptionsDefault
Record callRecord the phone call and save as an mp3On, OffOff
Recording channelsSpecify whether Twilio should record the audio from the call in one channel (mono), or record each party on the call into a separate channel (dual)Mono Channel, Dual ChannelMono Channel
Recording status callback URLThe URL Twilio will call when the recording is ready to be accessedAny valid URLNone
Trim silenceTrim any silence at the beginning and end of the call from the recordingOn (trim silence), Off (do not trim)Off

Optional configuration: answering machine detection

optional-configuration-answering-machine-detection page anchor

If you choose to enable Detect answering machine, Studio will detect if a human, answering machine, or fax machine has picked up the call. If you enable this feature, many other configuration options will become available to you.

NameDescriptionPossible ValuesDefault
Detect answering machineDetect if a human, answering machine, or fax machine answers the phone call.On, OffOff
Machine detectionThe mode in which answering machine detection should run. See note below for details on how these detection methods work.Detect machine start, Detect machine endDetect machine start
Machine detection timeoutThe number of seconds that Twilio should attempt to perform answering machine detection before timing out and returning the AnsweredBy studio variable set to unknown.3 - 120 (seconds)30 (seconds)
Machine detection speech thresholdThe number of miliseconds Twilio should use as the measuring stick for the length of the speech activity. Durations lower than this value will be interpreted as a human, while durations longer than this value will be interpreted as a machine.1000 - 6000 (milliseconds)2400 (milliseconds)
Machine detection speech end thresholdThe number of milliseconds of silence after speech activity at which point the speech activity is considered complete.500 - 5000 (milliseconds)1200 (milliseconds)
Machine detection speech timeoutThe number of milliseconds of initial silence after which an AnsweredBy result of unknown will be returned.2000 - 10000 (mlliseconds)5000 (milliseconds)

Please note that each of these configuration settings are only available to you if you set Detect answeing machine to On.

Machine detection modes

machine-detection-modes page anchor

You can select which mode of answering machine detection you'd like Twilio to use when it makes this call and checks for a machine on the other end:

  • Detect Machine Start will return a result as soon as the called party is identified. The AnsweredBy Studio variable will be one of the following: machine_start , human , fax , or unknown .
  • Detect Machine End will return whether the call is answered by a human or fax immediately, but when an answering machine is detected it will return this information only at the end of the greeting (usually indicated by a beep). With this mode, the AnsweredBy studio variable will be one of the following: machine_end_beep , machine_end_silence , machine_end_other , human , fax , or unknown .

To specify what happens in your flow based on the values returned from Twilio's answering machine detection, you can use a Split Based On... Widget next in your Studio Flow.

(information)

Info

To learn more about the various modes of Twilio's answering machine detection, and to understand how it works behind the scenes, see the Programmable Voice - Answering Machine Detection REST API docs.

Optional configuration: Send digits, timeout, and SIP settings

optional-configuration-send-digits-timeout-and-sip-settings page anchor

Beyond call recording and answering machine detection, there are a few more optional configurations you can set to customize your outgoing phone call:

NameDescriptionPossible valuesDefault
Send digitsA string of keys Twilio should dial after connecting to the contact's phone number. For example, if you connected to a company phone number and wanted to pause for one second, and then dial extension 1234 followed by the pound key, the value of this parameter should be ww1234#.Any digit (0-9), #, *, and w (which inserts a half-second pause). This field accepts a maximum of 32 digits.None
TimeoutThe number of seconds Twilio will wait for the phone to ring before assuming there is no answer.0 - 600 (seconds)60 (seconds)
SIP usernameThe username used to authenticate the caller making a SIP call.A valid username that authenticates you to make a SIP callNone
SIP passwordThe password required to authenticate the user account specified in SIP username.The password tied to your SIP authentication usernameNone

Make Outgoing Call transitions

make-outgoing-call-transitions page anchor

These events trigger transitions from this Widget to another Widget in your Flow. For more information on working with Studio transitions, see this guide.

NameDescription
AnsweredThe call was answered. If Detect Answering Machine is On and the call was answered, the AnsweredBy parameter will be available in your Studio Flow context as the variable {{widgets.WIDGET_NAME.AnsweredBy}}. You can inspect your AnsweredBy value in a Split Based On... Widget to branch your Flow after this call is answered.
BusyThe line Twilio dialed was busy.
No answerThe call was not answered.
Call failedThe call failed to initiate.

Make Outgoing Call variables

make-outgoing-call-variables page anchor

When the Make Outgoing Call Widget executes, it will have stored the following variables for use throughout your Studio Flow (where MY_WIDGET_NAME is the name of your actual widget). For more information on working with variables in Studio, see this guide.

Find definitions and examples for these variables at the Call Resource page.

(information)

Info

If Detect Answering Machine is On and the call was answered, the Answered By value is set to values listed in machine detection modes.

NameLiquid Template Language
Account SID{{widgets.MY_WIDGET_NAME.AccountSid}}
Answered By{{widgets.MY_WIDGET_NAME.AnsweredBy}}
Call SID{{widgets.MY_WIDGET_NAME.CallSid}}
Call Status{{widgets.MY_WIDGET_NAME.CallStatus}}
Call Duration{{widgets.MY_WIDGET_NAME.CallDuration}}
From{{widgets.MY_WIDGET_NAME.From}}
Machine Detection Duration{{widgets.MY_WIDGET_NAME.MachineDetectionDuration}}
To{{widgets.MY_WIDGET_NAME.To}}

Example: Who Answered?

example-who-answered page anchor

This example shows how to branch your Studio Flow depending on who answered the call initiated by the Make Outgoing Call Widget. This is useful when you want to perform different actions depending on if a human or machine answered.

Twilio Studio Make Outgoing Call Widget Example.

Now that you know the basics of the Make Outgoing Call Widget, why not learn more about calls in a Studio Flow? You can follow along with any of the following tutorials and resources:

We can't wait to see what you build!


Rate this page: