Skip to main content
Version: Latest
User ManualNeed configuration, code or deployment details? In the Technical Manual: Agents, Queues, Routing, and DialerInbound and Outbound Voice Routing Architecture

Queues and Queue Groups

A queue is where waiting work lines up until an agent takes it: an inbound call, a callback, or a message sent to a department. The queue decides which agent gets the next item, how long an offer rings, what callers hear while they wait, and where they go when you are closed or too busy.

MenuInteraction Center > Management > Queues (and Queue groups)
PermissionManage Contact Center queues (queue groups also accept Manage Contact Center queue groups)
FeatureContact Center Work Distribution
Can't find it?

What you see depends on your role. If the menu, a button or a setting on this page is missing, ask your administrator to give you the permission listed above or to turn on the feature. Only administrators can turn features on and change site settings.

Create a queue group (optional)​

Queue groups only organize queues for administration and reports, for example Sales and Service. They never change routing.

  1. Open Interaction Center > Management > Queue groups and click Add queue group.
  2. Enter a Name and, optionally, a Description, then Save.
AI answering

A queue holds callers and texts for people; it has no AI setting. To have an AI profile answer a number's calls or texts, set Route to to AI voice agent or AI agent on the number's inbound entry point. See Let the AI answer incoming calls and Let the AI answer incoming texts.

Clone a queue​

To start a queue from an existing one, open its Actions menu in the queue list and choose Clone. The form opens with every setting of the original and the name Copy of the original's name. Change what you need and click Save. The agents who work the original queue are not added to the copy.

Create a queue​

  1. Open Interaction Center > Management > Queues and click Add Queue.
  2. Fill in the cards described below. Only Name is required; every other value has a sensible default.
  3. Click Save.

To send phone calls to the queue, point an inbound entry point at it. Agents take work from the queue once they sign in to it.

General​

FieldWhat it does
NameThe name agents and supervisors see. Required.
DescriptionA note for administrators.
Queue groupThe group the queue is reported under. Leave empty for No queue group.
EnabledA disabled queue receives no new assignments.

Routing​

FieldWhat it does
Default priorityLowest, Low, Normal, High or Highest. Higher-priority items are offered first. It applies to callbacks, workflow enqueues that name no priority, dialer work and lines that have no entry point. A call that comes through an inbound entry point starts at that entry point's own Priority instead.
Routing strategyHow the next agent is chosen: Longest idle (the agent who has been available the longest, the default), Round robin (the agent who finished work longest ago), or Least busy (the agent with the fewest active interactions). With longest idle, an agent who finishes a call goes to the back of the line. An agent whose offer or dialed call never reached them (the caller hung up, or nobody answered the dial) keeps their place. An agent who declines an offer or lets it ring out goes to the back. Campaigns always pick agents by longest idle.
Prefer the last assigned agent (sticky)When the work returns to the queue while its last owner is still recorded, and that agent is available and eligible, offer it to them first. A new inbound call has no previous owner, so it does not go to the agent a returning customer spoke to last time. It never overrides skills, capacity or the order of declines.
Reservation timeout (seconds)How long an offer rings for one agent before the unanswered-offer action applies. Default 30.
Unanswered offer actionRequeue (offer it to the next agent, the default), Send to voicemail, or Reject call (end the call). It also applies when an agent accepts the offer but their phone cannot be reached: the caller is treated as unanswered, and that agent is set to Away with the reason Phone unreachable until they set their own state again.

Service levels​

FieldWhat it does
Service Level Agreement (SLA) threshold (seconds)A waiting item that waits longer than this breaches the service level. The live dashboard counts breaches. Default 120.
Age waiting items past the SLA thresholdRaise the priority of an item by one level once it has waited twice the threshold, and by one more level for each further threshold, so old items are not stuck behind new high-priority ones. The wait counts from the first time the caller joined a queue, so it survives overflow, and the raise has no ceiling.
First-response target (seconds)Messaging only: how quickly the first reply to a new conversation should go out. 0 means no target.

Skills​

FieldWhat it does
Required skillsAgents must hold every skill picked here at proficiency 3 or higher.
Skill requirementsFiner rules, one row per skill (click Add skill requirement for each): Minimum proficiency (1-5); Required (unticked means preferred, which only ranks agents rather than excluding them); and Relax after (s), which drops the requirement once an item has waited that long (0 means never).

Agents get their skills on the agent entitlements screen.

Hours and overflow​

FieldWhat it does
Inbound phone numberOnly on tenants without Contact Center Inbound Entry Points: the phone number whose calls route to this queue. With inbound entry points, the card points to them instead, because numbers are routed from their entry point.
Business hours calendarThe calendar that says when the queue is open. Empty means Always open. Routing pauses while the queue is closed.
After-hours actionHold in queue (the default) or Overflow to another queue while closed.
Overflow queue / Overflow after (seconds)A single overflow hop: after this many seconds of waiting, move the caller to the overflow queue. 0 means no time-based overflow.
Overflow chainSeveral hops (click Add overflow hop for each), each with a queue and a wait in seconds. It replaces the single hop. A caller never returns to a queue they have already been in.

Limits​

FieldWhat it does
Maximum callers waiting0 means no limit.
Queue-full actionAdmit anyway (the default), Overflow to the first queue with room, or Send to voicemail.
Maximum wait (seconds)0 means no limit.
Maximum-wait actionKeep waiting (the default), Overflow to the next queue, or Send to voicemail. An overflow action needs an overflow queue or chain.

While callers wait​

FieldWhat it does
Welcome messageSpoken once when the caller enters the queue.
Hold musicA recording from Voice media. Empty plays a ringing tone.
Announcement interval (seconds)How often to interrupt the music with an update. 0 means no announcements.
Announce the caller's place in line / Announce the estimated waitWhat the update says. The estimate is place in line × average handle time ÷ available agents.
Average handle time (seconds)Used for the estimate. With 0, no estimate is spoken. The estimate is only spoken while at least one agent is available.
Minimum / Maximum announced estimate (seconds)Keeps the spoken estimate between these bounds (30 and 1800 by default).

Callback​

FieldWhat it does
Callback keyThe key (0-9, * or #) a waiting caller presses to hang up and get a call back instead. Empty means callbacks are not offered.
Offer callback after (seconds)How long a caller waits before the callback is offered.

A caller who presses the callback key leaves the queue and is called back: a background task creates the callback within about a minute, queues it again on the same queue at the queue's default priority, and offers it to an agent like a preview call. The agent accepts, and the platform dials the customer. Callbacks need the Contact Center Outbound Dialer feature; without it no callback is stored.