| Table of Contents |
|---|
Overview
What does the integration offer?
With Jira Service Management’s ChatOps app for Microsoft Teams, you can receive notifications for the alerts you care about, perform actions on the alerts, and manage some on-call work from your Teams channels — using buttons or commands mentioning the app @AtlassianChatOps.
You can add multiple Microsoft Teams integrations to streamline alert notifications. For example, you can create an integration that notifies a Teams channel only about high-priority alerts, and another integration that notifies a different Teams channel about low-priority alerts.
How does the integration work?
Once your Jira Service Management site is connected to a Microsoft tenant, the Atlassian ChatOps app can be added to Standard channels where you’d like to receive alert notifications. Private channels aren’t supported.
Jira admins can set up Microsoft Teams integrations for the site (to receive alerts that have no responder team added).
Team admins can set up Microsoft Teams integrations for their teams (notifications will be sent only for alerts on which their team is added as a responder).
Set up the integration
Before you set up the integration,
Make sure you’re the team admin or the Jira admin
Connect your Microsoft tenant with your Jira site so you can use it for your integrations. Read how to connect your Microsoft tenant
Make sure you’ve created the Microsoft Teams channel to receive alert notifications.
Add Microsoft Teams integration
| Info |
|---|
If you're on the Free or Standard plan on Jira Service Management, you can only add this integration from your team’s Operations page. Adding a Microsoft Teams integration from your team’s Operations page will only let you send notifications on Microsoft Teams for your team’s alerts. To get notifications for alerts that have no responder teams assigned, you’ll need access to the feature through |
Add Microsoft Teams to your Jira site
Go to Settings → Products.
Select Integrations from the sidebar (under Operations). You’ll be able to view already added integrations of all teams on the Jira site.
Select Add integration.
Add Microsoft Teams for your team
On the team’s profile page, scroll to the Operations section and select Go to operations to view alerting and on-call capabilities for your team.
Select Integrations from the sidebar, and select Add integration.
Next, select Microsoft Teams from the list of all integrations.
Fill in some important details for your integration. To edit these details later, except for the integration name, you’ll need to reset the integration. Read how to reset your Microsoft Teams integration
Integration name: Name your integration to easily find it later.
Responder team: The integration will send alerts for which the team you select is a responder. You can select ‘None’ to get notifications for alerts with no responder teams.
Microsoft tenant: Select the Microsoft tenant where your channels exist.
Microsoft team: Select your team on Microsoft Teams whose channels you’d like to use for this integration.
Microsoft Teams channel: Select the channel to receive alert notifications from this integration.
| Info |
|---|
Giving permission to Jira Service Management The Atlassian ChatOps app will need permission to post alerts to your channels in Microsoft Teams. Select Give permission to complete this step, if requested, and continue to setting up your integration. |
Select Continue to save the integration. It will be ON by default.
Configure your integration as per your team’s preferences:
Edit integration settings to choose if alert actions show as buttons and to include additional alert fields in Microsoft Teams messages.
Add filters to receive only certain alerts. No filters are added by default. Read more about alert filters
Select the alert activity to get notified of on Microsoft Teams. All alert activity is selected by default.
Reset your Microsoft Teams integration
It’s not possible to directly change the selected Microsoft Teams workspace or the channel for an integration. But you can reset your integration to start over.
Once reset, your integration’s settings will be erased and alerts will no longer be sent to your Microsoft Teams channel. You’d have to set up the integration from scratch.
To reset your integration,
Go to Integrations on your team or your site’s Operations.
Open your Microsoft Teams integration from the list of all created integrations.
Select the More actions option and select Reset.
Once you’ve read the warning message explaining the implications of resetting the integration, select Confirm.
Wait until you’re redirected to start over from scratch.
Microsoft Teams commands for on-call actions
Mention the Atlassian ChatOps app (@AtlassianChatOps) and use the commands listed below to take actions on alerts and on-call work directly from your channels.
Configure or manage your Atlassian ChatOps app
configure
Acknowledge
ack alert <1 2...>
Unacknowledge
unack alert <1 2...>
Close
close alert <1 2...>
Snooze
snooze alert <1> for <number of m/h/d>
Add note
add note <note> to alert <1 2...>
Add tags
add tag <tag1, tag2...> to alert <1>
Add responder to alerts
add responder <user's email> to alert <1 2...>
Acknowledge all open alerts
ack all alerts
Acks up to 1000 alerts at a time that you have access to.
Close all open alerts
close all alerts
Closes up to 1000 alerts at a time that you have access to.
Assign alerts to you
assign alert <1 2...> to me
Assign alerts to someone
assign alert <1 2...> to <user's email>
Update alert priority
update priority of alert <1> to <P1/P2/P3/P4/P5>
Execute a custom action
execute <action> on alert <1 2...>
Create alert
create alert <message> for <team1 team2...>
View an alert’s details
alert <1>
View all alerts
all alerts
View a team’s alerts
all alerts of <team>
Escalate alerts
escalate alert <1 2...> to <policy>
View all integrations
all integrations
View all policies
all policies
View a team’s policies
all policies of <team name>
View all teams
all teams
Search teams
all teams <starts with/contains> <search term>
Turn on/off integration or policy
turn on <integration/policy name>
turn off <integration/policy name>
Assign on-call
assign oncall to <user's email/me> for <team/schedule/all>
Optionally, add for <number of m/h/d> at the end.
Check who is on-call
whoisoncall
Optionally, add for <schedule name> at the end.
Mute notifications for alerts and on-call
mute notifications to me
mute notifications to <user's email>
Optionally, add for <number of minutes> at the end.
Unmute notifications for alerts and on-call
unmute notifications to me
unmute notifications to <user's email>
Get help on Microsoft Teams
help