The Teamgage and Microsoft Teams integration allows your employees to access reports, leave feedback and collaborate without ever leaving Microsoft Teams. Single Sign-On must be enabled to allow the Microsoft Teams app to be used. This will provide a seamlessly accessible, zero friction experience for users wanting to access their Teamgage account. 


Not using Single Sign-On? See  Single Sign-On with Azure AD or Single Sign-On - SAML Setup Guide for more guidance

 

Setup instructions

The process of onboarding your organisation for AAD usage in Teamgage is straightforward.  


Step 1: Request Onboarding Link

Contact support@teamgage.com to set up Microsoft Teams integration and request an Azure AD onboarding link. Please include the email domain(s) used by your users (e.g. if your company email addresses are of the form john.smith@contoso.com, this would be contoso.com). 


Please note, multiple email domains may be provided if desired, as long as they are:

  • unique to your organisation (not gmail.com)
  • all registered as Custom Domains within the one Azure AD Tenant


Please provide a test account on the email domain that Teamgage can use for internal testing. 


Step 2: Provide Consent

You will receive an email containing an onboarding link similar to the following: 


 

Page Break 

Click on this onboarding link to be directed to your Azure onboarding page (see image below). 


 

Provide consent for Teamgage to access your data by clicking on the blue 'Review and Accept Permissions' button. Once you have clicked on this button, you will be redirected to the Azure AD consent page where, assuming you have sufficient privileges, you will see the following information:

 


 
Once you have clicked 'Accept', your Azure AD set up is completed and you will be redirected back to the Azure AD Onboarding screen. 


Step 3: Install the Teams App

Once you have completed steps 1 and 2, the onboarding screen will display options to install the Teamgage application in Microsoft Teams (see below). 


 


In order to use the Teams App, it must first be installed into a Microsoft Teams channel. This can be completed in one of two ways. We recommend automatically pre-installing the Teamgage Teams App into all Teams channels in your organisation by using the provided Powershell/BASH script or by following the 'Login to Azure AD link' button. Alternatively, individual users can download the Teamgage app from the App store and install it to any Channel which they are part of. 


Important to note: When you install the Teamgage app into a channel, the application will announce its presence by sending a notification to the channel. As such, we recommend that you install the application on the day of your Teamgage launch. Please ensure you coordinate with your organisation's Teamgage lead or communications team to plan when this will occur.