Install the Teamgage App for Microsoft Teams

Install the Teamgage App for Microsoft Teams

This guide provides instructions for installing the Teamgage app in Microsoft Teams for your organisation.

Prerequisites

Before installing, ensure your organisation has completed:
  1. Azure AD Setup Guide (Single Sign-On & Microsoft Teams Integration)
  2. Microsoft Teams Notification Setup

Installation Options

The Teamgage app can be installed in three ways:
  1. For All Users - Install the app across your entire organisation
  2. In A Channel - Bulk install the app for all members of a specific Microsoft Teams channel
  3. Individually - Allow users to install the app themselves
Alert
Users only receive Teamgage notifications if:
  1. They are an active Teamgage user, and
  2. They have the Teamgage Microsoft Teams app installed
If you install the app in a channel that contains both Teamgage and non-Teamgage users, only the Teamgage users will receive notifications.

Option 1 - Install for All Users

To install the Teamgage app organisation-wide:
  1. Use a Microsoft Teams app setup policy
  2. Follow Microsoft's documentation: https://docs.microsoft.com/en-us/microsoftteams/teams-app-setup-policies#install-apps
InfoYou must be a Microsoft Teams administrator to complete this option.

Option 2 - Install in a Channel

To bulk install the app for users in a specific channel: 
  1. In Teams, click Apps in the left-hand menu and search for Teamgage
    1. If you can’t find it, contact your IT/Teams administrator to whitelist the app
                  
      2.  Click the drop down arrow next to Add and select Add to a team
                  
      3.  Search for the Team name, then select the General channel
                  
      4.  Click Set up a bot to complete installation
                  
A confirmation message will appear in the channel once the bot is installed.
            
Teamgage users in the channel will also receive a notification.            

Option 3 - Install Individually

To allow individual users to install the Teamgage app:
  1. In Teams, click Apps in the left-hand menu and search for Teamgage
    1. If you can’t find it, contact your IT/Teams administrator to whitelist the app
            
      2.  Click Add 
            
The user will receive a confirmation message once the bot is installed.            
Info
If a user does not install the app, they will continue to receive Teamgage notifications via email.