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

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/overview).
</Note>

## Before You Get Started

There are two ways to connect Google Chat to Rootly. The recommended path is through the **Google Workspace Marketplace**, which requires no GCP project setup. For organizations that need **domain-wide delegation**, a service account can be configured as an advanced option.

| Method                         | Best For                                       | Limitations                                              |
| ------------------------------ | ---------------------------------------------- | -------------------------------------------------------- |
| **Marketplace** (recommended)  | Most organizations                             | None for standard use                                    |
| **Service Account** (advanced) | Organizations requiring domain-wide delegation | Requires Google Cloud project and Workspace admin access |

## Quick Installation Steps

<Info>
  **Requirements:**

  * **Rootly account:** Admin or Owner
  * **Google account:** Workspace Admin (for Marketplace install or service account setup)
</Info>

### Marketplace (Recommended)

1. Install Rootly from the [Google Workspace Marketplace](https://workspace.google.com/marketplace/app/rootly/1046293539231)
2. Add the Rootly bot to a Google Chat space
3. Type `/rootly` in the space and select your team to complete setup

### Service Account (Advanced)

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

<Note>
  For step-by-step instructions with full details, see the [Google Chat Installation Guide](/integrations/google-chat/overview).
</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 **Marketplace** install for the fastest setup with no GCP project required. Use the **service account** path only if your organization requires domain-wide delegation for advanced use cases.
  </Accordion>

  <Accordion title="What permissions does Rootly need?" icon="lock">
    The Marketplace install handles permissions automatically. If using a service account, it 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/overview).
  </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="Do I need a service account if I install from the Marketplace?" icon="circle-question">
    No. The Marketplace install provides full functionality without a service account. A service account is only needed if your organization requires domain-wide delegation for specific use cases.
  </Accordion>

  <Accordion title="Why aren't my incident cards rendering?" icon="triangle-exclamation">
    Verify the Rootly bot has been added to the target space. If you installed via the Marketplace, the bot should be available automatically once added to a space.
  </Accordion>
</AccordionGroup>