Handbook
Genesys Cloud gamification: the handbook for performance leads
A complete handbook for the person who will own Genesys Cloud gamification day to day. It explains exactly how points are calculated, sets up profiles, metrics, zones, contests and external metrics in the right order, and shows how to design scorecards that change behaviour fairly rather than reward speed. Checked against Genesys sources on 13 November 2026.
In short
- Gamification is a performance management tool with a motivational interface; every metric should lead to a coaching conversation.
- A metric's maximum points is its weight, points fall on a straight line between zone limits, and they can go down during the day.
- Use target area objectives for handle time and pair efficiency with quality, so nobody is paid to rush.
- Set thresholds from baseline analytics, call them provisional at launch, and change them in the open.
- Design for the people outside the top ten: separate profiles, percentage of goal, several winners, anonymised contests and recognition.
01
What gamification is and how it works
This part explains what Genesys Cloud gamification is for, the objects you configure, and exactly how points are calculated. Read 1.3 twice: most early design mistakes come from misunderstanding it.
1.1 What it is for
Gamification turns performance objectives into performance points and shows them to agents and supervisors through scorecards and leaderboards in the Genesys Cloud Home view. Genesys places it inside performance management, whose purpose is to define objectives and measure individuals and teams against them, so supervisors can recognise good performance, diagnose issues and correct course. The stated aims include establishing coaching plans, promoting fairness and transparency, and bringing new agents up to speed faster.
That framing is the most important thing to understand before you configure anything. Gamification is a performance management instrument with a motivational interface, not a rewards scheme. Points exist to make objectives visible and feedback immediate. If the points are not connected to what you actually coach on, you have built a scoreboard for a game nobody needed to play.
1.2 The objects you work with
| Object | What it is | Where you configure it |
|---|---|---|
| Profile | A set of metrics and goals shared by a group of agents. One default profile per organisation, plus custom profiles. | Admin > Performance & Engagement > Gamification Profiles |
| Metric | One measure inside a profile: what is measured, for which media types, queues and direction. | The profile's Metrics tab |
| Objective | The performance bands for a metric: the zones, their limits and the points each pays. | The metric's Objective tab |
| Zone | One band in an objective: out of bounds, good performance or target. | Inside the objective |
| Member | An agent measured by a profile. An agent belongs to one profile at a time. | The profile's Members tab |
| Contest | A time-limited competition on up to 10 weighted metrics, with qualifiers and prize tiers. | Admin > Performance & Engagement > Gamification Contests |
| External metric definition | A measure from outside Genesys Cloud, such as CSAT, sales or NPS, brought in through the API. | Admin > Performance & Engagement > External Metric Definitions |
1.3 How points are calculated
- Points calculate in real time when agents meet or exceed the thresholds set for a metric.
- Between zone limits, points fall on a straight line. An agent halfway between the good limit and the target earns roughly halfway between the two point values, so zone widths and point steps define the incentive slope (see 4.4).
- Points are calculated per workday; a shift spanning two workdays splits its points across them.
- Points can go down during the day. Metrics change through the workday and points rise or fall with them; at the end of the workday the points reflect overall performance. Tell agents this on day one.
- Maximum points are your weightings. Genesys describes assigning maximum points as the way to give each metric a priority weight for a balanced scorecard. There is no separate weighting field: a metric's maximum points is its weight, and it is the main design lever you have.
- Out of bounds pays nothing. A value in a good zone earns the points set for that zone's limits, and target earns the maximum.
- Timing differs by view: contest data updates every 15 minutes, and Scorecard Insights holds data only up to yesterday, so a new metric appears on scorecards straight away but in Insights the next day.
1.4 Licensing and billing
Employee performance (real-time insights, gamification, learning and development, and coaching) is part of workforce engagement management. On Genesys's plan comparison, checked 13 November 2026, it is included in CX 3 and CX 4 and an add-on for CX 1 and CX 2.
On the add-on route, billing follows use, and one of the documented triggers is when a gamification point is generated for an agent. Since April 2026, administrators can also control WEM and speech and text analytics add-on licensing by assigning explicit permissions, which separates transcription from add-on billing. Some metrics carry their own requirements: the quality evaluation score metric and the Detected Topics metric each list the subscriptions they need in their release notes.
1.5 Who can see what
Three mechanisms control visibility. Roles and permissions decide who can view scorecards, leaderboards and profiles (the full lists are in 7.1); changes can take a few minutes to apply. Divisions decide who can manage a profile: only users with permission for the profile's division can view it, but members can come from any division, and a profile's division cannot be changed after the profile is created, so decide it first. Supervisors see custom profile leaderboards including all members, but can open an agent's scorecard only with Scorecard > View All and access to that agent's division.
For finer control, Genesys supports attribute-based access control policies on the reporting hierarchy, so supervisors see only agents in their reporting chain (direct reports or up to three levels deep) while administrators keep full access.
1.6 The limits that shape your design
| Limit | Value |
|---|---|
| Custom profiles per organisation | Up to 100, plus the default profile |
| Metrics per profile | Up to 50, counting disabled metrics |
| Members per profile | 2,000; each agent in one profile at a time |
| Reporting intervals per profile | Up to two; longest 90 days, 13 weeks or 3 months |
| Leaderboard rank limit for agents | Minimum 3; supervisors and elevated permissions see the top 300 regardless |
| Leaderboard size | 300 agents; agents who did not log in or earn points do not appear |
| Metrics per contest | Up to 10 |
| Prize tiers per contest | Up to three (Gold, Silver, Bronze), with at least one Gold prize |
| Prize image | Up to 5 MB; ideal 416 by 256 pixels |
| Gamification start date | Can be reset up to 30 days in the past |
| Personal best reset | From 30 days in the past to 60 days in the future |
| External metric uploads | Reflected for the current day and up to seven days back; not beyond seven days |
02
Setting it up, step by step
Follow this order. Each step assumes the previous one is done, and the first two happen before anyone opens the configuration screens.
2.1 Decide what you are trying to change
Write down, in a sentence each, the answers to these. They are decisions, not settings, but every setting later depends on them.
- The three behaviours you want more of next quarter. Behaviours, not numbers: agents close the loop on email within the promised time, not improve adherence.
- The one behaviour you fear people will sacrifice to win. It is almost always quality or courtesy.
- How a part-time agent who works two days a week can be recognised.
- What the reward is: time off, first choice of shifts, public thanks, or nothing. Gamification works without prizes, but decide that deliberately.
- Who may see whose scores, and whether anyone outside the team should see leaderboards at all.
2.2 Set thresholds from real data, not ambition
Genesys's own advice when setting zone limits is to use your current analytics, in the Agents Performance views, to establish a baseline.
- Open the agents performance view for the last 13 weeks, filtered to the population you plan to profile (the same queues and media types).
- Read three numbers for each candidate metric: the median, the 75th percentile and the 25th percentile.
- Set Target at about the 75th percentile, reachable by a good agent on an ordinary day; set the good edge near the median; set the out-of-bounds edge where a real problem starts.
- Check the result against the behaviour you fear people will sacrifice. If around a third of the team is already at Target, the goal is too soft; if very few reach it, most of the team will stop looking.
2.3 Turn gamification on
Go to Admin > Performance & Engagement > Gamification Profiles, click Settings (or go to Admin > Performance & Engagement > Gamification Settings), and on the Settings tab enable the Gamification toggle under General. Optionally set a Start Date, then save. Once activated, gamification starts collecting data and calculating points; data and points display from the start date, or from the day you enable it. The start date can be reset at any time, up to 30 days in the past.
Switching gamification off stops the calculation of points, and since April 2024 the leaderboards view is disabled entirely in organisations that have disabled gamification. Treat the toggle as a major decision, not a pause button.
2.4 Grant permissions
Build dedicated roles rather than adding permissions to existing ones, so you can audit them later. Agents need Ui > AgentActivity > View, Gamification > Leaderboard > View and Gamification > Scorecard > View, plus the permissions that light up the rest of the Activity view: Workforce Management > Agent Schedule > View (for punctuality and the mini schedule), Coaching > Appointment > Participate (coaching widget), Learning > Assignment > View (learning modules) and Quality > Evaluation > Edit Agent Sign-off (evaluation widgets). Supervisors need leaderboard and scorecard View and View All (the View All permissions are division-aware), and profile view and update.
2.5 Choose your profile structure
Every organisation has one default profile, with default metrics, objectives and membership. You can customise it as a fallback, but you cannot rename or delete it or change its description, status or division. Custom profiles measure selected groups of agents, for example technical support, chat support and escalations, and their settings override the default profile for their members.
Use a separate custom profile when the work is different, because agents ranked against each other must be playing the same game. Do not split just to be tidy: each profile is another thing to maintain, and a leaderboard of two people is an awkward comparison between colleagues, not a competition.
- Media type: handle time on email is not the same quantity as on voice.
- Agent maturity: new starters cannot fairly be ranked against experienced agents.
- Queue purpose: retention agents who rightly spend longer with customers will always lose a handle-time comparison with a service queue.
- Working pattern: a part-time or flexible pool may deserve its own profile (see 4.7).
2.6 Create the profile and set its details
Go to Admin > Performance & Engagement > Gamification Profiles and click New Profile. New profiles inherit all metrics from the default profile in the same state, enabled or disabled.
| Field | What to put | Why it matters |
|---|---|---|
| Profile name | The population, not the metric: Inbound Voice General, Digital Email and Chat, New Starters. | Agents read it as their team. |
| Description | What it measures and who it is for, in a sentence. | It is your only documentation inside the product. |
| Division | The division whose administrators will manage it. | It cannot be changed after creation; members can still come from any division. |
| Reporting intervals | Keep the defaults of 4 weeks and 13 weeks unless you have a reason. | Up to two intervals, the longest 90 days, 13 weeks or 3 months. |
| Leaderboard rank limit for agents | Enough for everyone who earns points to find themselves. | Minimum 3; supervisors see the top 300 regardless. |
| Activate profile | Only when metrics and members are both set. | See the warning below. |
2.7 Configure the metrics
The Metrics tab is available once the profile is saved, with the default profile's metrics and objectives available to include. For each metric you can create one that is specific to this profile (it does not sync with the default profile), copy one from the default profile (later changes to the default flow into the copy), or edit an existing one. Metrics cannot be copied from a custom profile into the default profile. Use Copy when several profiles share a definition; use Create when a team needs its own bands.
On the metric's Details tab set a display name in the language the floor already uses, the media types, the initial direction and direction (both, inbound or outbound) and the queues. Filtering is where precision comes from: one measure can become several fair metrics by queue. Whether a metric allows media type, direction or queue filtering is a property of its definition.
On the Objective tab choose the objective type (some metrics have a fixed type), the time unit and precision (up to five decimal places), the upper and lower limit of each zone, and the points for each zone, either a single value or a range. Enable the metric and save.
| Objective type | Use when | Typical example |
|---|---|---|
| Higher is better | More is better without limit; two zones for pass or fail, three zones to pay partial credit. | Answer rate, adherence, CSAT |
| Lower is better | Less is better without limit. | Non-productive time |
| Target area | There is a right value and both extremes are bad; five zones with out-of-bounds limits above and below. | Average handle time, after-call work |
| Punctuality | A fixed type for starting scheduled activities on time. | Punctuality |
2.8 Which metrics exist
Gamification includes predefined metrics, most of which you can customise; the metric type sets the unit, such as percent, seconds or number. Documented examples include average handle time, average after-call work, quality evaluation score, Detected Topics (the share of analysed interactions where the agent referred to chosen topics), punctuality and monthly attendance, plus any external metric you import.
The full list available to your organisation is data, not documentation. Read it from a profile's Metrics tab, or call GET /api/v2/gamification/metricdefinitions (permission gamification:profile:view), and record what you find, with the date, in your design document.
2.9 Add members
Add agents individually, or by queue, group or business unit. Adding by group is the maintainable option: individual adds turn every joiner, leaver and move into a manual task. Make your Genesys groups mirror your teams and add the group. Add new starters on their first working day: points are not generated for external metrics uploaded for dates before an agent joined the profile.
2.10 Decide auto-assignment on purpose
With auto-assignment on, Genesys assigns agents who are not in a custom profile to the default profile, moves agents removed from a custom profile there, and assigns new users to it. With it off, nobody is added to the default profile automatically and administrators manage its membership by hand.
Turn it on if the default profile is a sensible profile for everyone else, so nobody falls through. Turn it off if the default profile holds placeholder metrics, or every new user, including testers and supervisors, will start earning points against a scorecard nobody designed for them. Record the decision and review it after launch.
2.11 Test with a small group, then launch properly
- Run the profile for a week with a few volunteer agents.
- Check that the numbers agree with the analytics views supervisors already trust. If they disagree, you have a filter problem (media type, direction or queues); fix it before the whole floor sees the board.
- Flip a metric card on the agent scorecard: it shows the definition name, unit, precision, media type, initial direction and queues. That is how an agent checks you are measuring what you said.
- Launch in a team meeting: show a scorecard and a leaderboard, explain that points move down as well as up during the day, say which thresholds are provisional, and hand out a short guide to reading the scorecard.
2.12 Set up a contest (not in week one)
The contest wizard has five tabs. General sets the name and description, dates, winning criteria (highest total score, which adds up daily points, or highest overall percentage of the score, which measures progress towards the goal), the profile, an announcement date and ranking anonymisation: none, all participants except winners or the top three, or all participants. Metrics takes up to 10 metrics, each with a weight and a minimum qualifier, the points a contestant needs in that metric to be eligible to win. Participants lists everyone in the profile, with filters by manager or work team. Prizes takes up to three tiers with a number of winners each, a name, a description and an image. Then review and create.
Closing a contest is manual: a supervisor must complete every contest, and those waiting appear as Pending completion. Before completing, you can disqualify a participant (if a contest is already finished, their scores are set to zero) or override a tier, for example for a draw. Once completed with winners, results cannot be changed, even if the underlying metrics are later corrected. Completed contests stay visible for 96 hours before moving to the inactive list. Duplicate gives you a pre-filled form for a recurring contest.
- Choose percentage of the score for contests of a week or more: total score rewards days worked, while percentage of the goal puts a part-time agent on the same footing as a full-time one.
- Use minimum qualifiers as your anti-gaming control, so a handle-time contest cannot be won by someone whose quality has collapsed.
- Remove long-term absentees from participants when you create the contest: Genesys counts all participants in performance averages, including inactive users, unless they are removed manually.
- Give contest closure a named owner and a diary slot, because results are fixed once you complete it.
2.13 Bring in an external metric
External metrics let you put measures from other systems on the scorecard. Genesys's examples include third-party CSAT, daily sales, first contact resolution, leads generated, visits booked, retention rate, refund rate and NPS. There are three steps: configure the external metric definition (a name, a unit of seconds, percent, number or currency, a precision, a default objective type and a retention period in months); add and enable the metric in the profiles that use it; and upload the data through the gamification API. Test the feed with Genesys's external metric testing guidance before enabling it for the floor.
| Data uploaded for | Effect |
|---|---|
| The current workday | Reflected within a few seconds |
| Up to seven days in the past | Reflected within a few seconds (since July 2024; previously overnight) |
| A future date | Reflected early in the morning of that date, by the nightly job |
| More than seven days in the past | Not reflected |
03
Your operating rhythm
Gamification decays if nobody looks after it. This is the working week of an effective gamification lead; the cadences are QVCCS practice built on the documented views.
3.1 Every morning
- Open the Home view in supervisor mode from the View As list. Supervisor widgets include learning and coaching compliance, real-time adherence, contests and an insights summary.
- Look at the insights summary, which shows the three highest and three lowest performers. Both groups deserve a message, and the people doing well are the ones most often forgotten.
- Check any live contest's Participants tab, which shows eligibility and refreshes every 15 minutes.
- If someone had an excellent day, send a recognition now, while it is specific.
- Do not change a threshold on the strength of one day.
3.2 Weekly
- Review the profile trend in Scorecard Insights with a weekly interval, comparing this week with last. Percent of goal is an agent's accrued points divided by the points available in the period; sort by improvement to find the biggest movers in both directions.
- Look for the shape, not the winner. If the whole profile sits near the top, targets are too soft; if the bottom third sits far below, targets are unreachable or the metric measures something agents cannot control. Either way it is the design that needs fixing.
- Close and open contests in the same slot, so recognition arrives promptly, then duplicate the next one.
- Check members against joiners, leavers and anyone who has changed team, channel or working pattern.
- Have at least one coaching conversation started by gamification data. If you cannot, the metrics are not connected to anything you manage; go back to 2.1.
3.3 Monthly and quarterly
- Review the 4-week interval monthly and the 13-week interval quarterly; that is what the two intervals are for.
- Re-baseline zones against analytics using the method in 2.2. Publish any change, the reason and the date, and change no more than one or two thresholds a month; if everything needs moving, the design needs rethinking.
- For each enabled metric, name the coaching action a supervisor takes when an agent misses it. A metric with no action attached is noise; disable it, and delete metrics you will not use again, because disabled metrics still count towards the 50.
- Retire a contest people have stopped talking about.
- Report upwards on behaviour change, not points: movement in quality, adherence and handle time, and how many agents use their scorecard.
3.4 What agents see
From the Home view an agent sees their schedule, coaching appointments, evaluation summary, scorecard, modules, personal bests, contests, adherence and today's leaderboard. The scorecard summary shows the day's points, the all-time total, the agent's average for that day of the week and the average for everyone in the same profile, with daily points over the reporting interval and a dotted line for the average. The day-of-week average is a quiet help: it compares a Monday with Mondays, so nobody is discouraged by a day that is naturally harder.
| Mark | Meaning |
|---|---|
| Blue asterisk | Maximum points not yet reached for the day |
| Gold asterisk | Maximum points reached |
| Golden star on a metric | On target |
| Clear star on a metric | Not on target |
| Punctuality marks | A tick, a star or a cross show whether each activity started within the good or perfect range or outside it |
| Red dot on a day in monthly attendance | Evaluation scores and points are available for that day |
3.5 What supervisors see, and what they can do
Scorecard Insights compares each agent with their goals, with themselves over time and with their peer group, by profile, manager and a weekly or monthly comparison of periods. For each metric it shows percent of goal, leaderboard rank and average value, and View Objective shows where the agent sits against the objective. The Follow-up actions are the most useful thing on the screen: send recognition, create a coaching appointment, assign a module, or message the agent. Supervisors can also share a link or export (to CSV in US comma-separated format, or a printable view; export is available in a web browser, not the desktop app).
Gamification data should start the coaching conversation, never be the whole of it.
3.6 Recognition
Since June 2024, supervisors can send personalised recognition from the scorecard, Scorecard Insights or an agent's profile card. There are four types (Thank You, Congratulations, High Performance and Company Values), each with a personal message previewed before sending, and the agent sees a banner in their Home view. Since January 2026 an API lists past recognitions for organisations running a formal recognition programme.
3.7 Resetting personal bests
Over time agents reach personal bests that stop being useful targets. Performance administrators or supervisors can reset them by choosing a new start date on the Actions tab of the gamification settings, between 30 days in the past and 60 days in the future. Use natural boundaries, such as the start of a season, after a major metric change or the start of the financial year, and tell people you are doing it.
04
Designing a healthy gamification profile
This part decides whether gamification helps or becomes a people problem with a dashboard. The principles and methods here are QVCCS practice, built on how Genesys calculates points.
4.1 Twelve principles
- Every metric must be coachable. If missing it does not prompt a conversation, disable it.
- Weight with maximum points, deliberately. Agents read the point values as a statement of what you care about, and they are right to.
- Pair efficiency with quality, always. Never run handle time without a quality or CSAT metric in the same profile.
- Use target area for anything with a right range, such as handle time and after-call work.
- Keep the metric count low. Each metric dilutes the others and lengthens the explanation.
- Make Target reachable. If nobody earns the gold asterisk, it is decoration.
- Make the board readable in five seconds: plain names, one unit per metric, a consistent direction of better.
- Design for the people who are not in the top ten. They are most of your workforce and most of your attrition risk.
- Explain the movement: points go up and down during the day.
- Change thresholds in the open: what, why and from when.
- Contests are seasoning, not the meal. They should reinforce the standing profile, not reward something you discourage the rest of the month.
- Review the human impact as well as the numbers. Ask agents how the leaderboard makes them feel; if the answer is anxious or cynical, change the design, not the message.
4.2 The points budget method
Genesys sets no daily total, so set one yourself. A round daily maximum of 1,000 points makes every metric's ceiling a percentage of the whole, which is exactly the priority weight Genesys describes, and lets agents do the arithmetic in their heads. An illustrative inbound voice profile follows.
| Metric | Daily maximum points | Share of the scorecard |
|---|---|---|
| Quality evaluation score | 300 | 30% |
| Average handle time | 250 | 25% |
| Answer rate | 150 | 15% |
| Schedule adherence | 150 | 15% |
| Punctuality | 100 | 10% |
| Average after-call work | 50 | 5% |
| Total | 1,000 | All of it |
- Reading the top row tells everyone what the contact centre values; changing 300 to 150 changes the stated priorities without a memo, which is why such changes must be published and discussed.
- A day with no quality evaluation (evaluations are sampled) caps that agent at 700. Tell agents, or the person who happened not to be evaluated looks as if they underperformed; if evaluations are sparse, weight the metric lower.
- Weekly and interval maximums are simple multiples: five days at 1,000 is 5,000 a week. Five days totalling 3,967 points is 79.3% of goal, the same calculation Scorecard Insights uses.
4.3 Choosing metrics: a coverage test
A healthy profile covers four kinds of thing. Three metrics of the same kind over-weight one dimension and leave you blind in another.
| Dimension | Question it answers | Typical metrics |
|---|---|---|
| Quality | Was it done well? | Quality evaluation score, Detected Topics, external CSAT or NPS |
| Efficiency | Was time used sensibly? | Handle time (target area), after-call work, answer rate |
| Dependability | Can the team count on you? | Punctuality, adherence, attendance |
| Growth | Are you getting better? | Learning completion or coaching outcomes, brought in as external metrics |
4.4 Designing the zones
Three rules follow from points falling on a straight line between limits. Make the slope worth climbing: if good pays 100 and target 110, nobody changes behaviour for 10 points. Leave a gap between the out-of-bounds edge and the good edge, so an ordinary bad day does not collapse the score; the gap is where coaching happens. And work out what a mediocre day pays before you save. A target area example for handle time, in seconds, with a 350-point ceiling, follows.
| Zone limit | Value | Points |
|---|---|---|
| Out of bounds (upper) | 480 | None |
| Good (upper limit) | 360 | 250 |
| Target | 330 | 350 |
| Good (lower limit) | 300 | 250 |
| Out of bounds (lower) | 60 | None |
- An agent at 345 seconds, halfway between target and the upper good limit, earns about 300 points.
- An agent at 285 seconds, faster than target, earns about 234 points, not more. The fast but careless agent earns less than the agent on target; scored as lower is better, the same numbers would have taught everyone to rush.
- These figures are calculated by straight-line interpolation from the values above; check what Genesys shows in your own organisation before you publish a design.
4.5 Failure modes, and the setting that prevents each
| Failure | How it shows | What prevents it |
|---|---|---|
| Speed at the cost of service | Handle time improves; quality and CSAT fall | Target area on handle time, and a quality or CSAT metric with a higher ceiling |
| Cherry-picking | Easy interactions taken, hard ones avoided or transferred | Do not score raw counts alone; use rates, filtered by queue |
| Part-timers never visible | Part-time agents never appear near the top | Percentage of goal for contests; day-of-week averages; a separate profile if needed |
| New starters give up | New agents sit at the bottom from day one | A separate new starter profile with adjusted zones; reset personal bests on intake |
| The same names win everything | Everyone else stops looking | More winners per tier; short, frequent contests; anonymisation; percentage of goal |
| Averages dragged down | Team percentage of goal looks inexplicably low | Remove absent agents from contest participants |
| Gaming one contest metric | One metric spikes while others fall | Minimum qualifiers on the metrics you are protecting, and balanced weights |
| Thresholds feel arbitrary | Complaints that the goalposts moved | Baseline from analytics, publish the method, mark launch thresholds provisional, review openly |
| Metric pile-up | Scorecard too long to read; profile near 50 metrics | Quarterly review: disable what has no coaching action, delete what is finished |
| Nobody knows their score | Little leaderboard use; questions to supervisors | A rank limit that covers the team; the scorecard on Home; teach the card flip |
| Points seen as surveillance | Resentment; representatives raise concerns | Publish what is measured, involve representatives early, tight access control, anonymised contests |
4.6 Making it feel fair
Genesys gives you three real fairness levers. Separate profiles: agents are only ranked within their own profile. Contest anonymisation: running a contest anonymised except for the winners lets people chase a position without an audience, and if a contest is fully anonymised, winners are anonymised in the banner too. Several winners per tier: Gold, Silver and Bronze each take a number of winners, and many prizes engage a team far more than one.
And one non-setting: be careful with the data behind each metric. Points come from queue, schedule and quality data, so a wrong schedule means wrong adherence points. Genesys handles some cases, for example a resolved evaluation dispute updates the scorecard in real time, but checking a number against reality before repeating it is your habit to keep.
4.7 Fairness mechanics that work
- Report on percentage of goal, not raw points, in team reviews: it allows for the points available.
- Run short contests: a week is long enough to matter and short enough that everyone gets several chances a quarter.
- Rotate what contests emphasise, or the contest metric becomes the real scorecard.
- Give the bottom of the board a way up: a most improved award can be taken from the improvement sort in Scorecard Insights at no extra effort.
- Check the expected distribution before launch: if almost everyone sits close to target, results are decided by luck, so widen the zones.
4.8 What to say at launch
- Here are the things we measure and the points each is worth, because that is what we care about.
- Points update during the day and can go down as well as up; the end-of-day figure is what counts.
- The handle time target is a range, not a floor: being too fast scores less, not more.
- These thresholds are provisional for four weeks, and we will review them with you using real data.
- Nobody is disciplined by a leaderboard. It tells you where you are; your team leader helps you with what to do about it.
05
Worked examples
Each example uses the 1,000-point daily budget from 4.2. All zone values are illustrative, built with the method in 2.2: replace them with your own baseline before configuring anything, and confirm the metric names available in your organisation.
5.1 Inbound voice, general service
Profile Inbound Voice General, reporting intervals of 4 and 13 weeks, a leaderboard rank limit that covers the team, and auto-assignment on if the default profile is a sensible fallback.
| Metric | Objective type | Illustrative zones | Daily maximum |
|---|---|---|---|
| Quality evaluation score | Higher is better | Target 90% or more; good from 80% | 300 |
| Average handle time | Target area | Target 330 seconds; good 300 to 360; out of bounds below 60 or above 480 | 250 |
| Answer rate | Higher is better (three zones) | Target 0.98; good from 0.95; out of bounds below 0.92 | 150 |
| Schedule adherence | Higher is better (two zones) | Target 0.95 | 150 |
| Punctuality | Punctuality | Target 0.98; good from 0.95 | 150 |
- Quality carries the largest weight, which states that service comes first and stops handle time being gamed.
- Handle time is a target area with a lower out-of-bounds limit, so a rushed call earns nothing.
- Adherence is a simple two-zone pass or fail habit, so nobody games breaks for points.
- Punctuality uses Genesys's dedicated objective type and the scorecard's punctuality card.
5.2 Digital team: email, chat and messaging
A separate profile, because handle time on email and chat is a different quantity from voice.
| Metric | Objective type | Illustrative zones | Daily maximum |
|---|---|---|---|
| CSAT (external metric, percent) | Higher is better | Target 92%; good from 85%; out of bounds below 80% | 300 |
| Quality evaluation score | Higher is better | Target 90%; good from 80% | 200 |
| Average handle time | Target area | Target 540 seconds; good 420 to 660; out of bounds below 120 or above 840 | 200 |
| Answer rate | Higher is better | Target 0.98; good from 0.95; out of bounds below 0.92 | 200 |
| Punctuality | Punctuality | Target 0.98; good from 0.95 | 100 |
- CSAT leads, because on digital channels the customer's own view is the cleanest quality signal and balances handle time.
- Handle time bands are deliberately wide, because written work varies with the problem; the lower limit stops one-line replies.
- Remember the external metric rules in 2.13: the feed must arrive within seven days, and group averages are not supported.
5.3 New starters, first 12 weeks
Often the most valuable profile and the one most organisations never create: without it, new agents see a board they cannot win and disengage early.
| Metric | Objective type | Illustrative zones | Daily maximum |
|---|---|---|---|
| Quality evaluation score | Higher is better | Target 80%; good from 70% | 300 |
| Punctuality | Punctuality | Target 0.98; good from 0.95 | 200 |
| Attendance | Attendance | Present scores; absent does not | 200 |
| Average handle time | Target area (generous) | Wide bands, low penalty | 150 |
| Answer rate | Higher is better | Target 0.90; good from 0.85 | 150 |
- Dependability outweighs output, because it is what predicts success in the first months.
- Handle time is present but soft: a new agent racing an experienced agent's handle time learns bad habits.
- Quality is scored against a new starter standard, so Target is reachable.
- Plan the move into the main profile when you create this one, and reset personal bests on that date.
5.4 Retention and account management
Here a generic profile fails worst: it pays people to end conversations with the customers you most want to keep.
| Metric | Objective type | Illustrative zones | Daily maximum |
|---|---|---|---|
| Retention rate (external metric, percent) | Higher is better | Target 65%; good from 55%; out of bounds below 45% | 350 |
| Quality evaluation score | Higher is better | Target 90%; good from 80% | 250 |
| Average handle time | Target area (wide and high) | Target 900 seconds; good 480 to 1,200; out of bounds below 180 or above 1,800 | 250 |
| Punctuality | Punctuality | Target 0.98; good from 0.95 | 150 |
5.5 A one-week contest, end to end
Quality Week: best quality at sensible speed, for one week. Winning criteria: highest overall percentage of the score, so part-time agents can win. Profile: Inbound Voice General, so there is nothing new to learn. Announcement: immediately. Anonymisation: all participants except winners or the top three.
| Metric | Weight | Minimum qualifier |
|---|---|---|
| Quality evaluation score | 40 | At least one evaluation in the week |
| Average handle time | 30 | Good or better on at least three days |
| Answer rate | 30 | Good or better |
- Participants: the profile, filtered by manager to the teams that worked that week, with long-term absentees removed.
- Prizes: Gold for two winners, Silver for three, Bronze for five. Ten prizes across a team of 60 is a competition; one prize is a lottery.
- An illustrative scoring check, applying the weights to each agent's percentage of goal per metric: agent A at 92, 88 and 95% scores 0.92; agent B at 99, 60 and 70% scores 0.79; agent C at 85, 95 and 90% scores 0.90. B has the best quality and still comes third, because the weights do not let one metric win. Confirm how your organisation calculates contest scores before publishing an example like this.
- Close it the following Monday: review participants, override tiers for any tie, disqualify anyone who did not qualify, then complete, announce and duplicate for next month.
5.6 Bringing third-party CSAT into a scorecard
- Create an external metric definition, for example Post-interaction CSAT, unit percent, precision one, default objective higher is better, with a retention period matching your reporting.
- Add and enable it in the profile, with zones and points.
- Agree the feed with the integration team: daily, landing every morning, because data more than seven days old is not reflected and future-dated data appears overnight.
- Test the feed before enabling the metric for the floor.
- Tell agents the card depends on an external feed: a missing score is usually a feed problem, and the profile average is not shown for external metrics. Agree an alert for gaps and a published rule for missing days.
5.7 Team versus individual competition
Genesys gamification ranks individuals within a profile. The healthiest mix we have found is to score individuals and celebrate in teams: rank people on the leaderboard, but give recognition and contest prizes on team percentage of goal, taken from Scorecard Insights. Team rewards discourage individual heroics that damage service, and the contest participant filters by manager or work team make a team contest easy to set up. Genesys's employee performance use case describes competitions, badges and social elements as coming soon, so check current release notes before designing around team-level features.
06
Troubleshooting
| Symptom | Likely cause | What to check or do |
|---|---|---|
| Agents cannot see the scorecard or leaderboard | Gamification not enabled, permissions missing, not in a profile, or the wrong division | The Gamification toggle; Ui > AgentActivity > View and the scorecard and leaderboard permissions; profile membership; allow a few minutes for permission changes |
| An agent has no points | Not in any profile, joined after the day in question, or the metric is not enabled | Members tab; metric Enabled setting |
| Points went down during the day | Documented behaviour | Explain that the end-of-day figure is what counts |
| A metric is on the scorecard but not in Insights | Insights holds data up to yesterday | Check again tomorrow |
| Gamification does not match the analytics report | Different filters | Compare media types, direction and queues; flip the metric card; check the report's population |
| A team's contest average dropped | Participants who did not work count in averages | Remove them from the contest participants |
| An agent is missing from the leaderboard | They did not log in or earn points, or the rank limit is low | The leaderboard shows up to 300; raise the agent rank limit |
| A contest result is wrong | Not corrected before completion | Use Override tier or Disqualify before completing; completed results cannot change |
| Points stopped after a profile was deactivated | Deactivation removes members | Re-add them; pause by disabling metrics instead |
| Cannot change the default profile's name or division | By design | Use a custom profile |
| Cannot change a custom profile's division | By design | Create a new profile in the right division and move members |
| Run out of metric slots below 50 | Disabled metrics count | Delete metrics you no longer use |
| Leaderboards disappeared | Gamification was switched off | The leaderboards view is disabled when gamification is off |
| External CSAT did not appear | Upload older than seven days, missing feed, or agent not in the profile on that date | Feed logs; upload dates; membership history |
07
Reference: permissions, locations and API
7.1 Gamification permissions
| Permission | Notes |
|---|---|
| Gamification > Leaderboard > View, and View All | View All is division-aware |
| Gamification > Scorecard > View, and View All | View All is division-aware |
| Gamification > Profile > View, and Update | |
| Ui > AgentActivity > View | Optional |
| Permission | Needed for |
|---|---|
| Ui > AgentActivity > View | The Activity view |
| Gamification > Leaderboard > View | Leaderboards |
| Gamification > Scorecard > View | Scorecard |
| Workforce Management > Agent Schedule > View | Punctuality and the mini schedule |
| Coaching > Appointment > Participate | The coaching widget |
| Learning > Assignment > View | Learning modules |
| Quality > Evaluation > Edit Agent Sign-off | Evaluation widgets |
7.2 Where things are
| Task | Where |
|---|---|
| Enable gamification and set the start date | Admin > Performance & Engagement > Gamification Settings (Settings tab, General) |
| Auto-assignment and personal best reset | The same Settings screen |
| Profiles, metrics and members | Admin > Performance & Engagement > Gamification Profiles |
| Contests | Admin > Performance & Engagement > Gamification Contests |
| External metric definitions | Admin > Performance & Engagement > External Metric Definitions |
| Scorecard Insights | Menu > Performance Management > Scorecard Insights |
| Agent and supervisor Home view | Menu > Home, with View As for the supervisor view |
7.3 Useful gamification API endpoints
For administration at scale, reporting outside Genesys Cloud and configuration kept under change control. All are listed in Genesys's public API specification.
| Endpoint | Purpose |
|---|---|
| GET /api/v2/gamification/metricdefinitions | The metric definitions available to your organisation (needs gamification:profile:view) |
| GET /api/v2/gamification/templates | The objective templates behind the zone shapes |
| GET and POST /api/v2/gamification/profiles | List and create profiles |
| POST /api/v2/gamification/profiles/{profileId}/activate and /deactivate | Change a profile's state |
| /api/v2/gamification/profiles/{profileId}/members, and /members/validate | Read and assign members, and check an assignment first |
| /api/v2/gamification/profiles/{profileId}/metrics | Manage a profile's metrics |
| /api/v2/gamification/scorecards and /scorecards/points/... | Scorecard and points data |
| /api/v2/gamification/leaderboard and /leaderboard/all | Leaderboards |
| /api/v2/gamification/insights and /insights/rankings | Insights for external reporting |
| /api/v2/gamification/contests (create needs gamification:contest:add) | Contests, including / for an agent's view |
| GET and PUT /api/v2/gamification/status | Read and set gamification activation |
| GET /api/v2/employeeengagement/recognitions | Past recognitions |
7.4 Glossary
| Term | Meaning |
|---|---|
| Performance points | An intangible reward for achieving or progressing towards a goal; a metric's maximum points is also its weight |
| Profile | Metrics, objectives and members for a group with shared goals; one default plus up to 100 custom |
| Default profile | The fallback profile; cannot be renamed, deleted or moved to another division |
| Metric | One measure in a profile, with media type, direction and queue filters |
| Objective | The zones, limits and points for a metric |
| Zone | Out of bounds, good performance or target |
| Member | An agent measured by a profile; one profile at a time |
| Auto-assignment | Places agents without a custom profile in the default profile |
| Reporting interval | Up to two trend windows per profile; by default 4 and 13 weeks |
| Scorecard | The agent's own view of points, zones, attendance and punctuality |
| Leaderboard | Ranking within the agent's profile; up to 300 agents |
| Scorecard Insights | The supervisor's comparative view: percent of goal, rank, peer average, improvement |
| Contest | A time-limited competition on up to 10 weighted metrics with qualifiers and prize tiers |
| Qualifier | The minimum points in a metric needed to be eligible to win a contest |
| External metric | A measure imported through the API to appear on the scorecard |
| Personal best | An agent's best recorded performance, resettable from a chosen date |
| Recognition | A personalised supervisor-to-agent message of one of four types |
08
What the documentation does not say
Stated plainly, so nobody fills these gaps with guesswork. Test in a non-production organisation, or ask Genesys, and record the answer.
- The full list of metric definitions for every organisation. Read yours from the Metrics tab or the metric definitions API.
- Whether a metric's daily points can fall below zero. The documented points table pays nothing for out of bounds, but negative scores are not addressed.
- Where a reset of gamification points sits in the current interface. The employee performance use case says supervisors and administrators can reset points; the documented settings cover the start date and personal bests.
- Whether an individual agent can opt out of leaderboards. If you need this for health, disability or other protected reasons, raise it with Genesys and record the answer rather than assuming a setting exists.
- How long gamification points and scorecard history are kept.
- Any maximum daily points total or cap on a metric's points, which is why 4.2 recommends setting your own budget.
Questions
Common questions
How are gamification points calculated in Genesys Cloud?
Points calculate in real time as agents meet or exceed the thresholds set for each metric. Between zone limits they fall on a straight line, so an agent halfway between the good limit and the target earns roughly halfway between the two point values. Points are per workday and can rise or fall during the day; out of bounds pays nothing, and the target pays the metric's maximum.
How do I weight metrics in a gamification profile?
With maximum points. Genesys describes the maximum points on each metric as the way to give it a priority weight for a balanced scorecard; there is no separate weighting field. Setting a round daily budget, such as 1,000 points across the profile, makes each metric's share easy to read and explain.
How many gamification profiles can I have?
One default profile plus up to 100 custom profiles. Each profile can hold up to 50 metrics, including disabled ones, and up to 2,000 members, and an agent can belong to only one profile at a time. Create separate profiles where the work differs, such as voice and digital, new starters or retention, but avoid splitting so far that leaderboards hold only a few people.
Should handle time be scored as lower is better?
Usually not. Lower is better pays agents to end interactions early. A target area objective with out-of-bounds limits above and below pays most for the range where customers are served properly, and less for being too quick or too slow. Pair it with a quality or CSAT metric with a higher maximum, so speed never outweighs service.
Does gamification cost extra in Genesys Cloud?
It is part of employee performance, included in CX 3 and CX 4 and an add-on for CX 1 and CX 2. On the add-on, generating a gamification point for an agent is one of the documented billing triggers, so add agents to profiles only when you intend to measure and coach them. Confirm entitlement and costs with Genesys or your reseller.
Sources
- API default profile change for gamification metrics – Genesys Cloud Resource Centerhelp.genesys.cloud
- About gamification – Genesys Cloud Resource Centerhelp.genesys.cloud
- Activate gamification for your organization – Genesys Cloud Resource Centerhelp.genesys.cloud
- Add gamification user permissions – Genesys Cloud Resource Centerhelp.genesys.cloud
- Add Workforce Engagement Management to your subscription – Genesys Cloud Resource Centerhelp.genesys.cloud
- Scorecard insights overview – Genesys Cloud Resource Centerhelp.genesys.cloud
- Configure external metrics for performance scorecards – Genesys Cloud Resource Centerhelp.genesys.cloud
- Configure gamification profile details – Genesys Cloud Resource Centerhelp.genesys.cloud
- Configure gamification profile metrics – Genesys Cloud Resource Centerhelp.genesys.cloud
- Configure membership auto-assignment and reset personal bests – Genesys Cloud Resource Centerhelp.genesys.cloud
- Gamification contests – Genesys Cloud Resource Centerhelp.genesys.cloud
- Gamification overview – Genesys Cloud Resource Centerhelp.genesys.cloud
- Overview of gamification profiles – Genesys Cloud Resource Centerhelp.genesys.cloud
- Home overview – Genesys Cloud Resource Centerhelp.genesys.cloud
- Leaderboard overview – Genesys Cloud Resource Centerhelp.genesys.cloud
- Manage gamification profile memberships – Genesys Cloud Resource Centerhelp.genesys.cloud
- Agents Performance Detail view – Genesys Cloud Resource Centerhelp.genesys.cloud
- Schedule overview – Genesys Cloud Resource Centerhelp.genesys.cloud
- Scorecard overview – Genesys Cloud Resource Centerhelp.genesys.cloud
- Send recognition to an agent – Genesys Cloud Resource Centerhelp.genesys.cloud
- Test external gamification metrics – Genesys Cloud Resource Centerhelp.genesys.cloud
- How are performance points calculated? – Genesys Cloud Resource Centerhelp.genesys.cloud
- What are performance points? – Genesys Cloud Resource Centerhelp.genesys.cloud
- Why are my points decreasing during the workday? – Genesys Cloud Resource Centerhelp.genesys.cloud
- April 1, 2024 release notes – Genesys Cloud Resource Centerhelp.genesys.cloud
- April 20, 2026 release notes – Genesys Cloud Resource Centerhelp.genesys.cloud
- August 30, 2023 release notes – Genesys Cloud Resource Centerhelp.genesys.cloud
- January 19, 2026 release notes – Genesys Cloud Resource Centerhelp.genesys.cloud
- January 31, 2024 release notes – Genesys Cloud Resource Centerhelp.genesys.cloud
- July 29, 2024 release notes – Genesys Cloud Resource Centerhelp.genesys.cloud
- June 17, 2024 release notes – Genesys Cloud Resource Centerhelp.genesys.cloud
- March 31, 2025 release notes – Genesys Cloud Resource Centerhelp.genesys.cloud
- September 7, 2022 release notes – Genesys Cloud Resource Centerhelp.genesys.cloud
- Employee Performance – Genesys Cloud Resource Centerhelp.genesys.cloud
- Genesys Cloud CX pricing and plan comparison – Genesysgenesys.com
- API Explorer (gamification endpoints) – Genesys Cloud Developer Centerdeveloper.genesys.cloud
- Why your gamification strategy is going to fail – Call Centre Helpercallcentrehelper.com
- 10 steps to gamify your contact centre – Call Centre Helpercallcentrehelper.com
Keep reading
More guides
Genesys Cloud workforce management: the workforce planner's handbook
A detailed Genesys Cloud workforce management handbook for planners: set-up, forecasting, scheduling, time off, intraday, shrinkage and an operating procedure.
Read the guideGenesys Cloud speech and text analytics: the operating handbook
A detailed operating handbook for Genesys Cloud speech and text analytics: transcription, topic mining, topics, programs, categories, sentiment and governance.
Read the guideFailure demand in the contact centre: find it, measure it, remove it
What failure demand is, why it fills contact centre queues, and how to measure it, find its causes and remove it before automating anything. A leader's guide.
Read the guide