Google Chat
Connect Google Chat for outbound event notifications.
Google Chat integration delivers event notifications to a Chat space via a webhook URL you create in the target space. Register endpoints from Google Chat endpoints, or let visitors subscribe from a status dashboard when the channel is enabled.
For message format and delivery logs, see Google Chat notifications. For the public /subscribe flow, see Google Chat subscriptions.
Endpoint URL rules
Google Chat endpoints must match:
https://chat.googleapis.com/v1/spaces/{space}/messages?key=…&token=…Both key and token query parameters are required. Create the URL from Apps & integrations → Webhooks in the target Chat space.
StatusDashboard rejects private, loopback, and link-local destinations. Webhook URLs contain secrets — list views show a redacted url display only. The full URL is returned once on admin create responses.
Managing subscribers
Organization admins and users with the subscriber role can register pre-verified Chat endpoints on Google Chat endpoints. No verification email is sent for admin-created rows.
| Field | Meaning |
|---|---|
| Dashboard | Status dashboard the subscription belongs to |
| Google Chat webhook URL | Space webhook URL (validated per rules above) |
| Management email | Contact for verify/manage flows; receives a failure alert email when an endpoint is auto-suppressed (see Suppression) |
| Components | At least one component on that dashboard |
| Pause deliveries | When paused, event notifications are skipped for this endpoint until an admin resumes delivery from the edit dialog (pencil icon on the row) |
| Admin-managed (locked) | When locked, public subscribe/manage flows cannot change the subscription |
Use the pencil icon on a row to change components, pause or resume deliveries, or toggle the locked flag. The list icon shows the current component selection read-only.
Suppression
After 5 consecutive failed event-notification deliveries, StatusDashboard automatically suppresses the endpoint:
- Future deliveries are skipped until suppression is cleared.
- The subscriber row shows a suppressed status.
- The management email receives one alert email (not one email per failed delivery).
StatusDashboard does not email the management address for individual failures before suppression. Use Google Chat delivery logs to review per-attempt outcomes.
Review or clear suppressed endpoints on Google Chat suppression.
Failure alert email
When suppression triggers, the management email receives a message that Google Chat notifications were disabled for that endpoint. The email includes:
- The status dashboard name and a redacted endpoint display (never the full webhook URL)
- The consecutive failure count that triggered suppression
- The last failure reason when available (for example,
HTTP 503) - A Manage subscription link when a signed manage URL is available; otherwise instructions to request a new manage link from the status page
Clear suppression entries on Google Chat suppression, or unsuspend from the public manage page, after fixing the Chat webhook. Clearing suppression does not resend missed notifications.