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.
Set App Policy and Push App Install to Users
Adding the Konexus App to Microsoft Teams
1. Login to the Microsoft Teams Admin Center
Navigate to the Microsoft Teams Admin Center at https://admin.teams.microsoft.com. You may be prompted to login to your Microsoft account if you are not already logged in.
2. Navigate to Manage apps
Once logged in, you will be presented with the Admin Center's Dashboard. Locate the Teams Apps section in the navigation on the left and click to reveal the settings beneath it. Click on Manage apps.
3. Upload the Konexus app
The app management screen is displayed. In the top right-side of the screen, there is a dropdown titled Actions. Click the dropdown and select Upload new app.
You will be prompted to upload the custom app. First, click Upload. Locate the zip file you downloaded from the Konexus CDN and click Open.
Observe that there has been a New app added.
Installing the Konexus App for Users in Microsoft 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.
1. Login to the Microsoft Teams Admin Center
Navigate to the Microsoft Teams Admin Center at https://admin.teams.microsoft.com. You may be prompted to login to your Microsoft account if you are not already logged in.
2. Navigate to Setup policies
Once logged in, you will be presented with the Admin Center's Dashboard. Locate the Teams Apps section in the navigation on the left and click to reveal the settings beneath it. Click on Setup policies.
3. Create a new App setup policy
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!
Once you are on the App setup policies page, ensure you are on the Manage policies tab, then click Add. Note that you may see different numbers in the App setup policies summary card.
Once you click add, you will be presented with a screen for creating a new setup policy. Provide a name for the policy and optionally provide a description.
Next, we need to add the Konexus app to the list of Installed apps. By doing so, all users to whom this policy applies will have the Konexus app installed in their Teams app automatically. Click on the Add apps button under the Installed apps heading beneath where you specified the name and description of your policy.
When clicking the Add apps button, a flyout will appear on the right-hand side of the screen. In the search box, type Konexus. A dropdown will appear, listing the Konexus app. Select it to add it to the list of Apps to add.
Click Add at the bottom of the flyout. This will add the Konexus apps to the Installed apps section of the new policy. Observe that it has been added.
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.
4. Associate the policy to users
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.
When clicking the Add button, a flyout will appear on the right-hand side of the screen. In the first field, you'll 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. In the next field, you'll select the policy we just created. In our example, that would be the policy named Konexus App Users. Lastly, click the Apply button at the bottom of the screen.
After clicking Apply, 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. Additionally, 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.
