Skip to contentSkip to navigationSkip to topbar
Page toolsOn this page

Setting up a TaskRouter Workspace: Add and Configure TaskQueues


TaskQueues assign Tasks to Workers based on Worker attributes. For our example, we will use two TaskQueues - one for requests in Spanish and one for requests in English.

With your Workspace open in the TaskRouter console(link takes you to an external page), click 'TaskQueues' then 'Create TaskQueue'.


TaskQueue #1 - Spanish

taskqueue-1---spanish page anchor

Our first TaskQueue will target Workers like Alice who possess Spanish language skills.

Target Workers are described using an SQL-like syntax which matches against the JSON attributes of Workers. Use the HAS operator to check whether a Worker's languages array includes the value "es":

Be sure to set the Reservation Activity to 'Reserved' and the Assignment Activity to 'Busy'.

Target Workers Expression: languages HAS "es"

Create TaskQueue form with Spanish customer care settings and queue expression 'languages HAS es'.

TaskQueue #2 - English

taskqueue-2---english page anchor

To complete our example of language-based routing, create a second TaskQueue, this time targeting Workers like both Alice and Bob who possess English language skills:

Target Workers Expression: languages HAS "en"

TaskQueue setup with name, workspace, task order, and queue expression for English language.

Validating TaskQueue Filters

validating-taskqueue-filters page anchor

Reopen the 'Customer Care Requests - English' TaskQueue and scroll to the bottom of the page. You should see that both Alice and Bob are eligible to receive tasks from this TaskQueue:

Table showing workers Alice and Bob, both unavailable and offline, with language attributes.

Reopen the Spanish TaskQueue for comparison - only Alice will show in the list of matching Workers:

Worker Alice is unavailable, offline, speaks English and Spanish.

Wonderful. We have created two TaskQueues to target our Workers. But before a TaskQueue assigns a Task to a Worker, the Task needs to be created and added to the TaskQueue. That's the role of a Workflow.

Next: Add a Workflow »