In certain environments, installing the Teams app might not be possible, not even by the team owner.
There are two ways to enable the app anyway, though an approval of a Microsoft Teams administrator will be required.
Option 1: Allow team owners to install apps by themselves
| Status | ||||
|---|---|---|---|---|
|
| Status | ||||
|---|---|---|---|---|
|
| Info |
|---|
This is the option Microsoft recommends. This option is active by default. |
AzureAD portal
This deployment guide is intended for MS Teams admins and MS admins, if the team owner encounters issues installing the Smart Connect app independently.
| Info |
|---|
The typical installation process can be followed. See here: Install Smart Connect app 🚀 |
Deploy app to (all/specific) teams
MS Teams admin center
| Status | ||||
|---|---|---|---|---|
|
Got to “Teams apps” → “Manage apps”.
Search for “Smart Connect” and select our app.
MS Teams admin center
| Status | ||||
|---|---|---|---|---|
|
After selecting the app → click on “Add to team” → search for all or specific teams → “Apply” and the app will be available for those teams selected.
| Note |
|---|
If the app is not permitted by default, you may need to grant permission for the app to function properly. (see: Exception: environment restrictions). |
Deploy app to (all/specific) users
MS Teams admin center
| Status | ||||
|---|---|---|---|---|
|
Go to “Teams apps” → “Setup policies”.
Choose a policy to deploy the app for your users.
Deploy the app
Click on “Add apps” → choose a policy in the sidebar → search for our “Smart Connect app” and add it.
Pin the app
After you have deployed the app successfully, you can pin the app in your MS Teams sidebar.
Go to the section “Pinned apps” → “Add apps” → Pick Smart Connect app and add to the list.
| Anchor | ||||
|---|---|---|---|---|
|
By default, the option for team owners to independently install applications is typically enabled. If this is not the case, action must be taken by your MS 365 administrator or MS Teams administrator.
In some cases, there may be environments where the owner of a Microsoft Teams team is restricted from installing apps independently for their teams or users.
To enable the installation, please follow the steps outlined below.
AzureAD portal
| Status | ||||
|---|---|---|---|---|
|
Permit app installation by going to: AzureID Portal User SettingsAnd and allow team owners to install apps by themselves.
MS Teams admin center
| Status | ||||
|---|---|---|---|---|
|
Go to app “Teams apps “ → choose “permission policies”.
Choose the policy that is assigned to your Jira users in Teams (if you just have the global one, choose this.) Click on it …
MS Teams admin center…. and allow
| Status | ||||
|---|---|---|---|---|
|
Allow the installation of 3rd party apps by the applicable app permission policy (or just allow the installation for our Microsoft Teams - Smart Connect for Jira app.) in the next step.
🚀 The MS teams owner can now install our Smart Connect app in their team.
| Note |
|---|
Please note: It may take up to 24 hours for the app to be visible for users in Teams. |
Option 2: Install the app for certain teams manually
| Status | ||||
|---|---|---|---|---|
|
| Status | ||||
|---|---|---|---|---|
|
| Info |
|---|
If non of the above works, Microsoft Teams administrators can also add apps on an individual basis. |
MS Teams admin center
Go to your MS Teams admin center → manage apps.
Search for our app → Select it → “Add to team”.
👏 There is nothing more to do for the MS teams owner.
| Note |
|---|
In case the app is not allowed by default, it might also be necessary to allow the app first (see above). |
Option 3: Choose the app to be installed for all/certain users by default
MS Teams admin center
Go to Setup policies → choose the relevant policy → add apps and add Smart Connect for Jira.
Below you can also decide to pin the app at the side bar.
However, you still need to install the app in a Team if you want to use it there (see step 2)
Heads up
In case you see this error below, it usually works and the app should be installed. There currently seems to be a bug on the Microsoft side regarding this.
Heads up
If you see the error message below, the app should install without issue. It seems there is a bug on Microsoft's end causing this problem.
User can install the Smart Connect app on their own, if they have respective permissions to do so. This can be useful for testing reasons.