• Get started
  • Documentation

Integrate with Slack

This article highlights a new alerting feature that's natively available in Jira Service Management which is gradually rolling out to some Jira Service Management Cloud customers. It may not yet be visible or available on your site.

Logo of Slack app

What does the integration offer?

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

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

How does the integration work?

Once your Jira Service Management site is connected to a Slack workspace, the ChatOps app can be added to any channel (even private ones) or direct messages where you’d like to receive alert notifications.

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

  • Team admins can set up Slack 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 with your Jira site so you can use it for your integrations. Learn how to connect Slack workspaces

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

Add a Slack integration

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 integration from your team’s Operations page will only let you send notifications on Slack 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 — this feature is available only on Premium and Enterprise plans.

Add Slack to your Jira site

  1. Go to Settings > Products.

  2. Select Integrations from the sidebar (under Operations). You’ll be able to view already added integrations of all teams on the Jira site.

  3. Select Add integration.

  4. Select Slack from the list of all integrations. 

Add Slack for your team

  1. 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.

  2. Select Integrations from the sidebar, and select Add integration.

  3. Select Slack from the list of all integrations. 

Slack alerting integration

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 how to reset your Slack 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 workspace: Select the Slack workspace 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 to receive alert notifications from this integration. Select Allow to confirm your choice and give Jira Service Management requested permissions on Slack.

  • Select Continue to save the integration. It will be ON by default.

 

Configure your integration as per your team’s preferences:

  1. Edit integration settings to choose if alert actions show as buttons and to include additional alert fields in Slack messages.

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

  3. Select the alert activity to get notified of on Slack. All alert activity is selected by default. 

Reset your Slack integration

Reset Slack integration

It’s not possible to directly change the selected Slack 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 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 integration from the list of all created integrations.

  3. Select the More actions option and select Reset

  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 commands for on-call actions

Log in to your Atlassian account

/connect

 

Acknowledge

/jsmops ack alert <1 2...>

 

Unacknowledge

/jsmops unack alert <1 2...>

 

Close

/jsmops close alert <1 2...>

 

Snooze

/jsmops snooze alert <1> for <m/h/d>

 

Add note

/jsmops add note <note> to alert <1 2...>

 

Add tags

/jsmops add tag <tag1, tag2...> to alert <1>

 

Add responder to alerts

/jsmops add responder <user's email> to alert <1 2...>

 

Acknowledge all open alerts

/jsmops ack all alerts

Acks up to 1000 alerts at a time that you have access to.

 

Close all open alerts

/jsmops close all alerts

Closes up to 1000 alerts at a time that you have access to.

 

Assign alerts to someone

/jsmops assign alert <1 2...> to <user's email>

 

Update alert priority

/jsmops update priority of alert <1> to <P1/P2/P3/P4/P5>

 

Execute a custom action

/jsmops execute <action> on alert <1 2...>

 

Create alert

/jsmops create alert <message> for <team1 team2...>

 

View an alert’s details

/jsmops alert <1>

 

View all alerts

/jsmops all alerts

 

View a team’s alerts

/jsmops all alerts of <team>

 

Escalate alerts

/jsmops escalate alert <1 2...> to <policy>

 

View all integrations

/jsmops all integrations

 

View all teams

/jsmops all teams

 

Search teams

/jsmops all teams <starts with/contains> <search term>

 

Turn on/off integration or policy

/jsmops turn on <integration/policy name>

/jsmops turn off <integration/policy name>

 

Assign on-call

/jsmops 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

/jsmops whoisoncall

Optionally, add for <schedule name> at the end.

 

Mute notifications for alerts and on-call

/jsmops mute notifications to me

/jsmops mute notifications to <user's email>

Optionally, add for <number of minutes> at the end.

 

Unmute notifications for alerts and on-call

/jsmops unmute notifications to me

/jsmops unmute notifications to <user's email>

 

Select the Jira Service Management to run your commands

/jsmops select site for commands

This command is only applicable to you if you have connected multiple Jira Service Management sites to your Slack workspace.

 

Create incident timeline in Slack with Atlassian Intelligence

 /jsmops create timeline

Read more about creating incident timelines in Slack.

 

Summarize an incident in Slack with Atlassian Intelligence

 /jsmops summarize incident

Read more about summarizing incidents in Slack.

 

Get help on Slack

/jsmops help

Still need help?

The Atlassian Community is here for you.