This article outlines the process to link your Konexus account with your Microsoft Teams Tenant, installing the Konexus App to Teams, and configuring it to install the App for individual users
Overview of Installation Process
In order to enable the integration for your organization:
1. Provide Microsoft Tenant ID - you will provide Konexus with your Microsoft Tenant ID which is tied to your Teams infrastructure, associating your Konexus account with your Microsoft Tenant.
2. Install Konexus App - Once Konexus has configured your account for integration, a Teams administrator in your organization can download the Konexus app package and install it in your organization's Teams infrastructure.
3. 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.
What are the requirements to install the integration?
There are a few things to be aware of before you install the integration:
- In order to install the Konexus 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 like name, email address, company name, and preferred language. (Note: automatic translation performed is controlled by the language configured for the user in Konexus, not the preferred language on their Teams profile)
- 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. Here you'll find the recommended approach that provides both administrative control and ease of adoption.
Linking Your Konexus Account With Your Microsoft Tenant
In order to properly link your Teams infrastructure with your Konexus account, you will need to provide Konexus with 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 ask Konexus to enable Microsoft Teams for your Konexus account. Submit a request and include your tenant ID. Our Customer Success team will process the request and let you know when to proceed.
IMPORTANT: In order for your Teams users to be properly registered with Konexus, you must complete the linking of your Konexus Account with your Microsoft Tenant BEFORE adding the app to users' Teams app.
Obtaining the Konexus Microsoft Teams App
The app will be distributed directly from the Konexus content delivery network (CDN). The app is packaged as a zip archive, the integrity of which can be verified with MD5 Hash 8530B8C98E372E0E5B0413FA92791D83.
Click here to download the app
This link is the .zip file that you'll need to use for the Integration
Adding the Konexus App to Your Microsoft Teams Infrastructure
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.
Adding the Konexus App to Users' Microsoft Teams App
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.
