Skip to main content
Setup time: 10 Min
Integrate your Mattermost Server with All Quiet for efficient incident management right from within Mattermost.
The first part of this documentation focuses on creating the integration. The second explains how to send All Quiet incidents to your Mattermost channels (Outbound). Want to create new incidents from your Mattermost channels (Inbound)? Follow the third part of this guideline.

​
Create Outbound Integration

  1. Click on the Outbound Integrations tab.
  2. Click on + Create.
  1. Enter a Display Name for your integration, e.g. “Mattermost”.
  2. Select a Team.
    For Organizations with Pro and Enterprise plan: This is going to be the root team of your integration. You will be able to add additional teams in the next step.
  3. Select Mattermost as the integration’s type.
  4. Forwarding settings:
    1. Default: Always will automatically forward all incidents to your Mattermost Server, unless excluded by advanced routing rules.
    2. Alternative: Always After Forwarding - Messages will only be sent if users manually forward specific incidents or if you set up advanced routing rules that automatically forward incidents in specific scenarios. After the initial Forwarding, all updates will automatically be sent.
      You can change your selection anytime.
  5. Click Create Outbound Integration.

​
Send All Quiet Incidents to Mattermost

Once you’ve successfully created your new outbound integration, you’ll automatically be redirected to its Settings page.
  1. Observe that the installation status is still pending.
  2. To activate the outbound integration, enable the toggle Send incidents to Mattermost and follow the next steps in this guide.
  3. To activate the inbound integratoin, enable the toggle Create incidents from Mattermost and follow this part of the setup guide.
In the Edit tab, you can change general settings like the integration’s Forwarding settings.
Only for Pro and Enterprise plan - Manage your Team Connections: The root team is pre-selected, and you can add the integration to further teams within the root team’s organization. Team Administrators can add / remove those teams they are an Administrator in, Organization Administrators & Organization Owners can manage the connections to all teams of the organization.
After enabling Send incidents to Mattermost to send All Quiet incidents to Mattermost, you add a bit more information.
  1. Add the URL of your Mattermost server.
  2. Click Save.
To activate the integration, we need to create a Bot on Mattermost in the next step and paste the Bot’s access token into our integration settings in All Quiet. In Mattermost
  1. Open the menu in the top left corner.
  2. In the menu, select Integrations.
Next, select Bot Accounts as integration type. Click Add Bot Account.
  1. Give your Bot a descriptive Username, like “all_quiet”.
  2. You may want to add our Logo as Bot Icon.
  3. Optionally, you can add a descriptive Display Name that adds more information than the Username, like “All Quiet Incidents” or “Incident from All Quiet”.
  4. “Member” Role is sufficient.
  5. We recommend to enable post:all to enable the Bot to post into a maximum number of channels.
  6. Finish the setup by clicking Create Bot Account.
Copy the genererated access Token. You will need it in the next step to activate the connection in All Quiet. Back in your Mattermost Integration setting in All Quiet,
  1. paste the Token into the Bot Access Token field.
  2. Save your settings.
Now, before we can add the integration to your Mattermost channels, we need to add the Bot to your Mattermost team(s). To add the Bot to your Mattermost teams, go back to Mattermost.
  1. Open the menu in the top left corner.
  2. In the menu, select System Console.
In the sidebar, select User Management > Teams (1). Select the team you want to add the Bot to and click Edit. On the Team Configuration page, scroll down to the Members section. Click Add Members.
  1. Select the Bot from the list.
  2. Click Add.
Save your team configuration with your newly added member. Now, open the your Mattermost Integration settings in All Quiet.
You might need to refresh the screen to see the new options
  1. As you can see, we successfully added the Bot to your Mattermost Team in the last step. Select the Mattermost Team you want to connect and send incidents to.
  2. Now it’s time to select the Mattermost Channels you want to sent incidents to. You can decide to either
    • Send all incidents to the same channels.
    • Select different channels based on incident severity.
  3. Select the Channels.
    You need to invite the Bot to the desired Mattermost channels first. After that, the channels will appear in All Quiet, and you can select them. This works for both public and private channels.
  4. You can change your integration settings to “Read Only”. In this mode, we will not send any action buttons to Mattermost, meaning users cannot interact with the messages. This is ideal if you want to use the integration for internal stakeholder management.
  5. Save your integration Settings.
Your outbound integration is now fully set up. Now it’s time to send incidents to your Mattermost channels.

​
Engage with Incidents Directly in Mattermost

Only Teams that are connected with the integration in All Quiet will send their incidents to Mattermost. You can always change the current settings via the Team Connections page.
After finishing the setup, our integration sends an interactive message to your designated Mattermost channels. This allows you to manage incidents seamlessly, mirroring the experience on our iOS, Android, and Web Apps, all without leaving Mattermost.
For compliance reasons, only Users with rights in the All Quiet team(s) connected to the incident can interact with the Message. Additionally, if users create incidents manually they can alway interact with the specific incident no matter which team(s) are assigned.
Mattermost is now integrated with All Quiet, simplifying incident management by consolidating notifications and actions in one place.

​
Create Incidents from Mattermost

You can create All Quiet incidents from Mattermost using custom slash commands. To create All Quiet incidents from Mattermost,
  1. enable the respective toggle in your Mattermost integration settings in All Quiet.
  2. Note that we need to genererate a Slash command secret token and past it here. We will generate the token in the next steps.
  3. Copy the Slash command URL by clicking on it. You will need it to connect the Mattermost slash command with All Quiet.
Back in Mattermost
  1. Open the menu in the top left corner.
  2. In the menu, select Integrations.
This time, select Slash Commands as integration type. Click Add Slash Command.
  1. Add a Title for the slash command, like Create All Quiet Incident.
  2. You may add a Description.
  3. Define the Command Trigger Word. Select something that is easy to remember and descriptive enough for you users to understand what the command does, e.g. allquiet_incident.
    If you add more than one Mattermost integration to your All Quiet Organization, you will need to add different slash commands for each integration. Use descriptive commands, e.g. include the connected All Quiet Teams in the command.
  4. Paste in the Request URL. This is the Slash command URL you copied on All Quiet.
  5. As request method, select Post.
  6. We recommend activating Autocomplete. When activated, your users will see the full command after typing ”/”. You can even add Autocomplete Hintsor Autocomplete Descriptions to clarify what the slash command does.
  7. Save the slash command.
Copy the genererated Token. You will need it in the next step to connect the command with All Quiet. Back in All Quiet,
  1. paste the Slash command secret token into your Mattermost integration settings.
  2. Save your settings.
Now, your users can create All Quiet incidents from your Mattermost channels.
Here’s how it works:
  1. Once typing ”/” into the input field,
  2. the autocomplete function shows the newly created slash command. Select it and click enter.
The command opens a pop-up window in which you can create the incident.
  1. Choose the team you want to create the incident in.
    For compliance reasons, Users will only be able to select from the All Quiet teams they have roles in and that are connected to the Mattermost integration.
  2. Select the severity of the incident.
  3. Add the Incident Title.
  4. Optional and recommended: Add a Description to give context.
  5. Click Creat Incident to create the incident in All Quiet.
The incident is successfully created in the selected All Quiet team and triggers it’s escalations.

​
Hints and Troubleshooting

  • Deactivating the Toggles to Send incidents to Mattermost / Create Incidents from Mattermost does not delete saved settings or tokens but simply pauses outbound / inbound functionality.
  • If you set up > 1 Mattermost outbound integration and two bots are in the channel, there will only be one incident message (sent by the first bot who was triggered) that users of both bots can interact with.