Since we launched Discourse Gamification a year ago, one of the most requested features from our roadmap has been the ability to make it possible to integrate Discourse Gamification with external gamification system . Examples are plenty:
Integrate with existing gamification programs in companies
ability to award points for events that happen outside of Discourse, like IRL events, or elsewhere online, like being a customer in a community, or buying a product.
the ability to allow users to redeem their points for swag, products or benefits
Today, just in time for the plugin’s first anniversary, we made all of the above possible with a full API to handle custom scoring events .
This new system allows admins to:
Award users a custom score event
Award users with negative score events, to accommodate redeem or penalties events
Update and list custom events previously created
API
Points awarded via API will take up to 10 minutes to reflect on a user overall score for events created with the current date, and up to 24h for events created in the last 10 days. For events created with a date past the last 10 days you need to run the backfill rake task.
This is incredible. We’re just in the middle of starting and piloting an ambassador/champions program, and we’ve been using Airtable to monitor webhooks from our different sources (Discourse, GitHub, Ghost) and aggregate our champions program there. I’m excited to check this out and see if it could be used for us to manage/monitor our program and contributions.
It would be great if you could award points to a user group instead of a user. The use case for us as an enterprise customer would be that we essentially want to award points to the company the users work for and aggregate their points for each company. What is the feasibility of something like this?
How does redeeming points work? I see there is an update event that could be used to subtract points from individual events, but that seems like an inefficient way to redeem points.
It may be my decade of experience working at banks, but the way I envision redeeming points is issuing negative value custom events.
For example, let’s say you have a user who wants to redeem points for a T-Shirt, and that T-Shirt costs 10k points. The flow on your redeeming system would be:
You will want to wrap this in a semaphore of some sorts, as this is the text book example of using those, but that is the gist of the proposed workflow.
This is a very recent feature, so let me know if the proposed workflow doesn’t work correctly.
It’s working fine for me, both in the browser and via API. It’s an admin endpoint, so you need to be a logged in admin via browser, or pass API keys like explained in the OP.
Are there any plans to add scopes to this API? It appears that the only way I can create or update scores is by having an admin API key that has global access. I would love to have a scope that restricts a key to just being able to update scores. This would give me more confidence using this API in automation tools as I wouldn’t have an admin key that can do much more than just update scores.
I’ve been testing this a bit today. I see the events I can track, though unsure if there is a direct query to view only events by userid. Looking for a way to maybe have an audit log or present to users how they have gained/lost points.
Awesome! And I have another suggestion, is it possible to add a feature that enable users to redeem points for subscriptions in the ui interface? And the ability to add a limit to the number of points a user can earn per day on an event ( like create topics).
.Points awarded via API will take up to 10 minutes to reflect on a user overall score for events created with the current date, and up to 24h for events created in the last 10 days. For events created with a date past the last 10 days you need to run the backfill rake task.
I was using expired credentials. Thanks for confirming anyway.