Admin How-To Guide

Authorize ChallengeRunner to Integrate with Webex

ChallengeRunner main page in Webex

Webex is a pioneer and leader in the online meeting and collaboration space. In the modern workplace, where employees are distributed throughout time zones around the world, it is common to have the Webex app open 24x7 on PCs and smartphones. As an always-on, work-related application, Webex provides ChallengeRunner with the opportunity to build onto their platform so that those using Cisco Webex 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 Webex integration:

How to authorize the ChallengeRunner app in Webex

  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 Cisco Webex account. Alternatively, you may use an existing Webex account.
  3. Open the Webex desktop app and click the Messaging icon.
  4. Create a Webex space to handle challenge communications. You may use an existing space but may want an exclusive channel just for your wellness challenges.
  5. Click on the space name.
  6. Click the +App button in the top navigation of the space window and then search for ChallengeRunner.
  7. Click the ChallengeRunner tile and then click the Add to Tab button in the popup.
  8. Sign in 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 Webex space top panel.

How to enable Webex incoming webhooks in ChallengeRunner

  1. Open the Webex application.
  2. In the lower left corner of the window, click the Apps icon. This action opens the Cisco Webex App Hub in a new tab of your preferred browser.
  3. Use the search bar to find Incoming Webhooks.
  4. Select Connect. This action opens an OAuth Authorization to allow the application in a new tab.
  5. Select Accept. The tab automatically redirects to the application's configuration page.
  6. Configure the following:
    • Webhook name - Provide a name to identify the messages provided by this application.
    • Select a space - Use the drop-down menu to choose a Space. The Space must already exist in Webex team. If a space does not exist, you can create a new space in Webex Teams and refresh the application's configuration page to display the new space.
  7. Select Add. The Webex Space you chose will receive a notification that the application is added.
  8. Copy the Webhook URL.
  9. Log into ChallengeRunner with the admin Id used to link with Webex.
  10. Select the Webhooks option from under the Organization menu.
  11. Click the Add button.
  12. Enter a Webhook Name and Channel / Space Name to associate with this webhook. You may enter any names you like.
  13. Paste the webhook URL from step 8 into the Webhook Url box.
  14. Click Save.

How to enable challenge updates through Webex

  1. NOTE: This process requires incoming Webex webhooks using the section above.
  2. Log into ChallengeRunner with the admin Id used to link with Webex.
  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 name and space from the Collaboration Channel drop down box.
  6. Choose either the Event Updates or Daily Leaderboards checkboxes.
  7. Click Save.

How to enable Webex automatic challenge enrollment

  1. Log into ChallengeRunner with the admin Id used to link with Webex.
  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 >>