This guide will show you how to setup Microsoft Teams Jira Connector for the first time. There are two components of this service - Microsoft Teams App and Jira App.
Install Microsoft Teams App: https://appsource.microsoft.com/en-us/product/office/WA200002855?tab=Overview
General setup process
You need to have installed the Microsoft Teams Jira Connector application in Jira.
You need to have installed Jira Connector application in Microsoft Teams.
Microsoft Teams administrator needs to consent permissions for Microsoft Teams Jira Connector to allow it to perform the operations it needs to perform. This link can be used to consent. The same link available in the Jira System settings page.
After you have installed the 2 apps above, Jira admin needs to connect Microsoft Teams and Jira (let’s call it tenant mapping). Where you will say your Microsoft tenants is linked to your Atlassian Jira tenant. Using
connect jiracommand in Microsoft Teams.
When the tenants are mapped, any Microsoft Teams user can map his or her account to the corresponding Atlassian Jira account. This is done using
connectcommand in Microsoft Teams.
Consent the Microsoft Teams Jira Connector app to allow interact with Microsoft Graph API for your organization. This is required to create issue discussion channels.
When both apps are installed Jira administrator needs to follow these steps.
Demo video: https://www.youtube.com/watch?v=u6AafQ4P0kQ
Navigate to the Microsoft Teams page in system settings and find there Bot Connection Token (at the bottom of the page).
2. Afterwards, open a one on one conversation with Jira Connector in Microsoft Teams and type
connect jira. Please enter the corresponding token and press Connect Jira button.
3. Connect your tenant and user by clicking the Connect button on the card. You will be redirected to your Jira instance where you need to click the only available button to map your accounts.
4. When this is done the Microsoft Teams card should update to the following.
User mapping is very similar process (for Jira admin it is done during the tenant mapping and explained above).
Demo video: https://www.youtube.com/watch?v=UOfA3pN9F8g
To map your Microsoft Teams and Atlassian Jira accounts you need to type
connect in one on one conversation with the Microsoft Teams Jira Connector bot.
When you press Connect button on the card you will end up in your Jira where you need to confirm the account mapping.
When the connection process is done the page should update to
and you should see the card similar to this one
When everything is connected you can move work forward with Microsoft Teams Jira Connector. The best way to start is to search for an issue using free text or JQL search.
In order to allow Microsoft Teams Jira Connector app to create channels to discussion Jira issues Microsoft Teams administrator needs to consent required permissions.
The consent process started by click on the consent link in the configuration or issue page.
Or you can use this link.
If you don’t have permissions to consent you will see the following message, so you need to help your Microsoft Teams admin to consent.
If you need help please do not hesitate to contact us.