Notifications to the Microsoft Teams channel

Name

a name for the notification rule for easy reference and identification.

Tags

adding tags to the rule serves the purpose of organizing and categorizing them. Instead of scrolling through an extensive list, administrators can filter rules by tags, streamlining the management process.

Events

the event or action that will trigger the notification; it allows you to select from a list of predefined events.

Issue statuses for transitions

the status to trigger notifications: when an issue transitions to this status in Jira, a notification is sent to the connected Microsoft Teams channel.

Avaible only for Jira issue level.

Use JQL

switch this toggle to define specific conditions using JQL (Jira query language).

Use Jira Filter

switch this toggle to use Jira Filters (saved queries that define sets of issues). You can use a Jira Filter to select a predefined set of issues, and when those issues are updated or transitioned, notifications are sent to Microsoft Teams.

Project filters

Jira project(s) for which the notification rule applies; notifications will only be triggered for events occurring within the selected project(s).

Avaible only for Global Level (for Jira Administrators).

Select issue types

specify the types of issues (e.g., bug, task, story) for which you want to receive notifications.

Select issue priorities

filter notifications based on issue priorities (e.g., high, medium, low).

Issue statuses for all events, but transitions

implies that notifications will be triggered for all events related to selected issue statuses, except for transitions.

Issue statuses for transitions

specifies that notifications will be triggered specifically for transitions between workflow steps (status changes). For example, you can set up notifications when an issue transitions to "In Progress."

Select assigned users

filter notifications based on the assignees of the issues. This parameter allows you to receive notifications for issues assigned to particular team members.

Select creators

choose the users who reported the issues.

Select the user groups of the event actor

this parameter refers to the group of Jira users responsible for specific actions in Jira, such as issue creation or transition.

Select the ignored user groups of the event actor

exclude certain Jira users group responsible for specific actions in Jira (the notifications won’t be triggered when action is done by those users).

Select watchers

filter notifications based on the watchers of the issues.

Enter labels

The way labels should be treated

set up notifications to be triggered when issues with specific labels are updated or transitioned. Also, specify how labels are treated in notifications. You can define whether notifications should trigger when any of the specified labels are present, or all of them are present.

Enter labels to ignore

The way ignored labels should be treated

ignore notifications triggering when issues with selected labels are updated or transitioned. Also, specify how labels are treated in notifications: when any of the specified labels are present, or all of them are present.

Microsoft Teams message fields

define what information should be included in the notification card in Microsoft Teams, choose which Jira fields (e.g., issue summary, status, description) are displayed in the notification card to provide context and details about the issue:

Microsoft Teams message fields section contains 5 settings:

• Exclude sending message details - when set the card will not contain any Jira issue 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 and general links that can be added to the card).

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

• Show message fields by default - when set the card will contain Jira issue fields. It allows you to configure which fields the Microsoft Teams card should contain when the message is sent using the rule.

Where to deliver

this parameter defines the delivery channels where notifications will be sent.

Multiple destinations support is available since 7.11.08

• Use Microsoft Teams bot (2-way integration) enable you to select Microsoft Teams channels straight from Jira and to interact with Jira issues from notification cards;

To use this functionality:

1. Jira admin needs to connect Jira and Microsoft Teams organisation. Learn more.

2. Move Work Forward with Jira app should be added to the selected team, otherwise, the notifications will not arrive. The step-by-step guide is here: How to add Jira bot to the Microsoft Teams channel?

Avaible only for Global (for Jira Administrators) and Project levels.

• Webhook URL (1-way integration) - to receive notifications you have to generate Webhook URL for a particular Microsoft Teams channel.

How to create Incoming Webhook URL?

How to create webhook URL with Workflows app?

Workflows app URLs support is available since 7.14.32

• Use managed URL enable you to select saved before Webhook URL (Webhook URL managment tab on Global and Project levels).