The steps below outline the prerequisites and setup process to integrate Mass Notification alerts with your organization's Microsoft Teams environment.
Installation Process
Install App: Once Mass Notification has configured your account for integration, a Teams administrator in your organization can download the app package and install it in your organization's Teams infrastructure.
Set App Policy and Push App Install to Users: Once the app is installed in your Microsoft Tenant, Teams administrators can make the app available for optional inclusion by individual users, or they can choose to automatically add it to a specific set of users and groups, or even the entire organization.
With these steps complete, the alert sending experience will present the same as other channels, like email, mobile app, and text delivery. The sender will choose their recipients, craft their message, select the Microsoft Teams delivery channel, then review and send the message.
Configure the Microsoft Teams Settings: Once steps 1 and 2 have been completed, you will need to log into the Mass Notification web application and complete the Microsoft Teams setup form. To complete this form, you must be a Microsoft Teams Global Administrator to authorize consent to the required permissions.
Requirements to Install the Integration
There are a few things to be aware of before you install the integration:
In order to install the Mass Notification app for Microsoft Teams, you must have administrative access to your organization's Microsoft Teams infrastructure so that you may install custom apps. You may need to contact your IT department for assistance.
The app itself requires some permissions to be accepted when installing.
Read and access information related to you. The app must be able to access your users' profile information, such as name, email address, company name, and preferred language.
Send and receive messages and notifications. Users will only receive messages and notifications at this time. Sending from Microsoft Teams is not supported.
Each organization's configuration can be unique. However, installation methods can be adapted to fit the way you wish to make the app available to your users.
Install the Konexus Teams App
Mass Notification (powered by Konexus) provides a Microsoft Teams app that provides the ability to integrate our alerting platform with your organization's Microsoft Teams environment. The app will be distributed directly from the Konexus CDN. The app is packaged as a zip archive, the integrity of which can be verified with MD5 Hash 8530B8C98E372E0E5B0413FA92791D83.
Set App Policy and Push App Install to Users
Konexus provides a Microsoft Teams app that provides the ability to integrate our alerting platform with your organization's Microsoft Teams environment. The steps below outline how to add the Konexus Teams app to your Teams environment.
Add the Konexus App to Microsoft Teams
Log in to the Microsoft Teams Admin Center
Expand the Teams Apps section in the left navigation and click Manage apps
Click the Actions dropdown and select Upload new app
Click Upload. Locate the zip file you downloaded from the Konexus CDN and click Open.
Install the Konexus App for Users in Teams
Once the app has been added to your organization's Microsoft Teams infrastructure, it's time to decide how you wish to get it to your users. If users are currently permitted to add apps from your Teams catalog, you can simply make them aware of the new app and allow them to add it to their Teams client at their leisure. However, the recommended approach is to create a policy that installs the application automatically for users. This option puts you in the driver's seat with respect to adoption.
Log in to the Microsoft Teams Admin Center
Expand the Teams Apps section in the left navigation and click Setup policies
Once you are on the App setup policies page, ensure you are on the Manage policies tab, then click Add. You may see different numbers in the App setup policies summary card.
Note:
If you already have some policies in place, you may choose to modify an existing policy rather than create a new one. If you do, don't forget to add the Konexus app to the policy's Installed apps.
Provide a name for the policy and optionally provide a description
Click on the Add apps button under the Installed apps heading
Note:
All users to whom this policy applies will have the Konexus app installed in their Teams app automatically.
A flyout will appear on the right-hand side of the screen. In the search box, type Konexus and select it to add it to the list of Apps to add.
Click Save at the bottom of the screen to finish creating the policy. If prompted with a dialog regarding User pinning, simply click Save again.
After saving your new policy, you will be returned to the main policy setup screen. Locate and select the Group policy assignment tab. Click the Add button.
Fill out the group policy fields and click Apply
Group: Choose the group you wish to assign the policy to. These groups are managed in Microsoft Entra. Use the box to search for the appropriate group and a dropdown will appear, listing the search results. Click the Add button on the desired group to select it.
Select a policy: Choose the policy we just created. In our example, that would be the policy named Konexus App Users.
A dialog will appear, explaining that the process of assigning the policy may take some time depending on the number of users in the group. Keep in mind that it would take time to undo this change as well, and so immediate rollback is not possible. Double-check that the correct group and policy were selected and simply click on Confirm to continue.
Once confirmed, you will be returned to the App setup policies screen. Your new policy assignment will be listed in the table below. At the top, you'll see a green banner telling you that the assignment of the policy has begun.
Note:
It may take up to 24 hours for the policy to be applied.
Configure the Microsoft Teams Settings
To properly link your Teams infrastructure with your Mass Notification account, you will need to provide your Microsoft Tenant ID. This ID is assigned by Microsoft and is found in the Microsoft Entra directory that is associated with your Teams configuration.
Once you have found your tenant ID, you're ready to submit a request with Mass Notification to enable Microsoft Teams for your account. Our team will process the request and let you know when you are able to complete the Microsoft Teams setup form within the Mass Notification web application.
Sign in to the system if you have not already
Enter your Microsoft Tenant ID
Log in using your Microsoft Teams credentials and accept the required permissions
(Optional) Once everything has been configured and the required permissions have been accepted, you can test the integration and create a custom Welcome Message
Testing: Click the Test Integration button to verify Mass Notification' ability to make requests to the Microsoft Teams environment for your organization.
Welcome Message: You can define a custom Welcome Message that will be sent to users to inform them that they have been discovered by the integration.
(Optional) You can click the Link Now button to manually start the process to discover users within your organization who have the Konexus Teams app already installed.
How are users discovered?
Manual: By clicking the button in the view above
Automated: Microsoft will inform Mass Notification when a user installs our Teams app
Automated: If your organization utilizes Automated Imports for user management, we will initiate the discovery process after each new data upload completes.