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 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.Quick Installation Steps
Requirements:
- Rootly account: Admin or Owner
- Google account: Workspace Admin (for Marketplace install or service account setup)
Marketplace (Recommended)
- Install Rootly from the Google Workspace Marketplace
- Add the Rootly bot to a Google Chat space
- Type
/rootlyin the space and select your team to complete setup
Service Account (Advanced)
- 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
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 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.
What permissions does Rootly need?
What permissions does Rootly need?
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.
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.
Do I need a service account if I install from the Marketplace?
Do I need a service account if I install from the Marketplace?
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.
Why aren't my incident cards rendering?
Why aren't my incident cards rendering?
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.