Introduction
A Microsoft Teams integration allows users to receive program notifications and execute many program activities within their Teams desktop or mobile display, without logging directly onto the Chronus platform. If integration is desired, your Chronus CS contact will connect you with an appointed Support Specialist to walk you through the integration process.
Why it matters: For participants who actively use Teams, the integration offers seamless and efficient access to the mentoring and ERG platform. Users can easily manage ERG event invitations, updates, mentoring requests, meetings, surveys and more—all directly within the Teams application. This integration promotes faster responses and enhances user satisfaction with its ease of use.
The following article does not include the Team's video integration or the end-user experience. For this information, please see:
Prerequisites
Active Chronus & Microsoft Teams Enterprise account
Users in Chronus must be members of the organization's enterprise account with same email address
Installing Chronus on MS Teams
There are two approaches to installing the Chronus App on the MS Teams application. Your organization's Microsoft Teams Admin will need to log onto their Teams account and proceed with one of the following approaches.
Option 1: Make app available on the organization's Teams Marketplace
Allow the availability of the Chronus app on the organization's Teams Marketplace so that a user can install it on their Teams window.
Option 2: Enable the default installation of the Chronus app for all or a subset of users
Step 1: From your Teams left main menu, click on 'Teams apps' dropdown and select 'Setup policies.'
Step 2: On the 'App setup policies' page, select 'Global/org-wide default.'
Step 3: In the 'Installed Apps' section, click the 'Add apps' button.
Step 4: Search for the Chronus App on the right panel to add it, then click 'Add' again at the bottom of the page. The Chronus app should now appear in the 'Pinned apps' section.
Here is a quick video on how to install the Chronus app for Microsoft Teams - Click Here
With both approaches, once the app is installed a request will be sent to Chronus server with the necessary information. Chronus uses OAuth 2.0 client credentials grant flow to get an access token with Microsoft login service along with the user information received during installation to send notifications proactively. The user does not need to provide any OAuth permissions explicitly.
Please Note: Once integration is complete, the Chronus chatbot will send out a welcome notification to all the users in the policy.
Architecture Diagram
OAuth Permission Scope
Chronus doesn’t require any explicit permissions to send notifications except for the permission obtained while installing the Chronus App.
Data Access
Chronus will only have permission to view the following information from the MS Teams accounts that Chronus is connected to:
Name, email addresses of people (to identify the right user for message posting)
Message content that Chronus has posted to users
Post-Integration Workflow
Chronus uses the Bot Connector Service to send and receive messages within MS Teams. The Bot Connector service enables the Chronus App to exchange messages with MS Teams by using industry-standard REST and JSON over HTTPS. With the Chronus integration, users can receive and respond to notifications about their mentoring programs and ERG event updates directly in their MS Teams account.
Overview of User Functions
With a Teams integration, users have access to the following activities within their Teams window without having to log onto the Chronus platform:
Receive notifications about ERG and mentoring program updates and activity
Respond to mentoring requests and notify users if an event is canceled.
Communicate with their mentoring partner and ERG members
Users can also connect and disconnect the Chronus application by entering the commands that Chronus supports.
FAQ’s
Will end users need to authorize their MS Teams account?
No. Depending on the integration approach the admin selects, the user will either have the app immediately available within Teams, or will take a few simple steps to install it from their organization's Teams Marketplace. Once installed notifications will be sent regardless of whether the user is logged in to Chronus or not.
How does Chronus map the users between the Customer’s Chronus account & the MS Teams account?
Chronus uses the emails of the users to map between the Customer’s Chronus & MS Teams accounts. Users receiving notifications inside MS Teams from Chronus should be using their MS Teams email in their Chronus account.
Can I extend capabilities to only one/a selected list of programs in my organization?
No. Once integrated, Chronus for MS Teams will be available for all the programs in your organization.
Will Chronus have access to messages in other channels/personal messages between users in the teams app ?
No. Chronus will only have access to the personal bot channel it creates to send notifications.
Can I remove MS Teams access to Chronus?
The Chronus integration with MS Teams can be disabled by Administrator.
Contact Information
For any issues or troubleshooting, click the question mark in the lower-right corner of your screen when logged in as an admin to send us an email. While this is not a live chat feature, the Chronus customer support desk is available 24/5 from Monday to Friday and typically responds within a few hours or less.