Guide Index
Guides HomeMangoApps WebsiteCommunity & SupportBlog & Resources
MangoApps Integrations Guide
MangoApps Integrations Guide
  • 🥭Integrations
  • 🌐Analytics
    • Google Analytics
    • Integration with Tableau
  • 🌐Digital Signage
    • Digital Signage Integrations
    • Integration with Appspace
    • Integration with Monitors AnyWhere
    • Integration with Rise Vision
    • Integration with ScreenCloud
    • Integration with Yodeck
  • 🌐Events
    • Event Integration with Zoom
  • 🌐File Storage and Sharing
    • Integration with Adobe Experience Manager (AEM)
    • Integration with Box
      • Box as the File Storage
      • Box as External Document Repository
    • Integration with Dropbox
    • Integration with Google Drive
    • Integration with NetSuite
    • Integration with SharePoint
      • SharePoint Files and Federated Search
      • SharePoint Widget
  • 🌐HRIS Partner Integrations
    • Paylocity Integration
  • 🌐Single Sign-On
    • Single Sign-On Integrations
    • Integration with ADP Workforce Now
    • Active Directory Federation Services
    • Active Directory/LDAP
    • Google Cloud Identity
    • SAML
    • Office 365 OAuth 2.0
    • SCIM Setup for OneLogin
    • Integration with Google Enterprise using OAUTH 2.0
    • Integration with Okta SCIM
    • SCIM Setup for Microsoft Entra ID
  • 🌐Shifts & Schedules
    • Integration with Kronos
    • 🆕Integration with PDI Workforce
  • 🌐Widgets
    • Integration with MS Stream
    • Integration with Tagbox
  • 🌐Workspace
    • Integration with AirBrake
    • Integration with Freshdesk
    • Integration with GitHub
    • Integration with Huddle
    • Integration with JIRA
    • Integration with Microsoft Clarity
    • Integration into Microsoft Teams
    • Integration with OC Tanner
    • Integration with Pingdom
    • Integration with Power BI
    • Integration with Salesforce
    • Integration with Slack
      • Integration with Slack for Channel Notifications
    • Integration with Zendesk
  • 🌐ADDITIONAL RESOURCES
    • Submit a Support Ticket
    • Release Notes
Powered by GitBook
On this page
  • Overview
  • OC Tanner Integration Setup
  • MangoApps Integration Setup
  • Tracker Widget Setup
  • Security Considerations
  1. Workspace

Integration with OC Tanner

PreviousIntegration into Microsoft TeamsNextIntegration with Pingdom

Last updated 8 months ago

Overview

OC Tanner is a rewards and recognition platform utilized by organizations to acknowledge and reward their employees. This guide provides comprehensive instructions on setting up this integration for efficient utilization within your MangoApps domain.


OC Tanner Integration Setup

Step 1: Set Authorization

  1. Gather the following details from the client side:

    • API URL

    • Client Key

    • Client Secret Code

  2. Encode the Client Key and Client Secret Code to create a "Base 64 Authorization Token".

    • Use a tool like for encoding.

    • Enter the client key followed by the client secret key separated by a colon (:).


Step 2: Establish Connection and Access Token Creation

Using any third-party API tool (for the purpose of this walkthrough, we will be using PostMan), first generate the authorization token using the Post Method, followed by the GET method to receive the event details.

  1. Add a new parameter in the Header section:

    • Key: Authorization

    • Value: Basic followed by the Base64 encoded value generated in Step 1. Example: Basic<space>Base64_encoded_value

  2. Switch to the Body tab and add a new key as grant_type with the value client_credentials.

  1. Click on Send and copy the generated access_token value from the Response field.


Step 3: Retrieve Events

  1. Add the access_token generated in Step 2 as a header:

    • Key: Authorization

    • Value: Bearer followed by the “access_token” copied from Step 2. Example: Bearer<space>access token

  1. Click Send to receive all available rewards/recognition events from OC Tanner.


MangoApps Integration Setup

To set up the integration in MangoApps, create a tracker and proceed through the Data Source, Column Mapping, and Schedule Settings steps.

Step 1: Tracker Creation

  1. Create a new tracker in MangoApps and add relevant columns.

  2. From the Tracker Tools dropdown menu, select Data Uploader.

  1. Select Upload or Add Sources from the pop-up menu and add the following details:

Data Source: HTTPS

Authorization Type: Token Based

Header:

  • Key: Authorization

  • Value: Output of Step 1

Body:

  • Key: grant_type

  • Value: client_credentials

Data entry will appear similar to this:

  1. Click Test Connection to verify successful access.


Step 2: Column Mapping

Map the columns in the tracker with the input columns from the OC Tanner data. Ensure alignment between manually added columns and data from OC Tanner.

To show names and user profile images, users must exist within your MangoApps domain.

By default, OC Tanner refers to Employee ID as a user identifier.


Step 3: Schedule Settings

In this section, you can define the synchronization cycle between OC Tanner and MangoApps. This ensures that data is updated at regular intervals, maintains accuracy, and keeps consistency across platforms. Additionally, this section includes the option to enable or disable schedule activation, providing flexibility in managing when synchronization occurs, allowing users to optimize resource usage and minimize disruptions during critical operations.

Save the configuration or click on the Save & Fetch Now to retrieve the results immediately.


Tracker Widget Setup

By creating a tracker widget, users are able to convert the tracker table view into an easily accessed graphical view. from the Tools dropdown menu in the newly created tracker, click Add Table to Widget Gallery. By doing this, the tracker table will now be available in the widget gallery for further configuration.


Formatting the Tracker Widget

Navigate to the Widget Gallery and select the created Tracker widget.

By default the widget will display the data in tabular form, this view can be converted to a different style as per your requirements.

From the Customize View window, choose the view type of List & Details and map the list options to an appropriate field of your choice.

From the Detail View, you can upload a banner image of your choice. This image will be displayed for all rewards uploaded via this tracker.

Save the widget settings to display rewards data.


Click on each reward to view a pop-up menu with complete details. Use the slider option to navigate through the rewards at your leisure.


Security Considerations

Authentication is done using the ClientKey and the Secret provided by OC Tanner (client side), although the API URL is global, these keys are unique to the client site so only the data specific to these ClientKey and Secret combination can be fetched. Any failures will be recorded in the Data Uploader logs and additional information related to failures can be fetched from server logs.

Generate the authorization token using the POST method with the API URL: .

Using the GET Method in PostMan, we will access the GET Events via the URL: .

Data URL:

Auth Token URL:

🌐
https://api.octanner.io/v1/oauth2/token
https://api.octanner.io/events/v1/client/events
https://api.octanner.io/events/v1/client/events
https://api.octanner.io/v1/oauth2/token
https://www.base64encode.org/