Installing Microsoft Teams for Jira Data Center
Installing Jira in Microsoft Teams
Here are the prerequisites for installing this app:
- Microsoft Office 365. It should be Office 365 with Business license or Enterprise Office 365. Your IT admin also has to enable Microsoft Teams in Office 365.
- Allow external apps in Microsoft Teams for Office 365 should be set to On. Your IT admin has to enable it in the Admin center by going to Settings > Services & add-ins > Microsoft Teams > Apps > Allow external apps in Microsoft Teams > On. Note that after enabling the external apps in Office365, synchronization may take several hours.
To install Jira in Microsoft Teams:
- In your Microsoft Teams, go to Apps in bottom-left corner.
- Search for Jira Data Center.
- Select the tile and follow the installation dialog.
The installation provides the following capabilities within Microsoft Teams:
- Messaging Extension
- Bot
- Team and personal tabs
Jira ID
Jira ID is a unique identified that is generated after installing Microsoft Teams for Jira Data Center on your Jira instance. If this app is installed and you have the admin permissions, you'll see the Jira ID at the bottom of the app's configuration page. If you don't have the right permissions, contact your Jira admin to provide you with the Jira ID.
Messaging Extension
You need to have the Microsoft Teams for Jira Data Center app installed in your Jira instance for this capability to work.
All your messaging extensions can be open from the bottom of the compose box. There are some native messaging extensions, such as Emoji, Giphy, and Sticker. Choose the More Options (...) button to see Jira Data Center and other messaging extensions. You can also pin Jira Data Center messaging extension so that you don’t have to select it from options menu every time.
Once you open the messaging extension, click “Sign In” to connect to your Jira instance. You will be asked to provide Jira ID.
When you paste the correct Jira ID, your next step will be to enter your Jira login credentials for authentication. After that, in the messaging extension you should see the search field and the list of recent issues from Jira. You’re all set!
Bot
Bot is another capability of Microsoft Teams. The Jira Data Center bot will be your personal assistant when working with Jira.
To start your interaction with the bot, select Open in front of “Bot” on installation screen, or simply search “Jira Data Center” in your main search area of Microsoft Teams at the top, and open Jira Data Center Bot.
To see which commands are available for you, type “help” in your conversation with the bot.
For most of the commands, the bot will ask you to authorize in Jira. To do that, you need to enter the “connect” command and following the dialog, paste your Jira ID and login credentials.
Team and personal tabs
Jira Data Center tab capability lets you pin your team’s backlog to your channel so that all the team members can see and manage it directly from Microsoft Teams.
There are also pre-defined personal tabs available in your Jira Data Center app, where you can quickly navigate to issues assigned to you, reported by you, or your issues report with your custom filter applied.
In order to see and interact with the tab, you or your teammates will be asked to authorize in Jira. This can be done by selecting the Sign in button on the tab and follow the dialog.
Installing Microsoft Teams in Jira
You need to be a Jira administrator to install Microsoft Teams in your Jira.
If you're using Microsoft Teams for Jira Data Center 2025.05.13 or earlier:
- Go to Settings ⚙ > Applications > Application Links.
- Select Create links.
- Select Atlassian Product.
In the Application URL field, enter
https://jira-server.msteams-atlassian.com/, and select Create new link.You might see a warning saying that "No response was received from the URL you entered". Ignore it, and click Continue.
- On the first screen of the Application link:
- Enter Microsoft Teams as the Application Name.
- Select the Create incoming link checkbox.
- Select Continue.
- On the next screen, enter the following consumer details:
- Consumer key:
OauthKey - Consumer name:
MicrosoftTeamsIntegration - Public key: You can copy it from the app's configuration screen. It looks like the following example:
- Consumer key:
- On next screen of the Link applications dialog, enter the following consumer details:
- Consumer key: enter
OauthKeyas a value. - Consumer name: enter
MicrosoftTeamsIntegrationas a value. - Public key which you can copy from the app configuration screen in a box. Use the example from the next step.
- Consumer key: enter
- Select Continue. You should now have an application link that looks like this:
Now, once the configuration is set, you should see the following Jira ID at the bottom of the configuration screen:
The Jira ID will be requested from Microsoft Teams users during authentication. Share this ID with your users.
Microsoft Teams for Jira Data Center app will automatically create application link. The application link can be recreated from the configuration page.
When the configuration is set, you should see the following Jira ID:
The Jira ID will be requested from Microsoft Teams users during authentication. Share this ID with your users.
Next steps
After a successfull installation of both apps, you need to authenticate in Teams as a Jira user. You might also want to configure the firewall.