Technical guide
Genesys Cloud routing explained: bullseye, conditional, preferred and predictive
Every interaction that reaches a Genesys Cloud queue is matched to an agent by a small set of settings: the routing method, the evaluation method, the scoring method and each agent's utilisation. This guide explains each one from Genesys's own documentation, how they interact, and how to choose and test the right combination for your queues.
In short
- A queue's routing method decides how agents are chosen; for skills-based routing, its evaluation method decides how skills and proficiency count.
- Bullseye widens the pool in rings; conditional group activation brings in other agents when a queue is under pressure, and Genesys recommends it over conditional group routing.
- Preferred agent routing ignores skills, last agent routing covers threaded email and messages only, and predictive routing falls back to standard routing.
- Most routing problems come from settings around the method: alerting timeouts, utilisation, scoring and skills that do not match.
01
How Genesys Cloud decides who gets an interaction
Genesys Cloud ACD uses each queue's routing method to match interactions with agents. For skills-based routing, an evaluation method decides how the skills an interaction requests are compared with agents' skills. A scoring method decides which waiting interaction goes first when an agent becomes free, and utilisation decides whether an agent has room for another interaction at all. An agent must also be a member of the queue and on queue. Most routing surprises come from one of these settings interacting with another, so it helps to treat them as one design rather than four separate options.
Genesys documents five routing methods, set on the queue's Routing tab. Standard routing is the default. The others either widen or narrow the pool of agents over time, or use a model to pick the best match. Several can be combined with conditional group activation, which runs alongside the routing method rather than replacing it. The table summarises each in Genesys's words.
| Routing method | What it does | Typical use |
|---|---|---|
| Standard ACD (default) | Routes interactions to the next available agent, considering skills as the evaluation method specifies | Most queues |
| Bullseye | Routes to a targeted sub-queue of skilled agents first, then relaxes skills ring by ring to widen the pool | Specialist work with generalist back-up |
| Conditional group routing | Routes to a dynamically expanded pool of agents shared between queues, based on rules that protect other queues' targets | Shared agent pools; Genesys now recommends conditional group activation |
| Preferred agent | Routes interactions to a pool of preferred agents first | Account managers, relationship or follow-up handling |
| Predictive routing | Uses AI analysis to find the best available match between an agent and the interaction | Queues optimising one KPI, with enough history |
02
Skills, languages and proficiency
Agents hold ACD skills and language skills, each rated from 0 to 5 stars. Genesys documents that skill changes take effect immediately, whether or not the agent is on queue, and that an agent who does not speak an interaction's language does not receive it, whatever their ACD skills. Interactions request skills in Architect: the Transfer to ACD action can add ACD skills, a language skill, a priority, preferred agents and a direct agent, and in-queue flows can change skills with the Set Skills action. If a flow sets no language skill, the flow's default language applies.
Genesys has added ACD skill expression filters, which combine ACD skills, language skills and proficiency into a single rule per interaction. They work with standard or predictive routing using the All skills matching evaluation method, and Genesys states that they do not work with preferred agent, last agent, direct or bullseye routing. Where a flow sets both a filter and individual skills, the filter is used. Workforce management does not use skill expression filters, so forecasts and schedules still plan by individual skills. Keep the skill catalogue small and named for the work, not for the team, so that routing, reporting and planning stay aligned.
03
Evaluation methods: how skills are compared
With standard routing, the evaluation method decides how requested skills count. The table sets out the three methods. Two details from Genesys matter in practice. Best available skills looks at the 100 agents with the longest time since their last interaction, picks the best average proficiency among them and uses longest idle as the tie-break, so on a large queue it is not a search of every agent. And time since last interaction is counted across all of an agent's queues, looking back seven days, so an agent who works several queues is not ranked as idle on one while busy on another.
| Evaluation method | How Genesys selects the agent | When to use it |
|---|---|---|
| All skills matching | The agent with all of the required skills and the longest time since last interaction; skill ratings are not considered | Skills are a hard requirement and proficiency does not vary much |
| Best available skills | Among the 100 longest-idle agents, the highest average proficiency, with longest idle as the tie-break; if none match, it keeps looking for any agent with the skills | Proficiency matters and you want experts used first |
| Disregard skills, next agent | The agent with the longest time since last interaction; skills are ignored | Every agent can handle every interaction on the queue |
04
Scoring: which waiting interaction goes first
When interactions are waiting and an agent becomes free, the scoring method decides the order. With conversation score, Genesys combines arrival time and priority: one priority point counts as one minute, so a call with a higher priority is treated as if it arrived earlier. With priority score, the highest priority goes first, and time in queue breaks ties. Genesys notes that where queues use different scoring methods, interactions in priority-score queues are routed first, and that changing the method while interactions are waiting can assign them in an unexpected order. Set the scoring method when you create the queue, or when it is empty, and use priority deliberately rather than as a quick fix for one caller.
05
Bullseye routing: widening the pool in rings
Bullseye routing offers an interaction to a small, targeted group of agents first and widens the pool if nobody suitable answers in time. Genesys describes the expansion as concentric rings, each a fallback for the one before. Each ring has a timeout from 2 seconds to 72 hours. Rings can be built in two ways: by assigning users or groups, including skill expression groups, to each ring on the Members tab, or by removing requested skills as the interaction moves out of a ring, up to 50 skills per ring. Removed skills stay on the interaction for reporting but no longer count in the next ring, and agents in earlier rings keep priority as the pool grows.
Skill removal works best with the All skills matching or Best available skills evaluation methods; with Disregard skills, next agent, skills do not matter in any ring. Genesys's Terraform provider allows up to six rings per queue. Keep ring timeouts short enough that customers do not wait for a perfect match that is not available, and check service levels by ring rather than for the queue as a whole.
resource "genesyscloud_routing_queue" "billing" {
name = "Billing"
# NONE | BEST | ALL
skill_evaluation_method = "BEST"
# the default scoring method
scoring_method = "TimestampAndPriority"
acw_wrapup_prompt = "MANDATORY_TIMEOUT"
acw_timeout_ms = 120000
media_settings_call {
alerting_timeout_sec = 15
service_level_percentage = 0.8
service_level_duration_ms = 20000
}
# ring 1: wait 20 s, then drop the specialist skill
bullseye_rings {
expansion_timeout_seconds = 20
skills_to_remove = [genesyscloud_routing_skill.disputes.id]
}
# ring 2: wait 20 s more, then drop the language skill
bullseye_rings {
expansion_timeout_seconds = 20
skills_to_remove = [genesyscloud_routing_skill.welsh.id]
}
}06
Conditional group routing and conditional group activation
Conditional group routing lets a queue under pressure borrow agents from groups whose own queues are healthy. Its rules combine a KPI, currently estimated wait time, with agent availability, up to five rules each with a wait period, and rule 1 checks whether the original queue is overloaded. Genesys documents that after the last rule there is no fallback routing method, that it does not support last agent routing or workitems, and that it suits single-media queues best. Genesys has also stated that it plans no further enhancement to conditional group routing and recommends migrating its rules to conditional group activation.
Conditional group activation works differently. It runs as a background process alongside the queue's routing method, evaluating the health of the queue periodically, for example every 30 seconds, and activating or deactivating extra member groups for all waiting conversations at once. Genesys documents that it works with standard, bullseye, preferred agent and predictive routing, but not with last agent or direct routing, and not alongside conditional group routing. With predictive routing, activation decides when more capacity is needed and the model decides who is best. Our Innovation article on borrowing agents safely compares the two in more detail.
07
Preferred agent, last agent and direct routing
Preferred agent routing lets a flow name up to 20 preferred agents with scores from 0 to 100; Genesys can raise the limit to 100 through Customer Care. Interactions go to preferred agents first, regardless of their ACD and language skills, choosing by time since last interaction among agents whose score meets the current threshold, in up to six rings with timeouts from 2 seconds to 72 hours. Preferred agents must be members of the queue and on queue; if none are, the ring timeout is skipped. When the rings run out, the queue's timeout routing method takes over: standard, bullseye or conditional group routing. Genesys also notes that preferred agents are dropped on transfer and that preferred agent routing is not compatible with workforce management scheduling and forecasting.
Last agent routing applies only to threaded email and messages, not voice. It is set on the queue's General tab, to the last agent on any queue (the default), the last agent on the conversation's queue, or disabled, and it needs the agent to be on queue. Genesys documents that it only works when email is sent directly to a queue rather than through an Architect email flow. Direct routing, for voice, SMS and email, sends interactions to a named agent through a queue as ACD work, with a backup agent or queue set in an in-queue flow; a direct agent in Transfer to ACD takes precedence over the queue's routing method.
08
Predictive routing in brief
Predictive routing uses machine learning to match each interaction with the available agent best able to handle it, optimising one KPI per queue: average handle time, next contact avoidance or a custom KPI. It supports inbound voice, email and asynchronous messages. Genesys documents a benefit assessment that needs at least 900 inbound interactions on 45 days within a 90-day period, incurs no cost and needs no subscription, followed by a comparison test and then ongoing operation, with standard routing as the fallback when the predictive timeout expires. Licensing, token use and when it pays back are covered on our predictive routing page, which the AI section keeps up to date.
09
Utilisation and capacity across channels
Utilisation is the maximum number of concurrent interactions Genesys Cloud ACD can assign to an agent, set per media type at organisation level and optionally overridden for individual agents. Genesys's defaults are one call, one callback, one email, and up to four chats, four messages and four workitems. By default email can be interrupted by other interactions, calls and callbacks cannot interrupt each other, and non-ACD calls do not count unless you choose to count them. An agent who is fully utilised is skipped by every routing method, which is why a queue can show agents on queue and interactions waiting at the same time.
Utilisation labels refine this: up to 100 labels per organisation, one per interaction, set in Architect, with media-level limits checked before label limits. Use them to stop, for example, two complex complaint messages landing on one agent at once. Design utilisation with workforce management, because concurrency changes how many agents a forecast needs.
10
Choosing a routing method
Start with the simplest design that meets the requirement and add complexity only where data shows a need. Most queues work well with standard routing and All skills matching or Best available skills. Reach for bullseye when specialist skills are scarce, conditional group activation when queues should share agents under pressure, preferred agent routing when relationships matter more than skills, and predictive routing when a queue has the volume and a clear KPI. The table gives starting points rather than rules.
| Requirement | Starting point | Watch for |
|---|---|---|
| Small team, everyone handles everything | Standard, Disregard skills, next agent | Agents on several queues share one idle clock |
| Hard skill requirements, such as language or licence | Standard, All skills matching | Interactions waiting when no matching agent is on queue |
| Experts first, others when busy | Standard with Best available skills, or bullseye | Ring timeouts long enough to hurt service level |
| Queues that should help each other | Conditional group activation | Protecting the lending queue's own targets |
| Customers who should reach their own adviser | Preferred agent, with a timeout routing method | Transfers drop preferred agents; WFM does not plan for it |
| Email or message threads that should stay with one agent | Last agent routing | Email sent through Architect email flows is not covered |
| A KPI to optimise, with enough history | Predictive routing, after a benefit assessment | One KPI per queue; standard routing on timeout |
11
Settings that cause most routing problems
Several queue settings sit around the routing method and cause most reported faults. The alerting timeout, from 7 to 59 seconds, decides how long an interaction rings before Genesys puts the agent into Not Responding and returns the interaction to the queue; a Not Responding agent receives nothing until made eligible again, and auto answer removes the alerting timeout altogether. After call work can be optional, mandatory, time-boxed or agent-requested, with a timeout of up to an hour, and it holds agents out of routing while it runs. An organisation setting, Routing Includes Agent Presence, decides whether a presence change resets an agent's idle time, which changes who is next.
Test routing before go-live with scripted scenarios on each queue: matching and non-matching skills, every bullseye ring, a fully utilised agent, a Not Responding agent, priority interactions and transfers. Then watch interaction detail and queue performance views by ring and by agent for the first weeks. QVCCS designs, builds and tests routing like this remotely unless agreed otherwise, and configures it as code so the design can be reviewed and repeated. Every delivery team member holds, or is completing, Genesys Cloud certification.
Questions
Common questions
What is the difference between bullseye routing and conditional group activation?
Bullseye routing evaluates each conversation on its own, offering it to a small group first and widening the pool ring by ring as time passes. Conditional group activation evaluates the health of the whole queue periodically and brings extra member groups in or out for all waiting conversations at once. Genesys documents that the two can be used together, because activation runs alongside the routing method.
Should we still use conditional group routing?
Genesys continues to support conditional group routing in its current form, but has said it plans no further enhancements and recommends migrating its rules to conditional group activation. Activation works with standard, bullseye, preferred agent and predictive routing, while conditional group routing has no fallback routing method after its last rule. New designs should normally start with conditional group activation.
Why do interactions wait when agents show as on queue?
The usual causes are utilisation, skills and timers. A fully utilised agent is skipped by every routing method; an agent without a required skill or language is not eligible; agents in after call work or Not Responding receive nothing. Check the waiting interaction's requested skills against the on-queue agents, then their utilisation and status, before suspecting the routing method itself.
Does preferred agent routing respect skills?
No. Genesys documents that preferred agent routing sends interactions to preferred agents first regardless of their ACD and language skills, so long as they are members of the queue, on queue and not fully utilised. Skills apply again when the rings run out and the queue's timeout routing method, standard, bullseye or conditional group routing, takes over.
Sources
- Routing and evaluation methods – Genesyshelp.genesys.cloud
- Create and configure queues – Genesyshelp.genesys.cloud
- Bullseye routing overview – Genesyshelp.genesys.cloud
- Conditional group routing overview – Genesyshelp.genesys.cloud
- Conditional group activation overview – Genesyshelp.genesys.cloud
- Preferred agent routing behaviour – Genesyshelp.genesys.cloud
- Last agent routing overview – Genesyshelp.genesys.cloud
- Direct routing overview – Genesyshelp.genesys.cloud
- Predictive routing overview – Genesyshelp.genesys.cloud
- Predictive routing benefit assessment – Genesyshelp.genesys.cloud
- Assign or remove skills for a user – Genesyshelp.genesys.cloud
- Transfer to ACD action – Genesyshelp.genesys.cloud
- Utilization – Genesyshelp.genesys.cloud
- Genesys Cloud ACD processing – Genesyshelp.genesys.cloud
- Configure call work settings – Genesyshelp.genesys.cloud
- genesyscloud_routing_queue – Genesys Cloud Terraform providergithub.com
Keep reading
More guides
Genesys Cloud CX licence tiers explained: CX 1 to CX 4, add-ons and models
Genesys Cloud CX 1, CX 2, CX 3 and CX 4 compared: what each tier includes, digital-only options, add-ons, AI tokens, and named versus concurrent licensing.
Read the guideGenesys Cloud Edge end of life: moving premises Edges to hybrid and cloud media
Genesys Edge hardware reaches end of support on 1 December 2026 and end of life on 1 June 2027. How to move premises Edges to hybrid and cloud media, in steps.
Read the guideBuilding a data lake or data warehouse on Genesys Cloud CX
How to build a data lake or warehouse on Genesys Cloud CX: analytics jobs, lakehouse export, EventBridge, notifications, a reference model and an API map.
Read the guide