# Google Chat

Connect Google Chat for outbound event notifications.

Source: https://statusdashboard.com/docs/integrations/gchat

> This is a plan-gated feature. If it isn't available in your account, visit the [Billing](/docs/org-mgmt/billing) page or contact support to review your options.

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](/app/integrations/gchat/endpoints), or let visitors subscribe from a status dashboard when the channel is enabled.

For message format and delivery logs, see [Google Chat notifications](/docs/notifications/gchat). For the public `/subscribe` flow, see [Google Chat subscriptions](/docs/status-dashboards/subscriptions/gchat).

***

## 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](/app/integrations/gchat/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](#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](/app/notifications/gchat/logs) to review per-attempt outcomes.

Review or clear suppressed endpoints on [Google Chat suppression](/app/integrations/gchat/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](/app/integrations/gchat/suppression), or unsuspend from the public manage page, after fixing the Chat webhook. Clearing suppression does **not** resend missed notifications.

> Suppression blocks delivery to specific 
>   **endpoints**
>    until cleared. It is separate from 
>   **Pause deliveries**
>    (admin edit dialog only) and from turning 
>   **Notifications**
>    off on an event.