Skip to main content
Skip table of contents

Notifications to the Microsoft Teams channel

Notifications to the Microsoft Teams channels provide real-time updates on Jira issues. Advanced Microsoft Teams Jira Connector help team members stay promptly informed of important events and changes related to a project, task, or issue discussion.

App settings

Advanced Microsoft Teams Jira Connector allows set-up notifications on 3 settings levels: issue, project and global. By offering global, project and issue-specific notification settings, Microsoft Teams allows users to fine-tune their notification preferences to match their specific needs and work requirements.

Notification configurations

To set up notifications sent to the Microsoft Teams channels you have to create a notification rule which allows you to configure specific conditions or triggers for receiving notifications in Microsoft Teams.

To set up notifications sent to the Microsoft Teams channels:

  1. Go to app settings on a level which meets your needs.

  2. On the Notification tab click on Create.

    image-20240116-112447.png
  3. Create notification rule with specified filters and Microsoft Teams channel (see the table below).

    image-20240116-200218.png
  4. Click on Save.

Below you can find a short definition of each parameter you can specify:

Parameter

Definition

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.

  • Incoming 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?

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

Group notifications by related Jira issue

Grouping Microsoft Teams notifications by related Jira issues is a valuable feature for keeping your team's communication organized and ensuring specific issue updates are easily accessible.

By default Notifications to the Microsoft Teams channels and Personal notifications sent to Microsoft Teams are ungrouped.

To use this functionality Jira admin needs to connect Jira and Microsoft Teams instances.

Follow this guide to group notifications by related Jira issues.


Personal notifications to 1-on-1 chat in Teams

Scheduled reports and alerts

Admin events notifications

Webhook URLs Management

Troubleshooting

Updated:

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.