Google Chat

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. For message format and delivery logs, see Google Chat notifications.

---

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 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.

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

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.