The Eloops integration with Microsoft Teams allows you to send peer 2 peer coins, pick & purchase rewards from the Store, view your Wallet, engage with content and activate Loopo the Bot, all within MS Teams. By adding the Eloops app to your Teams you get fast & easy access to the main features of the app and engage with your team seamlessly.
Is this article for me?
This article is technical, it should help you as an IT/Technical Engineer to integrate Eloops into your organization. Not technical? Share this article with your technical team to enhance your Eloops' experience.
Prerequisites
A. Microsoft Teams subscription
B. Eloops subscription
Architecture/How it Works
Eloops' app for Teams uses Teams' app to provide the most engaging experience without leaving the Teams app.
The Eloops' app uses three of the following Teams features:
Bot
Tabs
Messaging extension
The Tabs and Messaging extension uses teams only as a container the authentication is the same as on the Eloops Dashboard on the web. Using the Eloops' bot requires data from Teams to be able to send notifications between Eloops' Server and Teams. The only data being transfer is:
Teams Conversation Id - Eloops uses it to send notifications from the Microsoft API as Proactive Messages
Teams aadObjectId - Eloops uses this token for the Messaging Extension
Teams TenantId
Teams User Id - This id is provided by the Teams' activity context. Enabling Eloops to identify the user
Eloops uses a pre-registered OAuth Connection with Teams that uses the bot framework to authenticate with Eloops. This is done under the Bot Channel Registration on Azure.
A user tap the Sign-in button. The Teams app requests an Authorization URL from the bot framework.
The Bot Framework returns a URL and the Authorization popup with Eloops shows
The user authenticates himself using the Eloops Sign-in page and returns an authentication code to the bot framework, via the return URL (3a).
The Bot Framework sends an access token request, with the authorization code, to the Eloops' Authorization Server.
The Eloops' Authorization Server exchanges the authorization code for an OAuth access token and a refresh token, then send those tokens back to the Bot framework.
Once the Bot framework receives those tokens back, it fires a callback on the Teams app. The app closes the auth popup and
The Teams app takes all the data needed (4 tokens above) and subscribes to the user.
The Eloops' Server validates the token and returns a successful response.
* All other requests use the access token as part of their requests to Eloops' server
* On step 2 there are two possibilities to sign-in to Eloops:
Eloops credentials
Microsoft SSO
Eloops Dashboard Setup
Enable Microsoft Teams on Eloops Apps Marketplace to enable messages delivery directly from Eloops' dashboard.
Contact us for more info.
Teams Admin Center Setup
Making Eloops' app available to your organization on Microsoft Teams is easy, you may make the available globally to everyone. Visit Microsoft Admin Center, to start setting up the app:
A. On the left menu tap Teams Apps -> Setup policies button.
B. Under the Installed apps - tap Add apps and insert 'Eloops' in the search bar. Then tap the Add button:
C. Under the Pinned apps - tap Add apps and insert 'Eloops' in the search bar. Then tap the Add button:
D. Tap the Manage users button and add everyone:
E. Tap the Apply button
Note: It may take up to 30 minutes to update
Next Step
Every user trying to connect will see a login button with the Microsoft SSO button as well. Explore our SSO Integration documentation, enhancing your security and access control. Please contact us for more information.