September 2024 Release
Production Release Date: September 25
REST APIs
The following API changes are documented on https://api.bunchball.com/docs.
-
/challenges and /challenges/{challengeId} - Updated to include two new parameters in the response:
-
featuredStartTime - Returns the time when a mission becomes featured.
-
featuredEndTime - Returns the time when a mission is no longer featured.
-
-
GET /users/{userId}/challenges - Updated to optionally return a list of the labels mapped to the mission. Only default type labels are returned.
Product Updates
User Level Earned Webhook
You can now create a webhook for user level change events. An events notification will be sent to the webhook's URL when a user's level changes. The event data includes user and level information and if the user's level change was a level up or down. See Webhooks for configuration and validation details.
Example of the body of a level earned event post call
{
"eventId": "<uuid - unique identifier assigned to the event>",
"context": {
"siteId": <siteId>,
"apiKey": "<apiKey>",
"ics": "<ics>"
},
"eventType": "USER_LEVEL_EARNED",
"data": {
"user": {
"id": <uuid - unique identifier assigned to the user>,
"userId": "<gamification userId>",
"firstName": "<user's firstName>",
"lastName": "<user's lastName>"
},
"level": {
"id": <levelId>,
"name": "<level name>",
"iconUrl": "<level image URL>",
"description": "<level description>"
},
"userLevelHistoryId": <userLevelHistoryId>,
"actionPhrase": "<level action phrase>",
"timestamp": <unix timestamp - the time when the level change occurred>,
"direction": "<UP or DOWN - indicates if the user's level increased or decreased"
}
}Mission Search and Filters in Nitro Impact BETA Release
Mission search and filters are now available for beta testing! In Nitro Impact, you can filter the All Missions view by missions that are in progress, expiring soon, or contain your search term in the mission name.
This feature allows users to quickly find the missions that they want to make progress on or complete. Contact Bunchball Support if you're interested in beta testing search and filters.
Product Fixes
-
Fixed an issue in Impact where a user with no value set in the userPhotoUrl user preference showed a broken image in the leaderboard. If no value exists in the preference, the user's initials or a default image is shown.
-
Fixed an issue in Impact where you could not close the side panel using the Esc button.
See also