The StatusDashboard Google Chat integration allows you to automatically post messages to subscribed Google Chat spaces whenever creating or updating events. The Google Chat integration configuration settings include global settings and status dashboard specific settings, both of which are described below:
Global Settings
Global Google Chat settings apply globally to a StatusDashboard account, including any status dashboards.
|
Option |
Description |
|
Custom Content |
Integrations > Google Chat > Global Options > Custom Content By default, all Google Chat messages posted to subscribed spaces about events will include a direct link to the status dashboard. You also have the option of including additional information in the Google Chat 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 Google Chat message that is posted to a space when an event is created or updated. Google Chat Message An optional message that you would like to accompany Google Chat messages sent to subscribed spaces when events are created or updated. |
| Notifications |
Integrations > Google Chat > Global Options > Notifications When this option is disabled, the option to post Google Chat messages when creating or updating events will not be available. |
Status Dashboard Settings
Status dashboard Google Chat settings apply to specific status dashboards (i.e. each status dashboard within an account has its own specific Google Chat settings.
|
Option |
Description |
| Dashboard Subscription |
Integrations > Google Chat > Dashboard Specific Options > Dashboard Subscription [Dashboard] When this option is disabled, the Google Chat subscription option will not be available on the status dashboard. |
Managing Google Chat Subscriptions
The following options are available for managing Google Chat 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 Google icon. Enter a valid email address and Google Chat 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 Google Chat space will be subscribed to event Google Chat 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 Google icon, click the manage button and provide a valid email address (one that was previously registered with a Google Chat 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 > Google Chat > Dashboard Specific Options > Subscribers > [Dashboard] > Plus Icon. Any Google Chat 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 > Google Chat > 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 > Google Chat > Dashboard Specific Options > Subscribers [Dashboard]. From here, you may search subscribers, unsubscribe subscribers, confirm unconfirmed subscriptions, delete subscriptions and export the list of Google Chat webhook subscribers. |
Google Chat Delivery Reports
StatusDashboard maintains a record of every Google Chat message sent including the response code and response content from the Google Chat webhook endpoint. If you would like to review a record of sent Google Chat messages for your account, you may do so by navigating to Integrations > Google Chat > Global Options > Delivery Report. Click on the information icon to view detailed information about the message, including any relevant errors.
Google Chat Delivery Errors
Errors experienced by StatusDashboard when attempting to deliver Google Chat 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 Google Chat 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 Google Chat message to a subscribed webhook endpoint we will disable the endpoint and will not attempt further delivery until the subscriber takes action. Disabled Google Chat 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 Google Chat 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 Google Chat webhook endpoints are listed in our public StatusDashboard configuration file. This file is updated whenever our IP addresses change.