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

# Rootly AI in Google Chat

> Turn on Rootly AI in Google Chat with one toggle, then mention @Rootly in incident spaces, team spaces, and direct messages to run incidents from Google Chat.

Rootly AI in Google Chat is the same [Rootly AI agent](https://docs.rootly.com/ai/communication-channels/overview.md) that runs in Slack and Microsoft Teams, with the same tools, permissions, and confirmation cards. This page covers Google Chat setup and where to find Rootly AI in Google Chat. For how the agent works on every platform, see [Using Rootly AI](https://docs.rootly.com/ai/communication-channels/using-rootly-ai.md).

## Prerequisites

* The [Google Chat integration](https://docs.rootly.com/integrations/google-chat/overview.md) is connected, and the Rootly bot is added to each space where you want to use Rootly AI.
* You are an Incident Response Owner or Admin with an Incident Response seat.

Once Rootly AI in Google Chat is on, anyone with an [Incident Response role](https://docs.rootly.com/ai/communication-channels/overview.md#who-can-use-rootly-ai) can use it in spaces the Rootly bot belongs to.

***

## Turn On Rootly AI in Google Chat

Setup is one toggle in Rootly. There's no need to reconnect the Google Chat integration or re-approve permissions.

**1. Turn on Rootly Agent in Google Chat**

In Rootly, open **AI & Agents**. Confirm **Opt in to Rootly AI capabilities** is on under **Global**, then toggle **Rootly Agent in Google Chat** on under **Features**.

> [!NOTE]
>
> The Google Chat toggle is separate from **Rootly Agent in Slack** and **Rootly Agent in Microsoft Teams**, so admins can turn Rootly AI on or off in each chat tool independently.

Rootly AI identifies you by your Google account in the space and applies your Rootly permissions, so there is no separate account-linking step to use it.

***

## Where to Use Rootly AI in Google Chat

Mention `@Rootly` and ask in plain language. Rootly AI replies in the same conversation.

| Where | Can it act? | Best for |
| :- | :- | :- |
| **Incident space** | Yes, the full action set | Running the incident: updates, paging, roles, and comms where the whole team sees them |
| **Team space** | Questions, declaring new incidents, paging, and schedule overrides | Declaring an incident, paging a team, or asking about on-call from your team's usual space |
| **Direct message with Rootly** | Questions, declaring new incidents, paging, and schedule overrides | On-call lookups and overrides, incidents you're not actively in, personal questions like "What action items are assigned to me?" |

Changes to an existing incident, such as its severity, status, roles, and action items, happen in that incident's own space. Private incidents can only be discussed inside their own space and stay hidden everywhere else.

Every surface requires an [Incident Response role](https://docs.rootly.com/ai/communication-channels/overview.md#who-can-use-rootly-ai). Your Rootly permissions govern which incidents and Rootly records you can see.

### Choosing a Rootly Organization

Each Google Chat space is connected to a Rootly team with `/rootly`. If your Google Workspace domain is connected to more than one Rootly organization, Rootly AI asks which organization you mean when it can't tell from context, rather than guessing. Pick the organization from the card and Rootly AI continues with your request.

### Manual Paging

You can still page without the agent. Use `/rootly alert` to create an alert and page responders, or `/rootly escalate` to page an escalation policy, from any space where the Rootly bot is installed. See [On-Call & Alerting Commands](https://docs.rootly.com/integrations/google-chat/overview.md#on-call-&-alerting-commands).

### Long Forms

When a request needs more than five required fields, such as resolving an incident with many required custom fields, Rootly AI opens a form dialog in Google Chat so you can finish the form there.

***

## Your First Interaction

Mention `@Rootly` in a team space and ask it to declare an incident. Rootly AI replies in the thread with a link to the new incident's space. Keep asking in the same thread, or move to the incident space to run the incident.

### Try These First

* "Catch me up"
* "Who's on call?"
* "Escalate to SEV1"
* "What are the open action items?"

***

## Google Chat-Specific Troubleshooting

| What you're seeing | The fix |
| :- | :- |
| `"AI agent is not enabled for this team."` | An admin opens **AI & Agents**, turns on **Opt in to Rootly AI capabilities** and **Rootly Agent in Google Chat**. |
| `@Rootly` doesn't appear or doesn't respond in a space | The Rootly bot isn't added to that space. Add it by typing `@Rootly` or from the space's member list, then try again. See [Add Rootly to a Space](https://docs.rootly.com/integrations/google-chat/overview.md#installation). |
| Rootly AI says the space isn't connected to a team | Run `/rootly` in the space and select the Rootly team to connect it to. |
| Rootly AI asks which organization to use | Your Google Workspace domain is connected to more than one Rootly organization. Pick the right one from the card. |
| Changing an action item fails with "not found" | You're in a different incident's space. Make the change from the space of the incident the action item belongs to. |

For issues that apply on every platform, see [Troubleshooting](https://docs.rootly.com/ai/communication-channels/troubleshooting.md).

***

## Related Pages

> [card] [AI Agent in Communication Channels](https://docs.rootly.com/ai/communication-channels/overview.md)
>
> What Rootly AI is and everything it can do.

> [card] [Using Rootly AI](https://docs.rootly.com/ai/communication-channels/using-rootly-ai.md)
>
> How clarification cards work and how actions run.

> [card] [What to Use Rootly AI For](https://docs.rootly.com/ai/communication-channels/what-to-use-rootly-for.md)
>
> The full catalog of prompts, grouped by use case.

> [card] [Google Chat Integration](https://docs.rootly.com/integrations/google-chat/overview.md)
>
> Connect Google Chat, add the Rootly bot, and set up On-Call in Google Chat.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.