> For the complete documentation index, see [llms.txt](https://docs.ilert.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ilert.com/chatops/google-chat/incoming-webhook.md).

# Google Chat Webhooks

{% hint style="warning" %}
Prefer [ilert's Google Chat app](/chatops/google-chat/google-chat-app.md). A webhook only posts messages — responders cannot accept, reroute, or resolve from the space. Use this route only if you cannot grant the app permissions.
{% endhint %}

{% hint style="info" %}
To receive messages in a thread, see [Use threads in Chat](#use-threads-in-chat).
{% endhint %}

## In Google Chat

{% stepper %}
{% step %}

## Open the space's apps and integrations

In the space where you want alerts, open the space menu and choose **Apps and integrations**.

<figure><img src="/files/7u5PVtGjQJKy4qC5PhZX" alt="A Google Chat space menu open, with Apps and integrations highlighted among options such as Manage members, Space settings, and Space details." width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

## Add a webhook

Select **Webhooks**, then click **Add webhooks**.

<figure><img src="/files/Jx4IVPSNviYgl7wJeYKM" alt="The Apps and integrations panel for a Google Chat space, showing an Apps section and an empty Webhooks section with an Add webhooks button." width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

## Name it

Enter a name and, optionally, an avatar URL — use `https://cdn.ilert.com/favicon.ico` for the ilert icon. Click **Save**.

<figure><img src="/files/ynFnFeg3M512spSLOQZl" alt="The Incoming webhooks dialog with a name field reading ilert and an avatar URL field containing the ilert favicon address." width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

## Copy the webhook URL

Open the new webhook's menu and choose **Copy link**.

<figure><img src="/files/xqCjnzOENjan58rO2XK3" alt="The Webhooks list showing one ilert webhook, with its overflow menu open on Copy link, Edit, and Delete." width="563"><figcaption><p>Treat this URL as a secret — anyone holding it can post to the space.</p></figcaption></figure>
{% endstep %}
{% endstepper %}

## In ilert

{% stepper %}
{% step %}

## Start a new alert action

In the sidebar, go to **Alerting** → **Alert actions** and click **Create new alert action**.
{% endstep %}

{% step %}

## Choose Google Chat, with the webhook option

Select **Google Chat** and tick **Use webhook**.

<figure><img src="/files/aAqlzOvfTidOsyr6Mqee" alt="The Create alert action dialog with Google Chat selected and its Use webhook checkbox ticked." width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

## Pick the alert source and events

Click **Next**, choose the alert source, and select the events to publish.

<figure><img src="/files/lL8DCAGLHDir8XIhe07Y" alt="The Trigger step of the wizard: an Alert sources field, a Trigger mode toggle set to Automatic, and a checklist of trigger events including alert created, accepted, re-routed, escalated, resolved, and comment added." width="563"><figcaption><p>Every event you tick becomes a message in the space.</p></figcaption></figure>
{% endstep %}

{% step %}

## Skip the conditions

Set up conditional execution, or click past it for now.
{% endstep %}

{% step %}

## Paste the webhook URL

Name the alert action and paste the webhook link you copied.

<figure><img src="/files/iNQSLEPaYv6Wmwk9eXSS" alt="The Action step of the wizard, with a name field reading Post to Google Chat space and a required URL field holding the Google Chat webhook address." width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

## Save

Click **Save**, review the settings, then **Save** again to reach the alert action's detail page.
{% endstep %}
{% endstepper %}

## Use threads in Chat <a href="#message-threads" id="message-threads"></a>

To group messages into a thread, append `&messageReplyOption=REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD` to the webhook URL.

Given a webhook link of:

```
https://chat.googleapis.com/v1/spaces/AAPQRs0mVWx/messages?key=KKKKKK&token=TTTTTT
```

use:

```
https://chat.googleapis.com/v1/spaces/AAPQRs0mVWx/messages?key=KKKKKK&token=TTTTTT&messageReplyOption=REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.ilert.com/chatops/google-chat/incoming-webhook.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.