Versions Compared

Old Version 3

changes.mady.by.user Vaishnav Shravan (Deactivated)

Saved on

compared with

New Version Current

changes.mady.by.user Vaishnav Shravan (Deactivated)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Overview

What does the integration offer?

With Jira Service Management’s ChatOps app for SlackMicrosoft Teams, you can receive notifications for the alerts you care about, perform actions on the alerts, and manage some on-call work from your Slack Teams channels — using Slack buttons or the /jsmops commandcommands mentioning the app @Atlassian ChatOps.

You can add multiple Slack Microsoft Teams integrations to streamline alert notifications. For example, you can create an integration that notifies a Slack Teams channel only about high-priority alerts, and another integration that notifies a different Slack Teams channel about low-priority alerts.

How does the integration work?

Once your Jira Service Management site is connected to a Slack workspaceMicrosoft tenant, the Atlassian ChatOps app can be added to any channel (even private ones) or direct messages Standard channels where you’d like to receive alert notifications. Private channels aren’t supported.

  • Jira admins can set up Slack Microsoft Teams integrations for the site (to receive alerts that have no responder team added).

  • Team admins can set up Slack Microsoft Teams integrations for their teams (Slack 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 Slack workspace Microsoft tenant with your Jira site so you can use it for your integrations. Learn Read how to connect Slack workspacesyour Microsoft tenant

  • Make sure you’ve created the Slack Microsoft Teams channel or direct message to receive alert notifications.

Add

Slack

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 Slack Microsoft Teams integration from your team’s Operations page will only let you send notifications on Slack Microsoft Teams for your team’s alerts.

To get Slack notifications for alerts that have no responder teams assigned, you’ll need access to the feature through Settings (gear icon) > Products (under JIRA SETTINGS) > OPERATIONS > Global integrations — this feature is available only on Premium and Enterprise plans.

Add Slack 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 Slack 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 Slack Microsoft Teams from the list of all integrations.

Image RemovedImage Added

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. Learn Read how to reset your Slack 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. Slack workspaceYou can select ‘None’ to get notifications for alerts with no responder teams.

  • Microsoft tenant: Select the Slack workspace Microsoft tenant where your channels exist. If you don’t see your workspace, make sure you have joined the connected workspace, then, send /connect on any Slack channel or direct message.Slack channel or direct message: On selecting Select on Slack, you’ll be able to select a channel or direct message

  • 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. Select Allow to confirm your choice and give Jira Service Management requested permissions on Slack

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.

Image RemovedImage Added

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 Slack Microsoft Teams messages.

  • Add filters to receive only certain alerts. No filters are added by default. Learn Read more about alert filters

  • Select the alert activity to get notified of on SlackMicrosoft Teams. All alert activity is selected by default.

Image Removed

Image Added

Reset your

Slack

Microsoft Teams integration

It’s not possible to directly change the selected Slack Microsoft Teams workspace or the channel /direct messages for an integration. But you can reset your Slack integration to start over.

Once reset, your integration’s settings will be erased and alerts will no longer be sent to your Slack Microsoft Teams channel. You’d have to set up the integration from scratch.

To reset your integration,

  1. Go to Integrations on your team or your site’s Operations.

  2. Open your Slack Microsoft Teams integration from the list of all created integrations.

  3. Select the More actions option and select Reset.

    Image RemovedImage Added

  4. Once you’ve read the warning message explaining the implications of resetting the integration, select Confirm.

  5. Wait until you’re redirected to start over from scratch.

Slack

Microsoft Teams commands for on-call actions

Configure your Atlassian ChatOps app

configureMention the Atlassian ChatOps app (@Atlassian ChatOps) and use the commands listed below to take actions on alerts and on-call work directly from your channels.

Set up or manage Atlassian ChatOps for your Microsoft tenant

configure

Works only in direct messages with the app.

Connect your Atlassian account Microsoft

connect

Works only in channels.

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