- Open the space in Google ChatIn a browser, open chat.google.com and go to the space that should receive alerts.
- Add a webhookOpen the menu next to the space name, choose Apps & integrations, then Add webhooks. Enter a name and choose Save.
- Copy the webhook URLOpen the webhook's More menu and choose Copy link. The URL starts with https://chat.googleapis.com/v1/spaces/.
- Add the destinationIn Uptime Tracker go to Integrations → Add destination, find Google Chat and choose "Set up Google Chat". Paste the Google Chat webhook URL and choose "Add destination".
- Send a testOn Integrations → Destinations, under Configured destinations, choose "Send test" and check the space.
Google Chat alerts are available on the Pro and Team plans. Uptime Tracker posts a short text message to a Google Chat space through an incoming webhook. There is no verification step: the destination is active as soon as you save it.
Before you start
- A workspace on Pro or Team (or the Team trial). On Free, the Google Chat card under Integrations → Add destination shows Needs Pro.
- A Google Workspace business or enterprise account. Personal Gmail accounts cannot add webhooks, and your Google Workspace administrator must allow incoming webhooks.
- Google Chat in a web browser. Webhooks cannot be added from the Chat mobile app.
Quickest: connect the Uptime Tracker Chat app
- In Integrations → Add destination, find Google Chat and choose Connect Google Chat (Pro or Team; owners, admins and operators). The connection wizard opens on Integrations → Destinations with a one-time code that works once and expires after 30 minutes.
- In Google Chat, add the Uptime Tracker app to a space (or open a direct message with it).
- Send
@Uptime Tracker connect <code>in the space, or justconnect <code>in a direct message (the/connectcommand works too). - The app confirms in the chat and the destination appears verified on Integrations → Destinations. Choose Send test.
Acknowledge from Google Chat: alert cards have an Acknowledge button. The first time you press it, the app sends you a private link to link your Google account to your Uptime Tracker sign-in (you can also send link or /link). After that, a press acknowledges as you and the card shows who acknowledged. If the app is removed from the space, the destination is disabled and your other destinations are told; connecting the same space again re-enables it.
The Chat app can only be added in Google Workspace organizations that allow it. If yours does not list it yet, use the incoming webhook below.
Get the webhook URL in Google Chat
- Open
chat.google.comand go to the space that should receive alerts (create a dedicated space such as "Uptime alerts" if you like). - Next to the space name, open the menu (the small arrow) and choose Apps & integrations.
- Choose Add webhooks. Enter a name such as "Uptime Tracker" (the avatar URL is optional) and choose Save.
- Next to the new webhook, open More and choose Copy link.
The URL looks like https://chat.googleapis.com/v1/spaces/AAAA…/messages?key=…&token=…. Keep the whole URL, including the key and token parameters, and treat it as a secret: anyone who has it can post to the space.
Add it in Uptime Tracker
- Go to Integrations → Add destination.
- Find Google Chat and choose Set up Google Chat.
- Enter a Name (shown in routing rules and the delivery log) and paste the Google Chat webhook URL.
- Leave Personal destination — only notify me when I am on call unticked for a shared team space.
- Choose Add destination, then Send test under Configured destinations on Integrations → Destinations.
What you receive
A bold title such as DOWN: Checkout API or RECOVERED: Checkout API, the time the outage or recovery was confirmed, a Reason: line on down alerts (for example HTTP 503 Service Unavailable), and the redacted target (for HTTP monitors only the host). Reminders and acknowledgements are posted too when routing rules or escalation produce them.
Change the webhook
To move alerts to another space, or after the webhook was deleted, add a webhook in Google Chat, then choose Edit connection on the destination, paste the new URL and choose Save connection. Saving also re-enables a destination that was disabled after delivery failures.
Troubleshooting
- "The endpoint is not a valid google_chat URL": the URL must start with
https://chat.googleapis.com/v1/spaces/. Copy it again with Copy link rather than from the browser address bar. - No Add webhooks option: your Google Workspace administrator has disabled incoming webhooks, or you are using a personal account or the mobile app.
- The test never arrives: open Integrations → Deliveries. An HTTP 401, 403 or 404 means the webhook was deleted or the URL is incomplete; the destination is then disabled with a reason. Create a new webhook and paste it with Edit connection, which re-enables the destination.
Frequently asked questions
Which plan do I need for Google Chat alerts?
Pro or Team. Free includes email, Slack, Discord, Telegram and generic webhooks.
Can I use a personal Gmail account?
No. Google only lets Google Workspace business or enterprise accounts add incoming webhooks to a space.
Can I alert several spaces?
Yes. Add one webhook and one destination per space, then use routing rules to decide which monitors go where.