Skip to main content

Queue Configuration Reference


1. What Is a Queue?

A queue is a holding area where interactions (calls, chats, emails, callbacks) wait to be routed to an available agent. Queues are the backbone of ACD (Automatic Call Distribution) routing in Genesys Cloud — every Transfer to ACD action in Architect points to a queue.

📌 Genesys Cloud supports up to 5,000 queues with a maximum of 5,000 members per queue for voice and chat channels.


2. How to Navigate to Queues

Two ways to get there:

  • Search bar → type "Queues"
  • Admin menu → Contact Center → Queues

⚠️ Permissions required: You must have administrative credentials with the Routing > Queue permission to create or edit queues. Users with only Routing > QueueMember > Manage permission can manage membership only — not queue settings.


3. Creating a New Queue

  1. Navigate to Admin → Contact Center → Queues
  2. Click + Create Queue (top right)
  3. Fill in the Name — must be unique; cannot contain asterisks
  4. (Optional) Select a Division
  5. (Optional) Copy settings from an existing queue to replicate its configuration and members
  6. Click Save

📌 Naming tip: Use a consistent naming convention (e.g., Support_Inbound, Sales_Chat) so queues are easy to identify in Architect flow dropdowns and reports.

4. Queue Configuration Tabs

After saving, the queue opens with several configuration tabs:

📋 General Tab

SettingDescription
NameUnique identifier — cannot contain asterisks
DivisionOrganizes the queue within your org's division structure
DescriptionOptional notes about the queue's purpose
After Call Work (ACW)Controls agent wrap-up behavior after each interaction
Auto AnswerAutomatically answers interactions for agents on this queue (digital channels)
Last Agent Routing (LAR)Routes interactions to the last agent who handled that customer
Manual AssignmentAllows supervisors/agents to pull interactions from the queue manually

⏱️ After Call Work (ACW) Modes

The lecture covers this partially — here is the complete list per current documentation:

ACW ModeDescription
OptionalAgent can enter ACW manually or skip it entirely
Mandatory DiscretionaryACW is required but agent decides when to end it and return to queue
Mandatory Time-boxedACW has a set time limit; agent can end early and return to queue before timer expires
Mandatory Time-boxed – No Early ExitAgent must wait the full time before returning to queue; cannot exit early
Agent RequestedAgent can request ACW; not automatically triggered

📌 Maximum ACW timeout: 3,600 seconds (1 hour). If an agent fails to complete ACW within the timeout, Genesys automatically assigns the default wrap-up code ININ-WRAP-UP-TIMEOUT.


🔀 Routing Tab

The Routing Tab is where you configure how interactions are matched to agents. The lecture mentions this is "based around skills" — here is the full picture:

Routing Methods (5 available)

Routing MethodDescription
StandardDefault method. Routes based on skills evaluation method you choose.
BullseyeSkills-based routing with expansion rings — widens the agent pool over time if no match found. Supports up to 5 rings with configurable delays.
PredictiveUses machine learning to analyze historical data and predict the best agent-interaction match to optimize a chosen KPI. Supports voice, email, and async messages.
Preferred AgentRoutes to specific preferred agents first, then falls back to bullseye rules. Supports up to 6 rings.
Conditional GroupRoutes based on real-time KPI conditions (e.g., queue wait time, agents available). Supports up to 5 rules with 10 conditions per rule.

Evaluation Methods (used with Standard and Bullseye routing)

Evaluation MethodDescription
All Skills MatchingAgent must have ALL required skills to receive the interaction
Best Available SkillsRoutes to the agent with the highest skill proficiency available
Disregard Skills / Next AgentIgnores skills entirely; routes to the agent idle longest

Scoring Methods

Scoring MethodDescription
Conversation ScoreCombines arrival time and priority value to rank waiting interactions
Priority ScoreUses only the priority value; time in queue used as tiebreaker

📌 Best practice: Set the scoring method at queue creation or when the queue has no waiting interactions. Changing it mid-queue can cause unexpected routing order.


👥 Members Tab

  • Add individual users or groups to the queue
  • Members must be added for the queue to receive and route interactions
  • For Bullseye routing, members can be assigned to specific rings
  • For Preferred Agent routing, agent score pairs (0–100) define priority

🏷️ Wrap-Up Codes Tab

  • Assign specific wrap-up codes agents can select after completing an interaction on this queue
  • Wrap-up codes are used for reporting and interaction categorization
  • If no code is selected by the agent within ACW timeout, ININ-WRAP-UP-TIMEOUT is automatically assigned

📌 The lecture notes wrap-up codes are covered in a separate course — but be aware this tab exists and connects directly to reporting.


🔊 Voice Tab (Additional Settings)

Not covered in the lecture — but present in the UI:

SettingDescription
Alerting TimeoutHow long an agent's phone rings before the interaction is redirected
Service LevelTarget % of interactions answered within a defined number of seconds
In-Queue FlowAssign an Architect in-queue flow (e.g., music on hold, queue position announcements)
Whisper PromptAudio played to the agent just before they answer the call

5. Queue Limits & Permissions Reference

ItemLimit / Detail
Max queues per org5,000
Max members per queue5,000 (voice and chat)
ACW max timeout3,600 seconds
Preferred agent ringsUp to 6
Bullseye ringsUp to 5
Conditional Group rulesUp to 5 rules, 10 conditions each
Queue nameMust be unique; no asterisks
Required permission (create/edit)Routing > Queue > Edit
Required permission (members only)Routing > QueueMember > Manage

6. How Queues Connect to Call Flows

Once a queue is created, it's referenced inside Architect flows using the Transfer to ACD action:

Call Flow → Evaluate Schedule → Open → Transfer to ACD → [Select Queue Name]

This is the core connection between Architect and Queues — the queue you create here is what you select in your Transfer to ACD action.


7. Best Practices

PracticeWhy It Matters
Use consistent naming conventionsEasy to find in Architect dropdowns and reporting
Set ACW mode intentionallyImpacts agent productivity and reporting accuracy
Choose routing method at creationChanging scoring methods mid-queue can cause unexpected routing
Assign an In-Queue flowControls caller hold experience (music, position announcements)
Test queue before connecting to live flowValidate routing behavior without impacting real callers
Don't leave queues without membersCalls will wait indefinitely with no agent to answer

8. Quick Reference Cheat Sheet

I want to...Where to configure
Create a new queueAdmin → Contact Center → Queues → + Create
Control how long agents do wrap-upGeneral tab → After Call Work
Change how calls are routed to agentsRouting tab → Routing Method
Add agents to the queueMembers tab → Add Users/Groups
Assign wrap-up codes to the queueWrap-Up Codes tab
Set hold music or queue announcementsVoice tab → In-Queue Flow
Play a message to agent before answeringVoice tab → Whisper Prompt
Reference the queue in a call flowArchitect → Transfer to ACD → select queue