Skip to main content

Introduction

Mattermost Integration allows you to:
  • Create and manage an incident directly from Mattermost using slash commands
  • Automatically create Mattermost channel when new incident is declared in Rootly

Installation

Let’s create an Oauth2 client

Menu > Integrations

OAuth 2.0

Configuration

https://rootly.com/auth/mattermost/callback https://rootly.com/auth/sign_in_mattermost/callback And finally copy client_id and client_secret into Rootly configuration

Configuration

Rootly allows you to customize your Mattermost integration. To do so, navigate to the configuration modal (Configuration > Integrations > Mattermost > Configure) CleanShot 2025-09-26 at 11.17.09.png You can customize how you want the incident channels to be named, what data to collect on incident creation, etc. CleanShot 2025-09-26 at 11.18.57.png

Connect to Rootly

Every user who wishes to use Rootly through Mattermost will have to perform this step.
After successfully installing Mattermost, run /incident connect command to establish a connection between your Rootly org and your Mattermost account. Click on the Connect now bot message following the command. CleanShot 2025-09-26 at 10.52.57.png Click on Allow to authortize access. CleanShot 2025-09-26 at 10.53.30.png Now you’re ready to manage incidents on Rootly through Mattermost!

Manage Incidents

Declaring an Incident

To declare a new incident, use the /incident new command. You can make execute this command in any channel. You’ll be prompted on create a new incident. CleanShot 2025-09-26 at 11.08.52.png This will result in an incident being created in Rootly and a designated channel created in Mattermost.

Mitigating an Incident

To mark an incident as mitigated, use the /incident mitigate command.
You’ll have to execute this command in the incident-specific channel created from the previous step.
CleanShot 2025-09-26 at 11.12.10.png

Resolving an Incident

To mark an incident as resolved, use the /incident resolve command.
You’ll have to execute this command in the incident-specific channel created from the previous step.
CleanShot 2025-09-26 at 11.13.08.png

List of Commands

If you ever forget what commands are available, you can run /incident help to get a reminder of the available commands. As Rootly adds more commands, this list will grow. CleanShot 2025-09-26 at 11.15.07.png

Uninstall

You can uninstall this integration in the integrations panel by clicking Configure > Delete
I