Skip to content
MDView as Markdown

Google Chat

Google Chat spaces accept incoming webhooks that take a {"text": "..."} body - the same shape our payload carries - so alerts arrive as messages with nothing to configure in between.

Creating the webhook URL

  1. Open the Google Chat space you want alerts in.
  2. From the space name at the top, select Apps & integrations > Webhooks.
  3. Select Add webhook, give it a name, and save.
  4. Copy the URL.

It looks like:

https://chat.googleapis.com/v1/spaces/SPACE_ID/messages?key=KEY&token=TOKEN

Both credentials are in the URL as query parameters, so no header is needed.

Sending alerts to Google Chat

Open the Config modal on the watcher you want alerts from, enable Send Webhook alerts, and paste the URL into Target webhook URI.

Things to watch for

  • Paste the URL complete, including ?key= and &token=. Everything after the ? is the credential. A URL truncated at the question mark authenticates as nobody and the post fails.
  • The token value must be kept secret - it is what authorises posting to the space.
  • Webhooks can only be added to spaces, not to direct messages.
  • A webhook posts to the space it was created in. For alerts in a different space, create another webhook and point the relevant watchers at it.

Official documentation

Google - Send messages to Google Chat with incoming webhooks

Start Monitoring with Report URI

Already using us? Add the webhook to your space, then paste its URL into any watcher's Config modal.

New to Report URI? Watch products and webhooks are available on Business plans and higher.

Start your free trial