Hey guys, I am the new gamification admin and I am trying to build a cool dashboard for our break room. I want to show the current leaderboard for our sales team in real-time. I have been looking through the docs but I am not sure which API to hit to get the live scores. I see the historical metrics but nothing that looks like a live feed. Any pointers?
Greetings. I am currently managing the data architecture for a large scale migration where we require similar real-time visibility. You must utilize the /api/v2/gamification/leaderboards endpoint.
However, please be advised that the ‘real-time’ nature of this data is subject to an aggregation delay of approximately fifteen minutes. The platform does not currently offer a WebSocket notification topic for individual gamification score updates.
Hello. It is wonderful that you are building an engagement dashboard for your agents! To supplement the information provided by the previous poster, I recommend that you also look at the ‘Performance Profile’ filters within that API. You can specify the exact timeframe and the specific metrics you wish to display.
If you want a more immediate feel, you might consider combining the leaderboard data with real-time routing metrics from the /api/v2/analytics/queues/observations/query endpoint to show currently active winners!
To ensure optimal performance of your dashboard, you should implement an efficient polling strategy. The gamification API has strict rate limits compared to the standard analytics endpoints. I suggest caching the leaderboard results on your local server and only refreshing the data every five to ten minutes.
This will prevent your dashboard from being blocked by the platform security throttles while still providing an engaging experience for the staff.