Google Chat App

Integrate ilert with Google Chat to receive alerts and respond to incidents directly in your spaces.

The Google Chat integration is currently in beta. Core functionality is stable, but some features may be added or refined based on user feedback.

The ilert Google Chat Integration helps you to bring alerts into your channels, acknowledge or resolve alerts without leaving the chat.

Features

• Receive alert notifications directly in Google Chat spaces

• Take action on alerts - Accept, Reroute, or Resolve with one click

• View alert details - Priority, escalation policy, responders, and labels

• Slash commands - Quick access to help and connection management

In Google Workspace

Install the app from Google Marketplace

Follow the instructions to install the ilert app: Install Marketplace apps for your organization - Google Workspace Admin Help

Administrator privileges are required to install the app for your organization.

In Google Chat

Connect Google Chat to your ilert tenant

1. Add the ilert app to a space.

1. Click "Connect" in the message sent by the ilert app.

1. Sign in to your ilert tenant. Admin role is required to connect. You will land on ilert Connectors page and see "Connected" on Google Chat if the connection is successful.

You will be informed of successful connection in the same space where the connection was initiated.

In ilert

Now that the initial connection between your Google Workspace and ilert account has been set up, you may choose alert sources which should send update messages to your Google Chat spaces - this is done by creating Alert Actions in ilert.

Create an Alert Action for Google Chat

1. Go to Alert Actions in ilert and click Create new alert action.

1. Choose Google Chat from the list. Make sure "Use webhook" is unselected to use the native app integration.

1. Click Next and configure the trigger settings:

   • Select one or more alert sources whose alerts you want to publish to Google Chat

   • Choose Trigger mode: Automatic (recommended) or Manual

   • Select the trigger events you want to publish:

1. Click Next. Optionally configure Conditional execution to filter alerts based on specific conditions (e.g., only high-priority alerts).

2. Click Next and configure the action:

   • Give the alert action a name

   • Select the Google Chat space where you want to receive alerts

   • Optionally assign the alert action to specific teams

1. Click Save to create the alert action.

2. Click the Test button in the top right to verify the connection. You should see a test message appear in your Google Chat space.

Responding to Alerts in Google Chat

When an alert is published to your Google Chat space, you'll see a rich notification card containing:

• Status badge - Shows current alert status (PENDING, ACCEPTED, RESOLVED)

• Alert title - Clickable link to view the full alert in ilert

• Description - Alert details (expandable with "Show more")

• Escalation policy - The assigned escalation policy

• Priority - Alert priority level

• Responders - Currently assigned responders

• Links - Any associated external links

• Labels - Custom labels attached to the alert

Action Buttons

Each alert card includes action buttons to respond without leaving Google Chat:

Button	Description
Accept	Acknowledge the alert and become a responder
Reroute	Reassign the alert to another user or escalation policy
Resolve	Mark the alert as resolved
More actions	Access additional options

Slash Commands

The ilert Google Chat app supports the following slash commands:

Command	Description
/il-help	Display the help card with available commands
/il-connect	Connect your ilert account to the current space
/il-disconnect	Disconnect your ilert account from the current space

To use a slash command, type it in the message compose field within a space where the ilert app is added.

FAQ

Can I connect multiple Google Workspace environments or ilert tenants?

No. Each Google Workspace can only be connected to one ilert tenant at a time.

Why is the ilert app not appearing in the search results?

If you cannot find the app when trying to add it to a space, it likely hasn't been enabled for your domain. Please contact your Google Workspace administrator to ensure the ilert app is installed and permitted for your organizational unit.

What permissions are required to set up the integration?

• In ilert: You need a user with Admin or Account Owner role to complete the connection.

• In Google Workspace: A super administrator account is required to install the app. See Google's documentation for details.

Are updates to an alert published in Google Chat?

Yes. The following alert events can be published to Google Chat (configurable when creating the alert action):

• Alert created

• Alert accepted

• Alert re-routed

• Alert escalated

• Alert priority raised

• Alert resolved

• Alert comment added

• Responder changes

• Channel attachment changes

• Escalation policy completion

• Alert timeout notifications

Why am I not seeing my Google Chat spaces in the dropdown?

Make sure:

1. The ilert app has been added to the space you want to use

2. Your Google Workspace account has access to the space

3. The connection between ilert and Google Workspace is active (check Connectors page)

If spaces still don't appear, try reconnecting your Google Workspace integration from the Connectors page.

How do I reconnect or disconnect the integration?

1. Go to Settings > Connectors in ilert

2. Find Google Chat in the ChatOps section

3. Click the three-dot menu and select:

   • Re-connect - To refresh the connection (useful if spaces aren't appearing)

   • Disconnect - To remove the integration entirely

Can team members without ilert accounts respond to alerts?

No. To take actions on alerts (Accept, Reroute, Resolve), users must have an ilert account with appropriate permissions.

Troubleshooting

Connection failed during setup

1. Ensure you're logged into ilert with an Admin account

2. Verify your Google Workspace admin has installed the ilert app

3. Check that third-party apps are allowed in your Google Workspace settings

4. Try using an incognito/private browser window to avoid session conflicts

Alerts not appearing in Google Chat

1. Verify the alert action is enabled and properly configured

2. Check that the selected alert source is generating alerts

3. Confirm the trigger events match the alert activity

4. Test the connection using the "Test" button on the alert action

Space not showing in dropdown

1. Add the ilert app to the space first

2. Ensure you have access to the space in Google Chat

3. Wait a few moments and refresh the page

4. Try re-connecting the Google Workspace integration

Related Documentation

• Google Chat Webhooks - Alternative setup without app permissions

• ChatOps Overview - Compare with Slack and Microsoft Teams integrations