Skip to main content

​
Overview

The Empuls integration with Microsoft Teams connects everyday collaboration with your organisation’s engagement, recognition, and feedback workflows. Employees can recognize teammates, redeem rewards, complete surveys, and view insights - all from within Teams, without switching tools. For administrators, Empuls can be deployed org-wide through the Microsoft Teams admin center, with controls to publish events, manage permissions, and customize how the app appears across Teams. ​Quick Links: • Click here to add Empuls to your Microsoft Teams account

​
1. Installation & Setup (For IT Administrators)

This section guides Admins through installing the Empuls app on Microsoft Teams for their organization through the Microsoft Teams admin center. **1.1. Install Empuls for All Employees ** Use this to give every user access to Empuls in their personal Teams space. Steps:
Microsoft Teams It Admin 1
  • Go to Setup Policies.
Microsoft Teams It Admin 2
  • Select Global (Org-wide default).
  • Under Installed Apps, click Add Apps and add Empuls.
Microsoft Teams It Admin 3
  • Under Pinned Apps, click Add Apps to pin Empuls in the Teams app bar and messaging extensions.
  • Scroll and Save.
Voila! Empuls is now available for all users. 1.2 Install Empuls on Teams Channels (Add to Team / Add to Chat) With the Empuls app added as a message extension on all your MS Teams channels, you may install it on all or a few select channels from their admin console.
Microsoft Teams It Admin 4
  • Select Add to Teams.
  • Choose the required channels and Save.
1.3 Permissions Required 1.3.1. Mandatory SSO Permissions Empuls Team’s app requires SSO-related permissions to access the Home tab.
Microsoft Teams It Admin 5
Following permissions/ scopes must be granted with the admin’s consent to allow the users to access the Empuls Teams app seamlessly via SSO. Empuls requires these scopes to enable automatic sign-in and access basic user details:
  • User.Read
  • email
  • openid
  • profile
  • offline_access
How to grant admin consent User.Read, email, openid, profile, and offline_access Go to Permissions > Grant admin consent for 4k8cjq as shown in the screenshot below:
Microsoft Teams It Admin 6
1.3.2 Optional Permission for Profile Picture Sync To sync Teams profile photos to Empuls automatically, approve the following scope:
  • User.Read.All
Microsoft Teams It Admin 7
💡 Recommended: This scope is optional and required only if the admin wants to automatically sync the MS Teams profile pictures of users with the Empuls application instead of having the users manually add them. All Done! Empuls app is now added to all employees and channels.

​
FAQs

You’ll not be able to find the Empuls App if your Microsoft Teams Admin has blocked users from accessing public (Third-party) apps from the store. Please ask your Admin to enable Empuls on the Microsoft Teams app store. Refer to the Installation guide for more information.
You can uninstall the app from a channel by navigating the Apps section from the Manage Team option.
You can uninstall the Empuls bot from your account by following these steps:
  • Navigate to the chat section.
  • Hover on the Empuls app.
  • Right-click on the app and select Uninstall.
Microsoft Teams It Admin 8
This page appears if the Microsoft Admins at your organization have added controls to prevent users from installing or using apps on Microsoft Store.
In the input box, Enter your reason for using the Empuls app and click on **Request Approval. **This will submit your request to your Microsoft Admin.B) Your Microsoft Admin can see your request in the Azure portal under the Enterprise applications section. (URL:https://portal.azure.com/#view/Microsoft_AAD_IAM/StartboardApplicationsMenuBlade//AppAppsPreview/menuId/null)Make sure to nudge your Microsoft Admin, as your request may get lost among the plethora of similar requests.C) The Microsoft Admin can allow the Empuls app to enable all users to sign in without any additional permissions from the administrators. Sample image below:
Microsoft Teams It Admin 9
Once completed, all users can log in and start using the Empuls app.
Empuls app on Microsoft Teams will have permission to:
  • Receive messages and data that I provide to it: This permission allows users to interact with the Empuls bot (Em Bot).
  • Send me messages and notifications: This permission allows Em bot to send notifications to users when the bot is installed.
  • Access my profile information such as my name, email address, company name, and preferred language: This permission allows the Empuls app to identify the user and share relevant information with him.
  • Receive messages and data that team or chat members provide to it in a channel or chat: This permission allows users to interact with the Empuls bot using tagging Empuls in the conversation.
  • Send messages and notifications in a channel or chat: This permission allows the Empuls app to share appreciation messages on the channel and group chats.
  • Access information from this team or chat such as team or chat name, channel list, and roster (including team or chat member’s names and email addresses) - and use this to contact them: This permission is a prerequisite of the previous permission. Empuls app needs to know the channels and group chats the user is part of to allow users to share appreciation messages there.
  • Empuls uses Microsoft Graph API to authenticate users when they open the Personal Empuls Home tab. We get user’s basic details, like email, to validate the user. Admin can grant these permissions to provide hassle-free access for the end users.
Scopes: User.Read email openid profile offline_access
  • Empuls also uses another scope User.Read.All. This is required only if the admin wants to automatically sync MS Teams profile pictures of users with Empuls, instead of having users add them manually.