The StatusDashboard Microsoft Teams integration allows you to automatically post messages to subscribed Microsoft Teams channels whenever creating or updating events. The Microsoft Teams integration configuration settings include global settings and status dashboard specific settings, both of which are described below:
Global Settings
Global Microsoft Teams settings apply globally to a StatusDashboard account, including any status dashboards.
|
Option |
Description |
|
Custom Content |
Integrations > Microsoft Teams > Global Options > Custom Content By default, all Microsoft Teams messages posted to subscribed channels about events will include a direct link to the status dashboard. You also have the option of including additional information in the Microsoft Teams 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 Microsoft Teams message that is posted to a space when an event is created or updated. Microsoft Teams Message An optional message that you would like to accompany Microsoft Teams messages sent to subscribed spaces when events are created or updated. |
| Notifications |
Integrations > Microsoft Teams > Global Options > Notifications When this option is disabled, the option to post Microsoft Teams messages when creating or updating events will not be available. |
Status Dashboard Settings
Status dashboard Microsoft Teams settings apply to specific status dashboards (i.e. each status dashboard within an account has its own specific Microsoft Teams settings.
|
Option |
Description |
| Dashboard Subscription |
Integrations > Microsoft Teams > Dashboard Specific Options > Dashboard Subscription [Dashboard] When this option is disabled, the Microsoft Teams subscription option will not be available on the status dashboard. |
Acquiring A Microsoft Teams Webhook Url
Microsoft Teams webhook Urls are unique for each Microsoft Teams channel into which you want to post StatusDashboard messages. Microsoft Teams webhook Urls for channels can be acquired in the Microsoft Teams client by navigating to Channel Options (click the ellipsis) > Workflows and selecting the Post to a channel when a webhook request is received option. Complete the following steps:
- Provide an appropriate name for the workflow (e.g. StatusDashboard).
- Select an appropriate user to run the workflow (most likely this will be the user that is configuring the workflow).
- Click the Next button.
- Select the team that contains the channel into which you want to post messages.
- Select the desired channel.
- Click the Add workflow button.
- Copy the provided webhook url. This is the Url that will be added to StatusDashboard when subscribing this channel to notifications.
Managing Microsoft Teams Subscriptions
The following options are available for managing Microsoft Teams subscriptions, all of which are specific to individual status dashboards.
|
End Users |
Subscribe Navigate to the dashboard, click the Subscribe button on the dashboard page and select the Teams icon. Enter a valid email address and Microsoft Teams webhook Url and select one or more services to subscribe to. We'll send a confirmation email with a validation link which when clicked, will confirm the subscriptions. Once confirmed, the Microsoft Teams channel will be subscribed to event Microsoft Teams messages and will receive any relevant alerts that you broadcast when managing events. Manage Subscriptions Navigate to the dashboard, click the Subscribe button on the dashboard page, select the Teams icon, click the manage button and provide a valid email address (one that was previously registered with a Microsoft Teams webhook Url). We'll send a validation email which will provide access to add and/or delete subscriptions to specific services on the dashboard. You'll also be able to re-enable a disabled endpoint. |
|
StatusDashboard Administrators |
Manual Subscribe Navigate to Integrations > Microsoft Teams > Dashboard Specific Options > Subscribers > [Dashboard] > Plus Icon. Any Microsoft Teams webhook Urls added here will be immediately subscribed to the associated services. Please be aware that these manually added webhook Urls can be unsubscribed from alerts through the standard StatusDashboard unsubscribe process by your end users. Manage Endpoints Navigate to Integrations > Microsoft Teams > Dashboard Specific Options > Endpoints > [Dashboard]. From here, you may search, test, enable and delete endpoints as well as trigger management emails to the email address of record for a particular endpoint. Manage Subscriptions Navigate to Integrations > Microsoft Teams > Dashboard Specific Options > Subscribers [Dashboard]. From here, you may search subscribers, unsubscribe subscribers, confirm unconfirmed subscriptions, delete subscriptions and export the list of Microsoft Teams webhook subscribers. |
Microsoft Teams Delivery Reports
StatusDashboard maintains a record of every Microsoft Teams message sent including the response code and response content from the Microsoft Teams webhook endpoint. If you would like to review a record of sent Microsoft Teams messages for your account, you may do so by navigating to Integrations > Microsoft Teams > Global Options > Delivery Report. Click on the information icon to view detailed information about the message, including any relevant errors.
Microsoft Teams Delivery Errors
Errors experienced by StatusDashboard when attempting to deliver Microsoft Teams messages to configured webhook endpoints are reported in the following ways:
|
Option |
Description |
| End Users |
Any error (for example, connectivity errors, or a non-HTTP200 response) experienced when attempting to deliver a Microsoft Teams message to a subscribed endpoint is tracked and logged with a notification email message being sent to the subscriber management email address. If we experience 5 consecutive errors in delivering a Microsoft Teams message to a subscribed webhook endpoint we will disable the endpoint and will not attempt further delivery until the subscriber takes action. Disabled Microsoft Teams webhook endpoints can be re-enabled from the StatusDashboard administrative interface, or the subscriber can re-enable it by following the manage procedure from the status dashboard subscription page. |
| StatusDashboard Administrators |
All Microsoft Teams delivery errors are sent immediately to StatusDashboard administrators who are subscribed to receive errors reports. To subscribe to alerts, navigate to User Profile > User Profile Options > Notifications > Notification Errors. |
Source IP Addresses
IP addresses from which we will access the Microsoft Teams webhook endpoints are listed in our public StatusDashboard configuration file. This file is updated whenever our IP addresses change.