💡 The CoLab Admin must also be a Teams Admin for the connection to succeed and the integration work as expected.
Ensure your team never misses another notification by installing the CoLa integration for Teams, which will seamlessly push vital notifications into your Teams environment.
In this article, we'll go over the steps to install the CoLab app for Teams, starting with downloading the app from CoLab, installing it on Teams, and ensuring the app is connected.
Downloading the integration from CoLab
To install a custom app into Teams, you need a .zip file for the app. To get this, navigate to your Settings & Admin panel.
Head to the Integrations page and select the Microsoft Teams integration tile.
This will bring you to a Microsoft Teams Connect Portal page. Download the app's .zip file from the link in the Connect Portal description.
Install the integration
💡 Important reminder: the CoLab Admin must also be a Teams Admin for the connection to succeed and the integration work as expected.
In the Teams Administration Dashboard (https://admin.teams.microsoft.com/dashboard), Select Teams apps > Manage apps
In the top right corner of the screen, select the Actions dropdown > Upload new app. Select the previously downloaded .zip file.
Once the CoLab app has been added, search for it in the table of All apps to make sure it was properly added.
Blocked apps
It is possible, based on company policy, that the App status might be Blocked. The app must be Unblocked to be used.
If Blocked, follow the steps in the Microsoft Teams documentation to unblock it.
To learn more, the Managing apps Microsoft Teams documentation can be found here.
Ensure your integration is fully connected
Select the CoLab app to view its settings. On the About page, copy the External app ID - this will be used to confirm your connection in CoLab.
A Global Administrator may need to consent to the permissions for the app. This can verified in the Permissions tab. If shown, please contact your Teams app Global Administrator.
In CoLab, navigate back to Settings & Admin > Integrations and back into the Microsoft Teams tile.
Click Connect within the modal. This will redirect you to a Teams page confirming the connection, which will close automatically.
Once connected, the Connect portal will show two settings under the Configuration tab.
App ID (required): Use this field to paste the previously-copied
External app IDhere from your Teams settings.Allow automatic installation (optional):
If Yes is selected, when a user receives their first CoLab notification through Teams, the CoLab app will install itself for individuals that have yet to install it manually. Only those who receive CoLab notifications will have this happen.
If No is selected, only those users who opt in and install the integration through Teams will receive notifications through the Teams integration.
We recommend allowing automatic installation where possible for the smoothest user experience.
🧠 Users receive notifications through Teams based on their notification preferences for in-app notifications.