• Products
  • Get started
  • Documentation
  • Resources

Integrate Opsgenie with Slack App


Slack logo

Watch this video: Managing Opsgenie alerts in Slack

What does Opsgenie offer Slack users?

Opsgenie has a bidirectional integration with Slack. It's easy to configure and powerful: notifications of Opsgenie’s robust alerts go right into your Slack channel. In turn, users can acknowledge, close, or assign these alerts from the channel, as easily as entering a command like /genie ack 12.

Add a Slack integration in Opsgenie, and in seconds have combined Slack's easy-to-use team collaboration platform with Opsgenie’s rich alert notification system and on-call rotation. Execute actions on the alert just by typing a /genie command, into the chat.

There's more to be accomplished in Opsgenie just by entering simple commands to Slack channel. Using /genie command, mute Opsgenie notifications, get alert details, view on-call schedules, and more.

Now with the new Slack buttons, Opsgenie users can acknowledge, un-acknowledge, or close alerts with just a button click.

"Require Matching a User" option is used to force matching Slack accounts with Opsgenie accounts. Chat user mapping section addresses this issue.

Install Slack App

  1. Go to Slack App's integration page.

An alternative for this step is to add the integration from the Team Dashboard of the team which will own the integration. To add an integration directly to a team, navigate to the Team Dashboard and open Integrations tab. Click Add Integration and select the integration that you would like to add.

Under the Free and Essentials plans, the tabs under the Team dashboard are limited to Main, Integrations, Members, and Activity Stream.

2. Click Add to Slack.

Slack setup

3. Select "Slack Team" and "Channel".

4. Click Authorize to give access to Opsgenie’s Slack App.

Authorize Slack app

5. The integration is automatically created. (If not logged into Opsgenie, log in.)

6. Note that permission is required to add integration in Opsgenie.

Slack settings

7. Modify the alert message that is sent to the Slack channel. In the Slack Integration's page, users have a choice to send description, tags, and routed teams information to a Slack message.

Slack message modifier

Slack Buttons

  1. Using Slack buttons is optional. Disable it on integration's edit page by using the "Use Slack Buttons" option.

  2. Message with Slack buttons look like:

Slack new alert

Slack messages will have a stripe on the left side of the message, in either the color green, red, or blue. Green means closed, red means open, and blue means acknowledged or update priority. The colors update as actions are taken, and any related alerts will also update in color.

3. AcknowledgeUn-acknowledge or Close alerts.

4. Close mass notifications.

5. If an alert is already acknowledged, un-acknowledged, or closed, the relevant response is sent in Slack and buttons are changed accordingly.

Slack alert ack

Slack Message Menu

  1. Message menus are built on Slack's interactive message framework just like Slack buttons. A user's "Using Slack Buttons" preference also applies to message menu.

Slack menu

2. Execute assigntake ownershipsnooze, and add note actions on alerts. According to the selection, the message is updated to proceed further. For example, after the "Add Note" option is selected, a dialog box appears to enter a note as shown below.

Slack add note

3. Message menu is updated according to actions taken. The result of the action is posted to the channel.

Slack menu

"Execute Commands" Option

  1. "Execute Commands" option is used to determine the integration which executes the genie command.

  2. The reason to do so is that Slack registers slash commands for the whole team, but more than one Opsgenie integration can be installed in Slack.

  3. Only one Slack integration can have "Execute Commands" checked for a Slack team.

  4. "Require Matching a User" option is determined by the same integration that has "Execute Commands" option selected as slash command will be associated with this integration.

Chat User Mapping

  1. "Require Matching a User" is used to force matching Slack accounts with Opsgenie accounts.

  2. Associate Slack accounts to Opsgenie accounts by using the /genie connect command. If using the Opsgenie EU instance, please use /eugenie connect command instead.

  3. Chat user mapping flow:

Slack connect account
Slack successful connect

Using /genie Command

If using the Opsgenie EU instance, please use /eugenie command instead of /genie command.
For example, for acknowledging an alert, run the following command:
/eugenie ack [tinyID tinyID2..]

Easily execute actions on Opsgenie alerts by entering a command with the tinyId of the alert into a Slack room. It is possible to execute a single command on multiple alerts.

Create alerts, too. Use the alert command to create an alert in Opsgenie, right from the Slack channel.

Acknowledge Alert :

/genie ack [tinyID tinyID2..]


/genie ack 1

/genie ack 1 2 3

Close Alert :

/genie close [tinyID tinyID2..]


/genie close 1

/genie close 1 2 3

Add Note to Alert :

/genie note [note] to [tinyID tinyID2..]


