> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rootly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Chat Integration

> Connect Google Chat to Rootly to create incident spaces, send notifications, run slash commands, and manage on-call alerts directly from chat.

<Info>
  **Closed Beta** — The Google Chat integration is currently in closed beta. Contact [support@rootly.com](mailto:support@rootly.com) to request access.
</Info>

Rootly's Google Chat integration automates incident communication, on-call management, and alerting. When an incident starts, Rootly creates a dedicated Google Chat space, invites responders, and posts real-time incident overview cards.

<Note>
  For detailed installation instructions, screenshots, and troubleshooting, see the [Google Chat Installation Guide](/integrations/google-chat/installation).
</Note>

## Before You Get Started

There are two ways to connect Google Chat to Rootly. The recommended path uses a **service account with domain-wide delegation**. The alternative **OAuth** path is simpler but has limitations.

| Method                            | Best For         | Limitations                                                                  |
| --------------------------------- | ---------------- | ---------------------------------------------------------------------------- |
| **Service Account** (recommended) | Production use   | Requires Google Cloud project and Workspace admin access                     |
| **OAuth**                         | Quick evaluation | No Cards v2, no slash command dialogs, no emoji reactions, single user token |

## Quick Installation Steps

<Info>
  **Requirements:**

  * **Rootly account:** Admin or Owner
  * **Google account:** Workspace Admin (for service account) or regular user (for OAuth)
</Info>

### Service Account (Recommended)

1. Create a service account in your Google Cloud project (**IAM & Admin > Service Accounts**)
2. Download the JSON key file
3. Configure domain-wide delegation in [admin.google.com](https://admin.google.com) with the service account's Client ID and required Chat scopes
4. In Rootly, go to **Configuration > Integrations** and search for **Google Chat**
5. Click **Setup**, upload the JSON key, and enter the delegated user email
6. Click **Connect**

### OAuth (Limited)

1. In Rootly, go to **Configuration > Integrations** and search for **Google Chat**
2. Click **Setup**, then **Connect with Google**
3. Sign in with your Google Workspace account and approve permissions

<Note>
  For step-by-step instructions with full details, see the [Google Chat Installation Guide](/integrations/google-chat/installation).
</Note>

## After Connecting

Once connected, Rootly automatically creates default workflows:

* **Auto Create Incident Google Chat Space** — Creates a dedicated space when an incident starts
* **Default Announcement Space** — Posts to a shared announcement space (disabled until configured)

Go to **Configuration > Integrations > Google Chat > Settings** to configure incident spaces, emoji shortcuts, and interaction preferences.

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Which connection method should I use?" icon="wifi">
    Use the **service account** path for production. It supports Cards v2 rich messages, slash command dialogs, emoji reactions, and is not tied to a single user. OAuth is suitable for quick evaluation only.
  </Accordion>

  <Accordion title="What permissions does Rootly need?" icon="lock">
    The service account requires six Google Chat scopes for creating spaces, managing members, and sending messages. See the full scope list in the [Installation Guide](/integrations/google-chat/installation).
  </Accordion>

  <Accordion title="Can I use Google Chat alongside Slack or Microsoft Teams?" icon="users">
    Yes. Rootly supports multiple chat integrations simultaneously. You can configure workflows to route incidents to specific platforms based on conditions.
  </Accordion>

  <Accordion title="Why aren't my incident cards rendering?" icon="triangle-exclamation">
    Cards v2 require the service account connection. OAuth can only send plain text messages. If you're using a service account and cards still don't render, verify the Rootly bot has been added to the target space.
  </Accordion>
</AccordionGroup>