Microsoft Teams notifications from Jira Data Center or Server setup
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.
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: