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

Enqueue Call

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.



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

The Enqueue Call Widget allows you to enqueue the current call into a call queue. The caller will hear hold music until the call is dequeued via TaskRouter or a custom-built dequeuing mechanism. See the <Enqueue> documentation for more information on working with enqueued calls.

Enqueue Call Widget.

Required Configuration for Enqueue Call

required-configuration-for-enqueue-call page anchor

The Enqueue Call Widget requires several pieces of information to function properly. You must select a Queue or TaskRouter Task when configuring this Widget. The choice may be selected from a dropdown, with additional configuration fields appearing based on the selection.

Queue NameThe name of the Queue to place the call into. If this Queue doesn't exist, it will be created on demand. Max length of 64 characters.EveryoneN/A
Task Router WorkspaceThe TaskRouter Workspace where the desired Workflow is located.Customer SupportN/A
Task Router WorkflowThe TaskRouter Workflow responsible for handling the queue.ReturnsN/A

Optional Configuration for Enqueue Call

optional-configuration-for-enqueue-call page anchor

The Enqueue Call Widget also accepts a number of configuration options that you can use to declare task attributes, priority, timeout, a hold music TwiML URL, and the TwiML request method for the request initiated by this Widget.

Task AttributesJSON representing task attributes (max 1024 characters)See belowN/A
PriorityThe priority of this task in the TaskQueue. Tasks with a higher priority are assigned before older tasks with a lower priority. If not specified, will be treated as 0 during evaluation.0N/A
TimeoutThe number of seconds you want the task to remain in this TaskQueue. Must be a positive integer < 2 weeks in seconds. If not specified, defaults to infinity.600N/A
Hold Music TwiML URLThe URL for custom hold music TwiML. If not specified, the default hold music will play upon enqueue. takes you to an external page)N/A
TwiML Request MethodThe request method to be used.GET or POSTGET

Task Attributes Example

task-attributes-example page anchor

"type": "call",
"contact": "+15558675309",
"customer-value": "gold",
"task-reason": "support",
"callSid": "CA42ed11..."

Enqueue Call Transitions

enqueue-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.

Call CompleteTransition is triggered when the Enqueue action URL is requested. Due to the underlying behavior of the Enqueue action URL, Studio can only regain control of the live call after dequeueing if the call was originally dequeued using <Dial><Queue>.
Failed to EnqueueTransition is triggered if enqueuing of the call fails due to full call queue (each call queue cannot exceed 100 calls), returning QueueResult as "queue-full".
Call FailedTransition is triggered if QueueResult is "system-error".


QueueResult information can be found in the TwiML enqueue documentation.

When the Enqueue 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 Voice: <Enqueue> and Call Resource pages.

NameLiquid Template Language
Account SID{{widgets.MY_WIDGET_NAME.AccountSid}}
API Version{{widgets.MY_WIDGET_NAME.ApiVersion}}
Call SID{{widgets.MY_WIDGET_NAME.CallSid}}
Call Status{{widgets.MY_WIDGET_NAME.CallStatus}}
Caller Name{{widgets.MY_WIDGET_NAME.CallerName}}
Forward From{{widgets.MY_WIDGET_NAME.ForwardedFrom}}
Parent Call SID{{widgets.MY_WIDGET_NAME.ParentCallSid}}
Queue Result{{widgets.MY_WIDGET_NAME.QueueResult}}
Queue SID{{widgets.MY_WIDGET_NAME.QueueSid}}
Queue Time{{widgets.MY_WIDGET_NAME.QueueTime}}

Example: Hold For Support Agent

example-hold-for-support-agent page anchor

Once the customer calls the phone number associated to the Studio Flow, they will be greeted and told that they are being put on hold while a representative is found to help them. They will be enqueued into a call queue which will be handled by the assigned TaskRouter Workflow. Once a Worker accepts the Task and the call is complete, you may engage with the contact further using the transitions given by the Enqueue Call Widget.

Twilio Studio Enqueue Call Widget Example.

This is the configuration for Widget with the TaskRouter Workspace and Workflow assigned.

Twilio Studio Enqueue Widget Exampled Configuration Updated.

Now that you know the basics of the Enqueue Call Widget, why not learn more about a Call Resource?

  • Learn how to work with a call in the Call Resource documentation .
  • Learn more about TaskRouter Workspaces, Workflows, and Tasks starting from the TaskRouter Quickstart .

We can't wait to see what you build!

Rate this page: