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](../__attachments/2330986787/image-20241120-090940.png?inst-v=692b3fde-7ab8-4a95-8666-7d1b8bd4b218)
Admin settings Jira Cloud
![image-20241125-114632.png](../__attachments/2330986787/image-20241125-114632.png?inst-v=692b3fde-7ab8-4a95-8666-7d1b8bd4b218)
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. |
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:
Leave Jira comments in your ticket
✅ You can do the following in Jira:
Reach out to customers from Jira via Microsoft Teams chat
(this feature does not require the installation of our Smart Connect app)
![2403-Marketplace-Gallery-Screens24-20240710-101426.png](../__attachments/2330986787/2403-Marketplace-Gallery-Screens24-20240710-101426.png?inst-v=692b3fde-7ab8-4a95-8666-7d1b8bd4b218)
Relevant facts
📌 Please consider the following:
The installation of our Smart Connect for Jira app is not a prerequisite for the Teams portal app!
The Teams portal app is only required to use JSM features in Microsoft Teams.
The Teams portal bot can only be installed in one customer portal in Microsoft Teams (see below).
Request notifications for JSM projects are configured via Preset: Teams.
Teams portal settings
![image-20241106-113655.png](../__attachments/2330986787/image-20241106-113655.png?inst-v=692b3fde-7ab8-4a95-8666-7d1b8bd4b218)
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
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
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 | 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](../__attachments/2330986787/image-20250122-104412.png?inst-v=692b3fde-7ab8-4a95-8666-7d1b8bd4b218)
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.