Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Autosaved
Table of Contents

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.

Allow team owners to install apps by themselves

Info

This is the option Microsoft recommends - and also on by default.

In case your administrator has disabled this option, it’s possible to turn this back on. To do this, please (as an Office 365 administrator) go to the following page in the AzureAD portal (Enterprise applications > Consent & Permissions):

Code Block
https://portal.azure.com/#blade/Microsoft_AAD_IAM/ConsentPoliciesMenuBlade/UserSettings

The option “Group owner consent for apps accessing data” needs to be allowed. This will allow team owners to install the app.

...

In addition to this setting, please also make sure that installing third party apps is allowed by the applicable app permission policy here:

...

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

image-20250109-121559.pngImage Added

MS Teams admin center

Status
colourPurple
titlems teams admin

Got to “Teams apps” → “Manage apps”.

Search for “Smart Connect” and select our app.

image-20250109-105425.pngImage Added

MS Teams admin center

Status
colourPurple
titlems teams admin

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

image-20250109-115014.pngImage Added

MS Teams admin center

Status
colourPurple
titlems teams admin

Go to “Teams apps” → “Setup policies”.

Choose a policy to deploy the app for your users.

image-20250109-115829.pngImage Added

Deploy the app

Click on “Add apps” → choose a policy in the sidebar → search for our “Smart Connect app” and add it.

image-20250109-120225.pngImage Added

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
exception
exception
Exception: environment restrictions

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.

Image Added

AzureAD portal

Status
colourBlue
titlems 365 admin

Permit app installation by going to: AzureID Portal User Settings and allow team owners to install apps by themselves.

Image Added

MS Teams admin center

Status
colourPurple
titlems teams admin

Go to “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

...

.)

Image Added

MS Teams admin center

Status
colourPurple
titlems teams admin

Allow the installation of 3rd party apps (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.

Install the app for certain teams manually

In case it’s not possible to turn on the above options, Microsoft Teams administrators can also add apps on a case by case basis.

To do this, please send your administrator to the following page:

Code Block
https://admin.teams.microsoft.com/policies/manage-apps

Search for the “Smart Connect for Jira” app, and add it to the requested team using the “Add to team” button. In case the app is not allowed by default, it might also be necessary to allow the app first.

...

Please note, in case you see this error below, it usually still worked correctly, 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.

Image Added

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.