Install the Teamgage App for Microsoft Teams

Install the Teamgage App for Microsoft Teams

The below guide provides instructions for installing the Teamgage app on MS Teams for users. Before installing the Teamgage app on MS Teams, ensure your organisation has first set up a Teamgage integration between Teamgage and MS Teams.

Options for installing the MS Teams App

The Teamgage Microsoft Teams app can be installed in three ways:

1. For all users: This will install the app for all users in the organisation (click here)
2. In a channel: This will "bulk install" for all users in a specific MS Teams channel.
3. Personally: Allow users to install the app on an individual basis.

Users only receive notifications from Teamgage if they have the Teamgage Microsoft Teams app & are also an active user in Teamgage. For example, if you have a mixture of Teamgage users and non-Teamgage users in the same Teams channel, you can safely install the app for the whole channel, as only the ones who are Teamgage users will receive notifications.

Option 1. Install the app for all users in your organisation

If you wish to install the Teamgage app for all users in your organisation, this can be done using a Microsoft Teams app policy.

For information on setting up using the app policy, please read the relevant documentation from Microsoft Teams here: https://docs.microsoft.com/en-us/microsoftteams/teams-app-setup-policies#install-apps

You will need to be a Microsoft Teams administrator to action this setup option.

Option 2. Bulk-install the app for users by channel

To "bulk-install" the Teamgage app for users via a specific MS Teams channel, follow the below instructions.

Search for Teamgage in the Microsoft Teams app store and click on the Teamgage app.
If you don't see the Teamgage app in the app store, it has most likely been blocked by your organisation. Please get in contact with your internal IT/Teams administrator and ask for the app to be whitelisted.



Click the drop down arrow next to the 'Add' button which will allow you to select 'Add to a team'



Search for the name of the Team you wish to install the bot to and click the 'General' channel option


Finally, click the 'Set up a bot' button to complete the installation



A message similar to the one below will be sent to the Teams channel to indicate that the bot was successfully installed to the channel.


An individual user notification will be also sent to the Teamgage users who are members of the channel.




Option 3. Allow users to install the app on an individual basis

You can allow individual users to install the Teamgage app personally by telling them to follow the below instructions.


Search for Teamgage in the Microsoft Teams app store and click on the Teamgage app.

If you don't see the Teamgage app in the app store, it has most likely been blocked by your organisation. Please get in contact with your internal IT/Teams administrator and ask for the app to be whitelisted.​




Click the 'Add' button.



Done - the app has been installed! You will receive a message like the one below indicating the app was installed successfully.



If a user chooses not to download the MS Teams Teamgage app, they will receive their Teamgage notifications via Email instead.



    • Related Articles

    • How to download Teamgage App for MS Teams

      1. Search for Teamgage in the Microsoft Teams app store and click on the Teamgage app. If you don't see the Teamgage app in the app store, it has most likely been blocked by your organisation. Please get in contact with your internal IT/Teams ...

    • Receiving Teamgage Huddle Notifications via MS Teams

      Once you have the Teamgage App for MS Teams installed either manually or via your organisations set up you can now receive your Teamgage Huddle Notifications via MS Teams. User Notifications User Welcome Submission User Submission User Submission ...

    • Microsoft Teams Notification setup

      Setup an integration between Teamgage and Microsoft Teams, so notifications are sent to users via Teams rather than email (Learn more about our Teams integration). Ensure your organisation has setup Azure AD with Teamgage Request access to the ...

    • An Overview of Microsoft Teams and Teamgage

      Our integration allows Teamgage users to receive their regular Teamgage notifications, share reports, leave feedback and collaborate without ever leaving Microsoft Teams. No extra logins are required thanks to the magic of Single Sign On, creating a ...

    • Uninstalling the Teamgage Microsoft Teams App

      It may be necessary to uninstall the Teamgage app for a number of reasons, if you find yourself in this situation we provide a couple of useful Powershell scripts which can be used to bulk uninstall for either Teams or users. Uninstall the app for ...