Rewarding activity in other systems

You can award users badges for completing activity in other systems that are reachable by URL from your community. For example, you might want to award a badge when a user completes their annual security training in your security application.

Remote badging relies on a custom event (eventId) that tracks activity in the remote system. Completing a custom event can be done manually (by clicking a link in the quest interface), by visiting a specified URL, or automatically by a callback from the remote system when the user completes a task there. The callback from the remote system is then specified as a POST request in Jive.

To set up rewarding activities in other systems:

  1. Go to the Rewards Console.
  2. Mark the custom event as completed by sending a POST request to the following URL:
    POST http://rewards.jivesoftware.com/api/tenants/{tenantId}/events/{eventId}/complete/users/{userId}

    The userId here is the user email address. Replace {userId} with the email of the user to reward. The request's body should contain the data provided in Step 3.

    Note: The tenantId, the eventId (custom event), and the secret will be provided when the quest is created.
  3. The JS will look like this:
    jQuery.ajax( {
        url: 'http://rewards.jivesoftware.com/api/tenants/' + tenantId + '/events/' + eventId +'/complete/users/' + userId,
        type: 'POST',
        data: secret,
        success: function( response ) {
            // response
        }
    } );