# Google Chat

Let visitors subscribe a Google Chat webhook on your status dashboard.

Source: https://statusdashboard.com/docs/status-dashboards/subscriptions/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.

This page covers the public **Subscribe** and manage flows for Google Chat on your status dashboard. For endpoint URL rules, admin registration, and suppression, see [Google Chat integrations](/docs/integrations/gchat). For message format and delivery logs, see [Google Chat notifications](/docs/notifications/gchat).

***

## What visitors see
Google Chat subscriptions let visitors register a Chat space webhook URL and receive card/text updates when matching events are created or updated.

On `/subscribe`, visitors with the Google Chat channel effectively enabled see a **Google Chat** tab where they:

1. Paste a **Google Chat webhook URL** (from Apps & integrations → Webhooks in the space).
2. Enter a **management email** used for verification, manage links, and delivery-failure alerts.
3. Select one or more **components** from your dashboard (grouped when component groups are enabled).
4. Accept consent and terms checkboxes.
5. Complete the **reCAPTCHA** check when the dashboard is public (SSO off).
6. Click **Subscribe**.

Endpoints must include both `key` and `token` query parameters — see [Endpoint URL rules](/docs/integrations/gchat#endpoint-url-rules) for the required URL shape.

They must select at least one component to complete a new subscription. On public dashboards, **Subscribe** stays disabled until reCAPTCHA is completed.

Below the subscribe form, an **Already subscribed?** section lets returning managers enter their management email and click **Manage** to receive a link for updating preferences.

## Double opt-in (verification)
Google Chat subscriptions use **double opt-in** via the management email:

1. The visitor submits the subscribe form.
2. StatusDashboard stores a **pending** subscriber record and sends a verification email.
3. The visitor clicks the link (`/subscribe/verify?token=…`).
4. The subscription is **activated** and the visitor is redirected to a management page.

Verification links expire after **24 hours**.

## Managing preferences
After verification — or after requesting a manage link — visitors land on `/subscribe/manage?token=…` (token valid for **1 hour**). Managers can change components (deselecting all stops notifications without deleting the subscription), clear suppression after fixing a broken webhook (**Resume deliveries**), or request a new manage link later.

When a tenant admin has **paused deliveries** for this endpoint in the admin console, the manage page shows a read-only notice. Visitors cannot clear that pause from manage; they can still change component selections while paused.

Each new verification or manage-link email **revokes** any previous management link for that subscriber.

### Pausing deliveries
Google Chat subscriptions support pausing deliveries in a few different ways.

| Who                        | How deliveries stop                                                                                                                                            |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Tenant admin**           | **Pause deliveries** in the admin console ([Managing subscribers](/docs/integrations/gchat#managing-subscribers)). Component selections stay unchanged.        |
| **Visitor (manage page)**  | Deselect all components and save.                                                                                                                              |
| **Platform (suppression)** | After repeated delivery failures ([Suppression](/docs/integrations/gchat#suppression)). Use **Resume deliveries** on the manage page after fixing the webhook. |

Admin pause, an empty component selection, and suppression are independent. Clearing suppression does not resume an admin pause.

## Subscriber limits
* Each **new** unique endpoint consumes one slot at sign-up time.
* The same endpoint on a second dashboard does **not** use an additional slot.
* When the limit is reached, new endpoints are rejected; existing endpoints may still subscribe on other dashboards.

## What admins control vs. what visitors control
| Setting                                       | Controlled by                                                                     |
| --------------------------------------------- | --------------------------------------------------------------------------------- |
| Whether Google Chat subscriptions are offered | Plan (**integrations**) + dashboard **Subscriptions** tab toggle                  |
| Which components an endpoint watches          | Visitor (unless **admin-managed / locked**)                                       |
| Pause deliveries (integration flag)           | Tenant admin only — see [Pausing deliveries](#pausing-deliveries) above           |
| Admin-managed (locked) subscriptions          | Admin — [Google Chat integrations](/docs/integrations/gchat#managing-subscribers) |

## Security notes
* Google Chat webhook URLs contain `key` and `token` secrets. Treat manage links like password-reset links.
* List views show a redacted endpoint display only.
* Public dashboards require reCAPTCHA on subscribe and manage-request forms; SSO-protected dashboards use the IdP session instead.