Notifications to the Microsoft Teams channels provide real-time updates, ensuring that team members are promptly informed of important events and changes related to a project, task, or issue discussion.
Advanced Microsoft Teams Jira Connector allows set-up notifications to be sent to Microsoft Teams channels on 2 settings levels: project and global.
By offering both global and project-specific notification settings, Microsoft Teams allows users to fine-tune their notification preferences to match their specific needs and work requirements.
Global level (for Jira Administrators)
Jira administrators have access to the global settings of Advanced Microsoft Teams Jira Connector. Global settings typically allow administrators to manage and configure the notifications and default settings for all users and projects across the entire Jira instance.
Where to find app settings on Global level?
On the global navigation menu click on Apps and select Manage Apps section.
Find our app in Manage apps section or Microsoft Teams section in the left-hand sidebar.
Click on Settings or Configure button to navigate to Global Configuration page.
On the Global configuration page go to the Notification tab.
Project level (for Project Administrators)
Project-level settings allow project managers to customize and configure the notifications to align with the specific needs and requirements of the project. Each project may have its unique workflows, issue types, priorities, and custom fields. Project-level settings enable tailoring the tool to match these specifics.
Where to find app settings on Project level?
Go to the Project Settings of the Jira project space you want to set up notifications for.
Move to the Apps section on the left sidebar and click on Microsoft Teams.
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:
Go to app settings on a level which meets your needs.
Click on Create.
Create notification rule with specified filters and Microsoft Teams channel (see the table below).
Click on Save and receive a confirmation message to the Microsoft Teams channel.
Below you can find a short definition of each parameter you can specify:
the event or action that will trigger the notification; it allows you to select from a list of predefined events.
the status to trigger notifications: when an issue transitions to this status in Jira, a notification is sent to the connected Microsoft Teams channel. For example, you can set up notifications when an issue transitions to "In Progress."
switch this toggle to define specific conditions using JQL (Jira query language).
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.
by enabling this parameter, the notifications to Microsoft Teams for comments that are marked as internal in Jira Service Management will not be sent. Internal comments are typically meant for the support team's internal discussions and are not intended to be visible to customers.
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).
specify the types of issues (e.g., bug, task, story) for which you want to receive notifications.
filter notifications based on issue priorities (e.g., high, medium, low).
choose the users who reported the issues.
filter notifications based on the assignees of the issues. This parameter allows you to receive notifications for issues assigned to particular team members.
filter notifications based on the watchers of the issues.
this parameter refers to the individuals or roles responsible for specific actions in Jira, such as issue creation or transition.
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.
in this section filter notifications based on the values in custom 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.
this parameter defines the delivery channels where notifications will be sent. Here you can choose between 2 options:
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?.
a name for the notification rule for easy reference and identification.
Actions on the Jira issue from the notification card
To use this functionality you need to connect your Jira and Microsoft Teams accounts:
Our integration provides the ability to take immediate actions on the Jira issue to ensure effective collaboration in Microsoft Teams, such as:
assign the Jira issue to themselves;
change the issue status.
All you need is to click on the action you need on the notification card and make the updates you need.