/genie note this is note to 1

/genie note this is note to 1 2 3

Add Tag to Alert :

/genie addtag [tag1,tag2,..] to [tinyID tinyID2..]


/genie addtag high priority,important to 1

genie addtag high priority,important to 1 2 3

Acknowledge All Open Alerts :

/genie ackall

Close All Open Alerts :

/genie closeall

Assign Alert :

/genie assign [tinyID tinyID2..] to [user]


/genie assign 1 to john.smith@acme.com

/genie assign 1 2 3 to john.smith@acme.com

Take Ownership of Alert :

/genie own [tinyID tinyID2..]


/genie own 1

/genie own 1 2 3

Update Priority of Alert:

/genie update priority to [P1, P2, P3, P4 or P5] for [tinyID]


/genie update priority to P2 for 1341

Execute Action :

/genie exec [action] on [tinyID tinyID2..]


/genie exec customAction on 1

/genie exec customAction on 1 2 3

Create Alert :

/genie alert [alert message] for [team1,team2,user1..]


/genie alert this is alert message for john.smith@acme.com

/genie alert this is alert message for integration team, product team

/genie alert this is alert message for myTeam, john.smith@acme.com

Get Alert :

/genie get [tinyID]


/genie get 1

List Alerts :
Lists all open alerts.

/genie list

Lists all open alerts of a specified team.

/genie list alerts of team1

List Integrations :

/genie list integrations

List Policies :

/genie list policies

List Teams :

/genie list teams

/genie list teams contains [search query]

/genie list teams starts with [search query]

Enable Integration/Policy :

/genie enable [name]


/genie enable policy

Disable Integration/Policy :

/genie disable [name]


/genie disable policy

Take On-call :
Takes on-call for the specified amount of time for the team or schedule. The default amount of time is 1h. If no schedule/team is specified, the user will take on-call for his team's schedule, or a single schedule he's participant in.

/genie oncall [me/user] [h/m/d] for [team/schedule/all]

Sample uses are:

/genie oncall me 2h for weekend_schedule

/genie oncall john.smith@acme.com 1d for ops_team

/genie oncall me 2h for all

/genie oncall me 45m

/genie oncall me

Who is oncall :
Retrieves oncall user information from all schedules

/genie whoisoncall

Mute :
Mutes notifications for the user. Mutes for 5 minutes if not given.

/genie mute [me/username] [minutes(optional)]


/genie mute john.smith@acme.com

/genie mute john.smith@acme.com 15

Unmute :
Clears mute setting.

/genie unmute [me/username]


/genie unmute john.smith@acme.com

Connect :
Connect your Opsgenie account to your chat account. If a connection exists, the currently connected Opsgenie user will be shown and you can choose to disconnect

For more details see the Chat User Mapping documentation page.

/genie connect

Help :

/genie help

Slack command


If the person who added the Opsgenie integration to a private Slack channel leaves the channel, create alert notifications from Opsgenie might stop showing up in the channel. In this case, please use the resynchronize button at the end of the instructions which is available in your Slack integration's configuration page.

Slack integration resynchronize

Slack App Integration Update

Opsgenie is updating the Slack app for alerting to leverage the latest updates of Slack. The update will take place on November 17, 2020. Your existing Slack integrations will not be affected by this update, however, we highly recommend to resynchronize your existing Slack apps after this date to get the latest update.

We are updating our Slack app for alerting to support Granular Bot Permissions in Slack.
Before granular permissions, Slack apps were issued a blanket set of scopes, and had to request access to information they probably didn’t need. Now, with granular permissions, apps can specify only the exact scopes needed for them to function.
The granular scopes give administrators and users a clearer idea of what an app actually does with their data and how the APIs are used. It also increases security, when you approve granular scopes for an app, you are making sure that the app can only perform those granular operations that you have approved.
Your existing Slack integrations will not be affected by this update. However, we highly recommend to resynchronize your existing Slack apps after November 17, 2020 to have the latest update for increased security and to receive new functionalities within the app automatically that may be introduced in the future.

The integrations added after November 17, 2020 will have the changes explained below by conversation type:
Personal Direct Message: A new direct message will be created between yourself and the Opsgenie bot. New messages will appear under the apps section
Private and Public Channels: Opsgenie bot will be invited to the channel that the integration is added to.
Direct Message with Multiple persons: A new group direct message will be created between direct message members and the Opsgenie bot. Usage of this type of conversation is not recommended, use private channels instead.


Last modified on Jun 18, 2021
Cached at 4:20 AM on Oct 27, 2021 |

Additional Help