Get started guide for Jira administrator

Jira administrator needs to connect Jira instance with Microsoft Teams organisation to enable 2-way integration for whole team.

2-way integration provides data flow in both directions. Your team not only can receive data in Microsoft Teams from Jira, but also send data to Jira from Microsoft Teams. Users can access and interact with Jira issues directly from Microsoft Teams platform, and vice versa.

Getting benefits from 2-way integration requires:

Install Advanced Microsoft Teams Jira Connector in Jira (Atlassian Marketplace plugin).
Install the companion app Move Work Forward with Jira in Microsoft Teams (Microsoft AppSource app).
After installing the 2 apps above, the Jira admin needs to connect the Jira instance with Microsoft Teams organisation. Let’s call it tenant mapping.

Install Advanced Microsoft Teams Jira Connector

Log in to your Jira instance as an administrator.
Go to the Atlassian Marketplace and search for Advanced Microsoft Teams Jira Connector.
Click on Try it Free to initiate the installation. Follow the prompts to complete it.
Find our app in Manage apps section or Microsoft Teams section in the left-hand sidebar.
Click on Settings or Configure button to set up integration on Global Configuration page.

Install Move Work Forward with Jira (companion app)

The Jira administrator needs to open Microsoft Teams and search for the Move Work Forward with Jira in the Apps section (or follow the link).
Click on Open/Add to open a 1-on-1 chat with the bot.
After you will receive the welcome message as a confirmation of the successful app addition to your Microsoft Teams chat.

Tenant mapping

Go back to Jira. On the Global Configuration page find and copy Bot Connection Token.
Open 1-on-1 chat with our bot in Microsoft Teams and enter connect jira command. After you should receive the card with the title Connect Microsoft Teams to Jira.
Insert the Bot Connection Token into the input field on the card and click on Connect Jira button.
You will be redirected to your Jira instance where you need to click the Connect accounts button.
When this is done the card below should update to the confirmation one.
When the tenants are mapped, any Microsoft Teams user can connect their account to the corresponding Atlassian Jira account. They need to use the connect command in 1-on-1 chat with the bot in Microsoft Teams.

The quick demo below demonstrates in detail the tenant mapping process.

https://www.youtube.com/watch?v=u6AafQ4P0kQ

Consent permissions

To allow our app to create Microsoft Teams channels straight from Jira, the Microsoft Teams administrator needs to consent to the required permissions.

Microsoft Teams administrator can do this in 2 ways:

type consent command in a 1-on-1 chat with our bot and follow the prompts to complete it;

or

follow the link below and click on Accept:

https://login.microsoftonline.com/organizations/v2.0/adminconsent?client_id=39d845a0-3fa2-4fba-acc2-61afe40cfcea&state=no&redirect_uri=https://api.moveworkforward.net/jira/jira-microsoft-teams-connector/thank-you-for-admin-consent&scope=https://graph.microsoft.com/.default

How to set up notifications?

How to connect/disconnect Jira and Microsoft Teams accounts?

How to add Move Work Forward with Jira app to all new teams automatically?

Updated: 01 Nov 2023