Make Outgoing Call
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.
Description:
Make Outgoing Call allows you to dial the Contact's phone number within your Flow. Use this Widget to reach the Contact with an automated call, and follow up by adding voice messages, asking for input via Gather. It can connect the Contact to an agent by dialing and merging with current call.
Make Outgoing Call uses the Twilio Voice Calls API.
Required Configuration:
The required fields for this Widget are To and From. These are determined at runtime by the values provided in the REST API request to create the Execution and cannot be changed in the widget configuration.
Name |
Description |
Default |
Number To Call |
The Contact's phone number |
Flow Default |
Number to Make Call From |
The phone number to use as the Caller ID |
Flow Default |
Optional Configuration:
Name |
Description |
Default |
Record Call |
Record the call and save as an mp3. Values: If set to On, Recording Channels and Recording Status Callback URL fields can be set. |
Off |
Recording Channels |
The number of channels in the output recording. Mono Channel - Records all audio of the call in one channel. |
Mono Channel |
Recording Status Callback URL |
The URL that will be called when the recording is available to be accessed. |
None |
Trim Silence |
Trim the leading and trailing silence from the call recording. Values: |
On |
Detect Answering Machine |
Detect if a human, answering machine, or fax has picked up the call Values: If set to On, other machine detection settings can be configured. |
Off |
Machine Detection |
The mode of Answering Machine Detection to run. Values: Detect Machine Start - 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, unknown
machine_end_beep, machine_end_silence, machine_end_other, human, fax, unknown Use Split widget to specify conditions based on values above. Liquid Variable Input See the Programmable Voice - Answering Machine Detection REST API docs for more information. |
Detect Machine Start |
Machine Detection Timeout (s) |
The number of seconds that Twilio should attempt to perform Answering Machine Detection before timing out and returning the 'AnsweredBy' studio variable as unknown. (Only applicable if 'Detect Answering Machine' is set to 'On'.) Possible values in seconds: |
30s |
Machine Detection Speech Threshold (ms) |
The number of milliseconds that is used as the measuring stick for the length of the speech activity, where durations lower than this value will be interpreted as a human and longer than this value as a machine. (Only applicable if 'Detect Answering Machine' is set to 'On'.) Possible values in milliseconds: |
2400ms |
Machine Detection Speech End Threshold (ms) |
The number of milliseconds of silence after speech activity at which point the speech activity is considered complete. (Only applicable if 'Detect Answering Machine' is set to 'On'.) Possible values in milliseconds: |
1200ms |
Machine Detection Silence Timeout (ms) |
The number of milliseconds of initial silence after which an ‘unknown’ AnsweredBy result will be returned. (Only applicable if 'Detect Answering Machine' is set to 'On'.) Possible values in milliseconds: |
5000ms |
Send Digits |
A string of keys to dial after connecting to the number, maximum of 32 digits. Valid digits in the string include: any digit (0-9), '#', '*' and 'w', to insert a half second pause. 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 would be ww1234#. |
None |
Timeout |
The number of seconds the phone is allowed to ring before assuming there is no answer. Possible values in seconds: |
60s |
SIP Username |
The username used to authenticate the caller making a SIP call. |
None |
SIP Password |
The password required to authenticate the user account specified in sip_auth_username. |
None |
Transitions:
These are the events that trigger transitions from this widget:
Name |
Key |
Description |
Answered |
answered |
Fired when a call is answered. If 'Detect Answering Machine' is 'On', the following additional parameter will be available in the Studio context as a variable:
Examples: {{widgets.call_1.AnsweredBy}}
|
Busy |
busy |
Fired when the call is busy |
No Answer |
noAnswer |
Fired when the call is unanswered |
Call Failed |
failed |
Fired when the call fails to initiate |
Need some help?
We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.