# Google Chat App {% hint style="warning" %} The Google Chat integration is currently in beta. Core functionality is stable, but some features may be added or refined based on user feedback. {% endhint %} 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](https://support.google.com/a/answer/172482) {% hint style="info" %} Administrator privileges are required to install the app for your organization. {% endhint %} ### In Google Chat #### Connect Google Chat to your ilert tenant 1. Add the ilert app to a space.
contextual menu of a space with apps and integrations menu highlighted
apps and integrations of a space
search results of ilert in apps
2. Click "Connect" in the message sent by the ilert app.
3. 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. {% hint style="info" %} You will be informed of successful connection in the same space where the connection was initiated. {% endhint %}
## 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](https://app.ilert.com/connector/list-all) in ilert and click **Create new alert action**.
2. Choose **Google Chat** from the list. Make sure "Use webhook" is **unselected** to use the native app integration.
3. 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:
4. Click **Next**. Optionally configure **Conditional execution** to filter alerts based on specific conditions (e.g., only high-priority alerts). 5. 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**
6. Click **Save** to create the alert action. 7. 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](https://support.google.com/a/answer/172482?hl=en) 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](https://github.com/iLert/docs/blob/master/product-docs/chatops/google-chat/google-chat-webhooks.md) - Alternative setup without app permissions * [ChatOps Overview](https://docs.ilert.com/chatops/overview) - Compare with Slack and Microsoft Teams integrations