Notifications to the Microsoft Teams channels

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 Connector for Jira 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 Connector for Jira. 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.

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:

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:

Parameter	Definition
`Events`	the event or action that will trigger the notification; it allows you to select from a list of predefined events.
`Issue transitioned to`	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."
`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.
`Ignore internal Jira Service Management comments`	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.
`Select project`	Jira project(s) for which the notification rule applies; notifications will only be triggered for events occurring within the selected project(s). Available 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).
`Select reporters`	choose the users who reported the issues.
`Select assignees`	filter notifications based on the assignees of the issues. This parameter allows you to receive notifications for issues assigned to particular team members.
`Select watchers`	filter notifications based on the watchers of the issues.
`Select actors`	this parameter refers to the individuals or roles responsible for specific actions in Jira, such as issue creation or transition.
`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.
`Custom fields filters`	in this section filter notifications based on the values in custom fields.
`Configure the notification card content`	define what information should be included in the notification card in Microsoft Teams, and choose which Jira fields (e.g., issue summary, status, description) are displayed in the notification card to provide context and details about the issue.
`Where to notify`	this parameter defines the delivery channels where notifications will be sent. Here you can choose between 2 options: 2-way integration which enables you to select Microsoft Teams channels straight from Jira and to interact with Jira issues from notification cards; 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?. 1-way integration doesn’t allow interaction with Jira issues from Microsoft Teams; to receive notifications you have to generate a webhook URL for a particular Microsoft Teams channel. How to create webhook URL with Workflows app? Learn more about the functionality differences here.
`Name of the notification`	a name for the notification rule for easy reference and identification.