Click here to add the Empuls app to your Microsoft Teams account.
Installation Guide
For Microsoft Teams / IT Administrators
This section guides Admins through installing the Empuls app on Microsoft Teams for their organisation through the Microsoft Teams admin center.
Permissions for Installations
User.Read: Allows users to sign-in to the app, and the app to read the profile of signed-in users. It allows the app to read basic company information of signed-in users.
OpenID: Allows users to sign-in to the app with their work or school accounts and allows it to see basic user profile information.
Adding Empuls app to Teams
Empuls app can be installed as a 1:1 chatbot for all employees (Referred to as Add to me) and as a bot to send appreciations/awards on channels (Referred to as Add to Team/Add to Chat).
Employees can access their Empuls account from MS Teams when the app is installed on their personal space (Referred to as Add to Me in the MS Teams Apps store).
To install the Empuls app for all users in your organisation:
Log in to the Microsoft Teams admin center.
Click on Teams Apps > Setup Policies.
Click on Global (Org-wide default) option to edit the policy.
Click on Add Apps option under Installed App section. This allows you to add the Empuls app to the default installed app for all users.
Click on Add Apps option under Pinned App section. This allows you to pin the Empuls app in messaging extensions and the Teams app bar.
Scroll to the end of the page to Save the changes.
Voila! Empuls is installed for all users on your Microsoft Teams instance.
Installing Empuls app on all Channels
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.
Log in to the Microsoft Teams admin center.
Click Teams apps > Manage Apps Search for Empuls app on the app list table and select the Add to Teams option
Click on the Add to Teams link to see the channel in the right-hand side panel, select and save.
All Done! Empuls app is now added to all employees and channels.
User Guide
Appreciate & Reward your team
Give value cards, monetary awards, or nominate co-workers on Teams in 3 simple steps.
Go to channel/group chat on your MS Teams app where you wish to appreciate your teammate.
Click on the Empuls icon on the message extension box to initiate recognition.
Enter details of who you wish to appreciate, the award/core value to be given, and your reason for the appreciation, and Submit. If the award requires approval, your appreciation message will be published after the approver reviews it.
You may be asked to add the Empuls app to the selected channel.
Redeem Reward Points
You can buy gift cards using points that you have received as a reward using the Redeem Points Command on the 1:1 Chat with Empuls.
Unable to find Empuls on your Teams chat? Install the app by clicking on this link.
Share Feedback
Share your feedback with your organisation and peers by responding to surveys on Empuls. You will be notified about this on a 1:1 chat with Empuls.
Alternately, Navigate to Empuls app > Home > Survey and Quiz Invites and click on Respond Now.
Reports and Insights
Access and view Reports and Insights on appreciation, rewards budget and engagement for you and your team.
More features are coming soon. For all features, explore the Empuls web app: https://www.empuls.io/
Controls for Empuls Administrators
Publish events on a Teams Channel
This feature allows Admins to automatically publish all events like award, appreciation, birthday, and work anniversary messages posted on Empuls Home Page to a dedicated channel/group chat on MS Teams.
Here are the steps for setting this up
Select a public channel on MS Team where you want all Empuls messages published. Install Empuls app on it.
Go to Empuls > Admin > Integrations > Microsoft Teams to start the setup.
Click on Click Here button. If you don't see this button, move on to the next step.
Once downloaded, you may review the permissions in the respective tab, attached in the image below.
Click on Select Team or Group Chat button to view a fullscreen pop-up with the title Edit Configuration.
In the Edit Configuration Pop-up, select a Team or a group chat where you wish to publsih all Empuls messages.
Select the type of messages to be published on your team channel and click on Save.
Voila! The setup is complete. Empuls app will start publishing messages on selected channel whenever they are published on Townhall or any other group.
How to add MS Teams on Chat?
Click on three dots on your Teams group to add Empuls.
Click on Continue and Empuls will be added to your chat.
How to pre-pin Empuls app on Teams?
The pre-pin option ensures that employees can easily find Empuls app on their Teams account. Here are the steps for Prepinning Empuls app.
Log in to Microsoft Teams admin center.
Click on Teams Apps> Setup Policies.
Click on Global (Org-wide default) option to edit the policy
Click on Add Apps option under the Installed App section,
Click on Add Apps option under Pinned App section, this allows you to pin the Empuls app in messaging extensions and Teams app bar.
How to get support?
Reach out to us at [email protected], or you can send us a message on Empuls Web app messenger.
Frequently Asked Questions
I am unable to find the Empuls app in the Microsoft Teams app store. How do I proceed?
I am unable to find the Empuls app in the Microsoft Teams app store. How do I proceed?
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.
How do I uninstall the Empuls app from a Microsoft Teams channel?
How do I uninstall the Empuls app from a Microsoft Teams channel?
You can uninstall the app from a channel by navigating to Apps section from the Manage Team option.
How do I uninstall the Empuls bot from my chat section?
How do I uninstall the Empuls bot from my chat section?
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.
Facing "Approval Required" Error?
Facing "Approval Required" Error?
Why does this happen?
This page appears if the Microsoft Admins at your organisation have added controls to prevent users from installing or using apps on Microsoft Store.
How to solve it?
A) 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:
Once completed, all users can log in and start using the Empuls app.
What permission does the Empuls app require, and why?
What permission does the Empuls app require, and why?
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 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 asked when the Admin wants to sync the MsTeams user profile pictures with Empuls for a seamless user experience across Teams and Empuls.