メニュー

Connect Call To 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. You can learn more about Widgets and building Studio Flows in the Studio Getting Started Guide.

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

The Connect Call To Widget allows you to bridge an in-progress call with another party. You can specify one of the following ways to connect to the other party:

Use this Widget as part of an Interactive Voice Response (IVR) menu, to connect your customer with a different department, or if they’re looking to reach a specific operator.

You are not able to use parallel calling including both calls to a SIP Domain alongside calls to a phone number, Client user, or SIM.

Connect Call To Widget

Required Configuration for Connect Call To Widget

The required fields for this Widget are Connect Call To and Caller ID, which can be variables or hard-coded entries. Select the Connect Call To type from the dropdown in the Inspector Panel, then set the field value to the number(s)/address of your intended recipient(s).

名前 概要 初期値
Connect Call To The phone number(s), Twilio Voice JavaScript SDK identity, SIM SID, SIP endpoint, or Conference SID to call. See Connect Call To configuration examples below. 該当なし
callerId The phone number to use as the Caller ID when connecting the call. +13125555566 {{contact.channel.address}}

Connect Call To configuration examples

You have several options when connecting a call to another party.

名前 概要
Single Number Specify a single phone number (in E.164 format) to dial and connect the caller to. +14157234000
Multiple Numbers (Simulring) Specify up to 10 numbers (in E.164 format) to potentially connect the call to. Each number will be dialed simultaneously. The first person to answer the call will be connected to the caller, and all other simultaneous calls will be dropped automatically. To specify multiple numbers, separate each number with commas. +14157234000, +14155551212, +14158675310
Client User Use this to connect to a Twilio Voice JavaScript SDK client. Specify the client identifier. Alice
SIM Connect to a Programmable Wireless SIM. Specify the SID of the SIM resource. DE8caa2afb9d5279926619c458dc7098a8
SIP Endpoint (non-Twilio SIP) Specify the SIP Endpoint address. There will also be an additional Username and Password field, which you should fill out if required by the destination. sip:jack@sample.com
SIP Endpoint (Twilio Programmable Voice SIP Domain) Put the fully qualified endpoint name in SIP Endpoint, and leave the additional Username and Password fields blank. sip:{user}@{domain}.sip.us1.twilio.com
Conference Specify the SID of the Conference resource to connect to. CFe08c870b500f6e44a9ad184defd1f391

Simultaneous dialing (simulring) is useful when you have several phones or several people that you could route a caller to. The first call that connects will cancel all the other simultaneous calls. If you dial an office phone system or a cellphone in airplane mode, it may pick up after a single ring, preventing the other phone numbers from ringing long enough for a human ever to answer. (Note that reaching a phone's voicemail or an automated message is considered to be a connected call.) Take care to use simultaneous dialing only in situations where you know the behavior of the called parties.

Simulring is only available for phone numbers in Studio. However, the TwiML <Dial> verb allows you to simultaneoulsy dial up to 10 Twilio Voice JavaScript SDK clients or SIP endpoints. You can build TwiML into a Studio Flow with the Add TwiML Redirect Widget or by creating a serverless function that runs the TwiML and using the Run Function Widget.

Optional Configuration for Connect Call To

The Connect Call To Widget also accepts a number of configuration options that you can use to toggle recording or specify a timeout duration.

名前 概要 初期値
Record Boolean indicating whether to record the call and save it as an mp3 file. true false
Timeout An integer representing the number of seconds to wait for the dialed party to answer the call. The minimum allowed is 1 second, and the maximum value is 600 seconds. 10 30
Time Limit Maximum duration of the connected call in seconds. The connected call will automatically end when this limit is reached.

If no value is provided, the default time limit on calls is 4 hours, unless you enable the "24-Hour Maximum Call Duration" feature in your Programmable Voice General Settings.
3600 Empty

Connect Call To Transitions

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

名前 概要
Connected Call Ended The connecting call ended. This could be because the connected caller ended the call, the timeout ended the call before the call was connected, or the call failed.
Caller Hung Up The connecting call ended because the caller hung up.

Connect Call To Variables

After the Connect Call To Widget executes, it stores the following variables for use throughout your Studio Flow. For more information on working with Widget variables, see Studio's Getting Started guide.

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

名前 Liquid Template Language
Dial Call Duration {{widgets.MY_WIDGET_NAME.variables.DialCallDuration}}
Dial Call SID {{widgets.MY_WIDGET_NAME.variables.DialCallSid}}
Dial Call Status {{widgets.MY_WIDGET_NAME.variables.DialCallStatus}}
Recording URL {{widgets.MY_WIDGET_NAME.variables.RecordingUrl}}

Example: Call Multiple Numbers

This example shows a user being connected to multiple contacts. The first contact to pick up the phone (even through answering machine) will be the official recipient of the call while the others will have their calls canceled.

Twilio Studio Connect Call To Widget Example

さらに詳しく

Now that you are familiar with the Connect Call To Widget, you can start building it into Flows with other Widgets.

  • Check out the Split Based On... Widget to learn how to split your Flow based on user conditions. For example, using the Split Based On... Widget after the Connect Call To Widget, you could perform different actions depending on whether or not the call was answered (using the DialCallStatus variable from the Connect Call To Widget).
  • The Connect Call To Widget is commonly used in IVR menu applications. Check out the tutorial for building a full IVR using Studio.
  • Learn how to Forward Calls with Twilio Studio using this Widget

皆さまが何を開発されるのか、目にするのが待ちきれません!

ページを評価:

ヘルプが必要ですか?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.

フィードバックくださりありがとうございます!

Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

Sending your feedback...
🎉 Thank you for your feedback!
Something went wrong. Please try again.

Thanks for your feedback!

Refer us and get $10 in 3 simple steps!

ステップ1

Get link

Get a free personal referral link here

ステップ2:

Give $10

Your user signs up and upgrade using link

ステップ3

Get $10

1,250 free SMSes
OR 1,000 free voice mins
OR 12,000 chats
OR more