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:

  1. Bot

  2. Tabs

  3. 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:

  1. Teams Conversation Id - Eloops uses it to send notifications from the Microsoft API as Proactive Messages

  2. Teams aadObjectId - Eloops uses this token for the Messaging Extension

  3. Teams TenantId

  4. 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.

  1. A user tap the Sign-in button. The Teams app requests an Authorization URL from the bot framework.

  2. The Bot Framework returns a URL and the Authorization popup with Eloops shows

  3. The user authenticates himself using the Eloops Sign-in page and returns an authentication code to the bot framework, via the return URL (3a).

  4. The Bot Framework sends an access token request, with the authorization code, to the Eloops' Authorization Server.

  5. 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.

  6. Once the Bot framework receives those tokens back, it fires a callback on the Teams app. The app closes the auth popup and

  7. The Teams app takes all the data needed (4 tokens above) and subscribes to the user.

  8. 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:

  1. Eloops credentials

  2. 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.

Did this answer your question?