The StatusDashboard Slack integration allows users to subscribe to Slack alerts for one or more services and Slack channels, which can be triggered whenever creating or updating events. The Slack integration configuration settings include global settings and status dashboard specific settings, both of which are described below:
Global Settings
Global Slack settings apply globally to a StatusDashboard account, including any status dashboards.
Option |
Description |
Custom Content |
Integrations > Slack > Global Options > Custom Content By default, all Slack messages posted to channels about events will include an icon indicating whether the event is an incident or scheduled maintenance as well as a direct link to the status dashboard. You also have the option of including additional information in the Slack message by configuring the options below. These options will be the default settings when events are created and will persist with the event once set (although you can change these settings on the event at any time). Enable / Disable Event Details When enabled, all current event details will be included in the Slack message that is posted to a channel when an event is created or updated. Slack Message An optional message that you would like to accompany Slack messages sent to your channels when events are created or updated. |
Notifications |
Integrations > Slack > Global Options > Notifications Enable / Disable Slack Notifications When this option is disabled, the option to broadcast Slack messages when creating or updating events will not be available to StatusDashboard administrators but new Slack subscriptions to status dashboards will still be processed. |
Status Dashboard Settings
Status dashboard Slack settings apply to specific status dashboards (i.e. each status dashboard within an account has its own specific Slack settings.
Option |
Description |
Dashboard Subscription |
Integrations > Slack > Dashboard Specific Options > Dashboard Subscription > [Dashboard] Enable / Disable Slack Subscriptions When this option is disabled, the Slack subscription option will not be available on the status dashboard. |
Managing Slack Subscriptions
The following options are available for managing Slack subscriptions, all of which are specific to individual status dashboards.
End Users |
Subscribe Navigate to the status dashboard, click the Subscribe button on the dashboard page and select the Slack icon. Click the Add to Slack button and follow the steps to authorize the StatusDashboard Slack App for your Slack workspace. Once the StatusDashboard Slack app is authorized, you will be redirected back to the status dashboard where you can subscribe services and Slack channels to notifications. Any selected Slack channels will receive notifications whenever events impact the selected services.
Note: In order to send notifications to subscribed Slack channels, the StatusDashboard Slack app must also be added to the channel(s) within the Slack workspace.
Manage Subscriptions Navigate to the dashboard, click the Subscribe button on the dashboard page, select the Slack icon, click Add to Slack button and follow the steps to authorize the StatusDashboard Slack App. Once you are redirected back to the status dashboard, you will be able to add/remove services/channels from your subscriptions.
Note: All Slack users within the same Slack workspace will see, and be able to view, the same subscriptions for the StatusDashboard App within the workspace.
|
StatusDashboard Administrators |
Manual Subscribe There is currently no manual subscription method for adding Slack channels to subscriptions. All subscriptions must be managed through the status dashboard. Manage Subscriptions Navigate to Integrations > Slack > Dashboard Specific Options > Subscribers > [Dashboard]. From here, you can search subscribers, remove subscribers and send test Slack messages to subscribed channels. |
Delivery Errors
If you would like to be notified of errors in the delivery of Slack messages, you can subscribe to receive email notification alerts. Once subscribed, we'll quickly notify you if we experience any errors that would indicate a problem with Slack, or a misconfigured integration with any of your customers. To subscribe to alerts, navigate to User Profile > Options > Notifications > Notification Errors.
Slack Delivery Reports
StatusDashboard maintains a record of every Slack message sent including delivery status, channels and error messages (where applicable). If you would like to review a record of sent Slack messages for your account, you may do so by navigating to Integrations > Slack > Global Options > Delivery Report.
Source IP Addresses
IP addresses from which we will access the Slack API are listed in our public StatusDashboard configuration file. This file is updated whenever our IP addresses change.