Microsoft Teams Jira Connector provides one-way integration from Jira to Microsoft Teams. It is a much more secure and robust integration.

2-way integration details are described in the Microsoft Teams Jira On-Premises guides.

Marketplace link: https://marketplace.atlassian.com/apps/1216325/microsoft-teams-jira-connector?hosting=server&tab=overview

Frequently Asked Questions

You can check the FAQs on the Microsoft Teams Jira Connector product page.

Alerts configuration

You can find alert configuration on the Alerts Configuration page.

Scheduled reports configuration

You can read about Scheduled reports configuration on this page.

Configuration

There is a global and project-level configuration. The global configuration is available to the global administrators only.

The global configuration is in the System → Mail → Microsoft Teams.

The project-level configuration is accessible in the Project Settings → Microsoft Teams. Only project or global administrators can change the project-level configuration.

Video Demo

Setup video demo

How to create Microsoft Teams Incoming Webhook Url

Here are the details from Microsoft.

Go to the Microsoft Teams channel configuration, Connectors and add an Incoming Webhook Connector.

microsoft teams Jira connector add connector

Find Incoming Webhook and add one. Put the name as Jira and set the Jira logo.

Set the name and the icon of the Connector.

Copy the webhook URL that will be used later on during the configuration process.

Setup notifications from Jira to Microsoft Teams

Navigate to the configuration page at the Global or Project level, select the projects you want to get notification about and paste the webhook URL (or select a managed URL).

Setup the filters. Do remember that some values are only available when there is only 1 project selected.

You can configure custom field filters. For instance, below you can see the Epic Link filter.

 

The configuration gets stored when you press the Save button.

You can have multiple notification rules.

When you just installed the plugin, please try to create a very simple configuration to the event "Someone leaves a comment" and with no filters. This will validate that the plugin has the correct license and your Jira can access Microsoft Teams.

Microsoft Teams message fields configuration

When you create a rule you can configure which issue fields are sent to Microsoft Teams.

Microsoft Teams message configuration

Microsoft Teams message fields section contains 5 settings:

  • Exclude sending message details - when set the card will not contain any message fields (or we can call them facts).

  • Include links to attachment(s) - when set includes links to the issue attachments (if present).

  • Include links - when set the card could include the issue links (other issues as well as general links that can be added to the card).

  • Hide Empty Fields - when set the card does not get empty fields.

And the last setting is the issue fields selection multi-select field. It allows you to configure which fields the Microsoft Teams card should contain when the message is sent using the rule.

You can reorder fields by drag-and-dropping the names.

Enable 2-way integration between Microsoft Teams and Jira On-Premises

Please follow the set of guides and documents → Microsoft Teams Jira Connector 2-way integration guides.

Troubleshooting

If you need to help please contact your Jira administrator(s) with as many details as possible, so that they can reach out to the Move Work Forward support team.

Updated: