Versions Compared

Key

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

Deployment options

Typically, the Microsoft Teams team owner can independently install the MS Teams - Smart Connect app in their teams where needed and useful.

Who is in charge?

  • The Microsoft Teams team owner typically installs the MS Teams - Smart Connect app for their teams or for specific / all users.

  • If not possible, the Microsoft Teams admin needs to take action (see: Deployment Teams app). They install the app centrally or for specific teams.

  • In some cases, the Microsoft admin has to change settings to allow the installation of third party apps for their team owners (see: Exception: environment restrictions).

Anchordeploy-teams-appdeploy-teams-app

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

📌 Follow instructions below if:

  • the team owner cannot install (or is not allowed to install) the app on their own

  • the Microsoft Teams admin wants to deploy the app centrally for teams

Image Removed

image-20250109-121559.pngImage Added

MS Teams admin center

Status
colourPurple
titlems teams admin to do

Go Got to your MS Teams admin center → manage appsTeams apps” → “Manage apps.

Search for Smart Connect” and select our app → Select → “Add to team”. 👏 There is nothing more to do for the MS teams owner.

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

📌 Follow instructions below if:

  • the team owner cannot install (or is not allowed to install) the app for the users

  • the Microsoft Teams admin wants to deploy the app centrally for users

Screenshot 2024-02-22 131603-20240222-121603.pngImage Removedimage-20250109-115014.pngImage Added

MS Teams admin center

Status
colourPurple
titlems teams admin to do

Go to “Setup policies” → choose the relevant policy → add “apps” and add “Smart Connect for Jira”.

Below you can also decide to

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 Modified

AzureAD portal

Status
colourBlue
titlems 365 admin to do

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

MS Teams admin center

Status
colourPurple
titlems teams admin to do

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 …

Image Modified

MS Teams admin center

Status
colourPurple
titlems teams admin to do
…. and allow

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.

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 Removed

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.