Skip to main content
Skip table of contents

Teams portal app

Embed your Jira Service Management customer portal in Microsoft Teams and let your customers quickly raise new requests without leaving Microsoft Teams.

The installation process can be completed in a few steps by following the provided instructions from within the admin settings.

Ensure that you have your Jira and Microsoft Teams administrators available.

image-20241120-090940.png

Admin settings Jira Cloud

image-20241125-114632.png

Admin settings Jira Data Center

Install Teams portal app

The installation & deployment follows the same way for Jira Cloud and Data Center.

Who is in charge

The table below provides an overview of admin responsibilities and actions to set-up the Teams portal app for your team.

Step

Responsibility

Action

1

JIRA ADMIN

Sets-up the customer portal in Jira.

2

JIRA ADMIN

Edits the customer portal for the deployment in Microsoft Teams.

3

JIRA ADMIN

Downloads the custom app (.zip file). This file needs to be uploaded in Microsoft Teams as Teams portal app.

4

MS TEAMS ADMIN

Deploys the Teams portal app in Microsoft Teams / upload .zip file.
Click through the set-up guide below, which outlines the concrete steps to do so.

Set-up guide

The demo below shows you how to install and deploy the Teams portal app for your team, starting from the Jira admin settings and finishing in Microsoft Teams.

As mentioned above, the Jira and Microsoft Teams admin need to take action to provide an accurate deployment.

In case you want to learn more about general concepts of apps in Microsoft Teams, we recommend reading the official Microsoft documentation.

Please note: If you are a Microsoft Teams admin, but not an active Teams user, the app icon might not display correctly.

Benefits

After installing the portal in your MS Teams, you will be able to use JSM features right in Microsoft Teams e.g. raising support tickets from MS Teams (see below screenshot).

You can now do the following in Microsoft Teams:

You can do the following in Jira:

2403-Marketplace-Gallery-Screens24-20240710-101426.png

Relevant facts

📌 Please consider the following:

Teams portal settings

image-20241106-113655.png

When setting up the Teams portal app for the first time, you’ll need to configure the ‘framework’ first. Read the more detailed explanation of all options in the table below.

Teams portal framework

image-20241106-113824.png

Configure your portal

Set-up the framework of your portal in Microsoft Teams here.

Select a name, choose an icon, and determine which JSM portal you would like to integrate and display in MS Teams.

Teams portal app name

Give your portal a descriptive name that will be displayed in Microsoft Teams.

Teams portal app icon

Choose from a set of icons for your portal. This icon will be visible in Microsoft Teams sidebar.

Jira Service Management portals shown in Teams

📌 Please note: Our bot can only be installed in one of your JSM portals. Thus, it is only the connection between this portal and Microsoft Teams.

Banner image URL

Choose a suitable banner image for your portal in Microsoft Teams.

Teams portal settings

image-20241106-114052.png

Further configuration

Decide on a few more options for the set-up of your portal in Microsoft Teams.

Learn more on the options and their explanation in the table below.

Create portal customers on demand

In case you don’t sync all your customer users automatically from Microsoft Azure AD, there might be cases where a Teams user does not have a customer user yet.

By default, we will create a new customer user on demand, the first time a user accesses the portal from Microsoft Teams. In case you don’t want this, turn this option off.

📌 In this case, the user will see an error message in Teams. Read also: customer single sign on.

Collect CSAT

REQUIRES NOTIFICATIONS

Enable this option to collect CSAT (Customer satisfaction) feedback after a request is resolved. Ensure that either customer chat or request notifications are enabled for delivery.

Native portal look & feel
EXPERIMENTAL

As this uses preview/private Atlassian functionality, it’s turned off by default.

In case your users expect the portal to look more similar to the original web-based portal (e.g. portal icons, description texts & announcement banners), you can use this option to configure it.

After enabling it, you'll need to create a new API key so that we can synchronise the customisations from the web portal. We recommend that you create a service user with access to the portal. (e.g. portal-customization@yourcompany.com) and create the API token using this user.

Disable “Shared with” field

Toggling this option on, it will hide the “shared with” field from your create request screen.

However, it will be displayed when opening up existing requests under “My requests”.

Disable knowledge base article suggestions

Whenever a new request is raised, our app automatically refers to your Confluence knowledge base articles to provide a possible solution to their current problem.

It's likely that the issue won't be raised at all, as the user may have found an appropriate solution in a Confluence article.

However, if you prefer to not see any knowledge base article suggestions in your Teams portal, you can enable this option.

Custom app compatibility mode

In case you are using apps that rely on a custom UI in the portal, turn on this option to open the final step (creating the request) in a browser pop-up window in Teams.

📌 To learn more about the app compatibility mode, please see the limitation section: App compatibility mode.

Forms

With the latest version of Microsoft 365 for Jira, Forms are fully supported in your Teams portal app in Microsoft Teams.

Customer portal in Outlook

If you’re using your customer portal in Microsoft Teams, you’re also able to use your customer portal in Outlook.

Request notifications (project settings)

JIRA PROJECT ADMIN

image-20250122-104412.png

JSM project settings

Request notifications are customer-specific and sent via the bot chat. They also appear in the activity tab and can be configured in the project settings. These notifications cover status changes, public comments, and approvals. 

📍 To configure personal notifications, the Teams portal app must be installed for every notification recipient. Follow instructions here.

This is just one of several notification types for JSM projects. Explore all available options here.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.