Closed Beta — The Google Chat integration is currently in closed beta. Contact support@rootly.com to request access.
For detailed installation instructions, screenshots, and troubleshooting, see the Google Chat Installation Guide.
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
Requirements:
- Rootly account: Admin or Owner
- Google account: Workspace Admin (for service account) or regular user (for OAuth)
Service Account (Recommended)
- Create a service account in your Google Cloud project (IAM & Admin > Service Accounts)
- Download the JSON key file
- Configure domain-wide delegation in admin.google.com with the service account’s Client ID and required Chat scopes
- In Rootly, go to Configuration > Integrations and search for Google Chat
- Click Setup, upload the JSON key, and enter the delegated user email
- Click Connect
OAuth (Limited)
- In Rootly, go to Configuration > Integrations and search for Google Chat
- Click Setup, then Connect with Google
- Sign in with your Google Workspace account and approve permissions
For step-by-step instructions with full details, see the Google Chat Installation Guide.
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)
Frequently Asked Questions
Which connection method should I use?
Which connection method should I use?
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.
What permissions does Rootly need?
What permissions does Rootly need?
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.
Can I use Google Chat alongside Slack or Microsoft Teams?
Can I use Google Chat alongside Slack or Microsoft Teams?
Yes. Rootly supports multiple chat integrations simultaneously. You can configure workflows to route incidents to specific platforms based on conditions.
Why aren't my incident cards rendering?
Why aren't my incident cards rendering?
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.