Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Create a work item queue

Define or change a queue so that you can determine which work items are routed automatically to agents through a given service channel.

Before you begin

Role required: awa_admin or admin

About this task

Depending on the service channel, additional configuration options are available. For example, in the chat channel you define the standard messages displayed during a chat session with a user.

Procedure

  1. Navigate to the queue settings through one of the following navigation paths:

    • All > Advanced Work Assignment > Home.

      In the Essential settings section, select Set up queues.

    • All > Advanced Work Assignment > Queues.

    • Choose a situation.

    • To create a queue, select New.

    • To change a queue, select the queue record to be updated.
    • On the form, fill in the fields.
FieldDefinition
NameName of the queue. A default queue may be available for the service channel you activated through the plugins related to AWA.
NumberBase number for the table. For more information, see Record numbering.
Service channelChannel to which the queue belongs. For the chat channel, define the standard messages displayed to chat users in the Chat Messages section.
ActiveOption indicating whether the queue is enabled.
ApplicationType of scoped application.
ScheduleSupport schedule that defines when the queue is available.
OrderDuring routing, the order in which AWA considers the routing condition for this work item queue, in comparison to other queues.
Short descriptionBrief explanation of the queue.
Routing Condition
Define condition hereOption that indicates a routing condition is to be applied to the queue. If checked, define the Condition mode and Work item routing condition.
Condition modeType of condition for routing work items in the queue. - Simple: Specify a routing condition using the condition builder. - Advanced: Specify a JavaScript scripted condition.
Work item routing conditionCondition that applies to routing work items to this queue. Use the condition builder to select routing conditions. The fields available for selection are based on the selected service channel. For the chat service channel, you can specify chat context variables in the condition builder by dot-walking to related context fields. For example, if you defined chat context variables that store pre-chat routing information, you can dot-walk to those chat context variables in the condition builder. You can use the variables in routing conditions to specify where chats are routed.
ScriptJavaScript condition statement that specifies the work items to be routed to the queue. The condition must evaluate to true. This field appears only when Advanced is selected from Condition mode.
Initial agent responseMessage that users see when an agent accepts a chat. For example: `Thank you for contacting support. I am looking into your question now and will be with you shortly.`
Max wait time messageMessage that users see when a chat ends because the Max Wait Time has elapsed.This field is required if the Max Wait Time is greater than 0.
Target wait timeEstimated time \(Days or Hours, minutes, seconds\) allotted for an agent to accept an item in the queue.
Max Wait TimeMaximum amount of time that all available agents have to accept or reject a chat request. After time runs out, the requester receives the value in either the Max wait time message field or the No Agents Available Message field defined in Agent Chat settings.Note: The Max Wait Time field is available after you associate the queue to the chat service channel.
  1. Select Submit for a new queue or Update to change the queue.

    The queue is added to or updated in the Queues [awa_queue_list] table.

What to do next