Connect Jira with Microsoft Teams
This is necessary to enable 2-way integration between Jira and Microsoft Teams for Advanced Microsoft Teams Jira Connector app.
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.
If your team is going to use only 1-way integration and set up notifications with Webhook URLs please skip this step and proceed directly to notifications set up.
Getting benefits from 2-way integration requires:
Install the companion app Move Work Forward with Jira in Microsoft Teams (Microsoft AppSource app).
Connection of the Jira instance with Microsoft Teams organisation. Let’s call it tenant mapping.
Install our companion app in Teams
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 go to Bot Settings tab.
Click on Register your Jira Server URL and copy Bot Connection Token (for example,
js-36f6975d-ba52-4acb-bef3-2c274e61aa02
)Open a 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=u6AafQ4P0kQConsent permissions
Before the bot can be fully used, the Microsoft Teams admin needs to do the APIs scope consent for the bot. To kick it off, the Microsoft Teams administrator needs:
Type
consent
in a 1-on-1 conversation withMove Work Forward with Jira
bot or simply follow this link: 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
![](../__attachments/2436726909/image-20220210-123842.png?inst-v=c348097f-f81a-48d2-867e-cbe7adf7c9cb)
Press
Consent
button and accept permissions.
![](../__attachments/2436726909/image-20220210-123926.png?inst-v=c348097f-f81a-48d2-867e-cbe7adf7c9cb)
Notifications to the Microsoft Teams channel
Personal notifications to 1-on-1 chat in Teams
Sharing Jira issues details in Teams
Updated: