Admin How-To Guide

Authorize ChallengeRunner to Integrate with Teams

ChallengeRunner main page in Teams

Sixty percent of the Fortune 500 use Microsoft Teams to improve collaboration within their organizations. In the modern workplace, where employees are distributed throughout time zones around the world, it is common to have the Teams app open 24x7 on PCs and smartphones. As an always-on, work-related application, Teams provides ChallengeRunner with the opportunity to build onto their platform so that those using Microsoft Teams can easily use ChallengeRunner without switching context. In doing so, users can join challenges and teams, authorize trackers, view leaderboards, enter data, and more. The following steps are required to configure Teams integration:

How to authorize the ChallengeRunner app in Teams

  1. You must have already created a ChallengeRunner Commercial or Enterprise organization account before starting this process. Please see: New Organization to get started.
  2. If you have not already done so, create a Microsoft Teams account. Alternatively, you may use an existing Teams account.
  3. Open the Work or School Teams app.
  4. Create a Teams channel to handle challenge communications. You may use an existing Teams channel but may want an exclusive channel just for your wellness challenges.
  5. Click the Apps button in the lower left side of the Teams window and then search for ChallengeRunner.
  6. Click the ChallengeRunner tile and then click the Add button in the popup.
  7. Click Continue when a popup is presented asking for additional permissions.
  8. ChallengeRunner requires minimal permissions in order to automatically sign in participants. If you are an administrator, you can check the Consent on behalf of your organization checkbox to streamline the user acceptance process. Click the Accept button to accept the permissions.
  9. Sign into with your ChallengeRunner admin account.
  • The user page is the default in the Teams app. To create your first challenge as an admin, click the Switch to User View button. Then proceed to the Create A Fitness Challenge process.
  • Once the process is complete, you should see ChallengeRunner listed in the Teams navigation panel under More added apps.

How to enable Teams incoming webhooks in ChallengeRunner

  1. In Microsoft Teams, click the Teams icon in the navigation bar.
  2. Create a new or select an existing team and channel
  3. Click the ellipsis ... button next to the channel you would like to use for your challenges.
  4. Select Connectors from the context menu.
  5. Click the Add button next to the Incoming Webhook option. If nothing happens when using the desktop app, try the same process using the Teams website instead.
  6. In the Incoming Webhook popup, click the Add button and close the popup.
  7. Follow steps 3 and 4 and then click the Configure button next to the Incoming Webhook option.
  8. Enter a name for the webhook in the provided box and click the Create button.
  9. Click the Copy to Clipboard button next to the webhook Url, click the Done button, and close the popup.
  10. Log into ChallengeRunner with the admin Id used to link with Teams.
  11. Select the Webhooks option from under the Organization menu.
  12. Click the Add button.
  13. Enter a Webhook Name and Channel / Space Name to associate with this webhook. You may enter any names you like.
  14. Paste the webhook Url from step 9 into the Webhook Url box.
  15. Click Save.

How to enable challenge updates through Teams

  1. NOTE: This process requires incoming Teams webhooks using the section above.
  2. Log into ChallengeRunner with the admin Id used to link with Teams.
  3. If you have not already done so, create a challenge using the Create A Fitness Challenge process.
  4. Click the Edit Challenge button next to the challenge name.
  5. Select the desired team and channel from the Collaboration Channel drop down box.
  6. Choose either the Event Updates or Daily Leaderboards checkboxes.
  7. Click Save.

How to enable Teams automatic challenge enrollment

  1. Log into ChallengeRunner with the admin Id used to link with Teams.
  2. Select the Settings option from under the Organization menu.
  3. Click the No option next to Enable Group Page.
  4. Select option Automatically enroll members in available challenges during registration or login.
  5. Click Save.
<< Prev Next >>