--- title: Google Chat description: >- Google Chat™ (formerly Google Hangouts Chat™) helps teams using Google Workspace™ to connect and collaborate. breadcrumbs: Docs > Integrations > Google Chat --- # Google Chat {% callout %} # Important note for users on the following Datadog sites: app.ddog-gov.com {% alert level="danger" %} This product is not supported for your selected [Datadog site](https://docs.datadoghq.com/getting_started/site). (). {% /alert %} {% /callout %} ## Overview{% #overview %} Connect Google Chat™ to Datadog and help your team collaborate by: - Receiving alerts and notifications from Datadog within Google Chat™. - Sharing graphs with your colleagues in your team's private or public spaces. **Data Collected**: This integration collects identifying information about connected Google user accounts, Google organizations, and Google Chat™ spaces to enable a delegated user account to take action on your behalf. Datadog does not retain or use data obtained through Google Chat™ APIs to develop, improve, or train generalized AI or ML models. ## Setup{% #setup %} ### Prerequisites{% #prerequisites %} **Google Workspace administrators must first:** 1. [Allowlist](https://support.google.com/a/answer/6089179) the [Datadog app](https://workspace.google.com/marketplace/app/datadog/96497144843) for the top-level organizational unit in the Google Workspace Admin Console. 1. Ensure users have top-level organizational unit access for Google Chat. Google Chat apps [require](https://support.google.com/a/answer/7651360#1_install_apps&2_allowlist&add_apps) top-level organizational unit access to function properly. Without top-level access, the Datadog app may fail to work correctly with the Google Chat APIs. ### Installation{% #installation %} To add the Datadog application to a Google Chat space: 1. Type `@Datadog` in the message composer. 1. Select the Datadog app. 1. Send the message. If users cannot see or install the Datadog app, verify that: - The app is allowlisted in the Google Workspace Admin Console - Users have the necessary Google Chat permissions - The organization allows third-party apps ### Connect a Google Organization{% #connect-a-google-organization %} Connect your Google Organization to integrate with Datadog to use interactive features such as Incident Management. 1. Run the `/dd_accounts` slash command within a Google Chat space. 1. Select your [Datadog site](https://docs.datadoghq.com/getting_started/site/). 1. Click **Connect Organization**, which redirects you to Datadog. 1. Select your Datadog organization. 1. Your Google organization is now available in the [Google Chat integration tile](https://app.datadoghq.com/integrations/google_hangouts_chat) in **Configure > Organizations**. ### Send monitor notifications to a Google Chat space{% #send-monitor-notifications-to-a-google-chat-space %} #### Within a Google Organization{% #within-a-google-organization %} Once the app has been added to the space, configure the notification handle in Datadog. 1. Under a configured Google Organization, click **Add Handle**. Give the handle a name, select the desired space from the drop-down menu, and click **Save**. #### Without a Google Organization{% #without-a-google-organization %} 1. After installation, post the command `@Datadog install` in the space. To connect the space to Datadog for sites other than the default domain (`app.datadoghq.com`), append the domain to the command. For example, `@Datadog install mydomain.datadoghq.eu`. 1. Click the Datadog app's prompt to sign in to your Datadog account and follow the redirect to Datadog. 1. The name and url of the space is now configured in the [Google Chat integration tile](https://app.datadoghq.com/integrations/google_hangouts_chat) within **Configure > Spaces**. #### Usage{% #usage %} You can use the handle `@googlechat-` as a standard [Datadog notification handle](https://docs.datadoghq.com/monitors/notifications/#notification). 1. In a Datadog monitor, type `@googlechat` in the monitor message box to see a list of spaces where you can send the notification. 1. Select `@googlechat-` to add it to the monitor. **Note**: The legacy notification handle prefix `@hangouts` has been migrated to `@googlechat`, but both handle prefixes are still supported to send notifications. ### Connect a delegated user to perform actions in a Google organization{% #connect-a-delegated-user-to-perform-actions-in-a-google-organization %} 1. Create the service account user that will take actions on behalf of Datadog 1. Create a Google service account user. Datadog recommends giving this service account user a name such as 'Datadog' to distinguish it from actual Google users and avoid confusion. 1. Assign a Google Workspace license to the service account user, and ensure it has Google Chat enabled. 1. Connect the delegated user 1. Navigate to the **Configure** tab within the [Google Chat integration tile](https://app.datadoghq.com/integrations/google_hangouts_chat). 1. Select the **Organizations** tab. 1. Select a connected organization. 1. Click the gear icon in the upper-right corner to open the settings menu. 1. Select **Connect delegated user for organization**, which redirects you to Google. 1. Sign in to Google as the service account user you want to perform actions on behalf of Datadog. 1. Follow the prompts until you are redirected to the Google Chat integration tile in Datadog. ### Configure a target audience in a Google organization{% #configure-a-target-audience-in-a-google-organization %} Configure a target audience to control which group of users are allowed to view Google Chat spaces created by Datadog. 1. Navigate to the **Configure** tab within the [Google Chat integration tile](https://app.datadoghq.com/integrations/google_hangouts_chat). 1. Select the **Organizations** tab. 1. Select a connected organization. 1. Under **Target Audiences**, give your target audience a name and paste the audience ID. You can obtain this ID from the Google Admin console by following [these instructions](https://developers.google.com/workspace/chat/space-target-audience#get-target-audience). 1. Click **Save** and your target audience is configured to be used in different areas of Datadog such as Incident Management. {% callout %} # Important note for users on the following Datadog sites: app.datadoghq.com ### Datadog app @-mention command summary{% #datadog-app--mention-command-summary %} | Command | Description | | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `@Datadog install (domain)` | Starts the workflow to connect a Google Chat space for notifications. **Note:** If you belong to more than one Datadog organization, an **Account selection** page is displayed during the install workflow. | | `@Datadog list installed accounts` | Returns a list of all Datadog organizations that are connected to the current Google Chat space. | | `@Datadog remove account` | Starts the workflow to remove the current Google Chat space from a specific Datadog organization. The Datadog app responds with a card containing uninstall links for all Datadog organizations connected to the space. Click a Datadog organization to disconnect it from the space. The Datadog app will respond with the removed organization name. | {% /callout %} #### Dashboards{% #dashboards %} You can post dashboard widget snapshots in any Google Chat space or direct message where the Datadog app is installed. For a list of supported widgets, see [Scheduled Reports](https://docs.datadoghq.com/dashboards/sharing/scheduled_reports/). To share a dashboard widget in Google Chat: 1. In Datadog, hover over a dashboard widget and press **CMD + C** (Mac) or **CTRL + C** (Windows), or click the **Copy** button from the share menu. 1. Paste the link into Google Chat. {% callout %} # Important note for users on the following Datadog sites: app.datadoghq.com ## Disconnecting Google Chat from a Datadog organization for notifications{% #disconnecting-google-chat-from-a-datadog-organization-for-notifications %} There are three ways to disconnect a Google Chat space from a Datadog organization: 1. In a Google Chat space, use the `@Datadog remove account` command to disconnect a space from a selected Datadog organization. 1. From a Datadog organization, remove a space from the [Google Chat integration tile](https://app.datadoghq.com/integrations/google_hangouts_chat) under **Configure > Spaces**. 1. Remove the app from the space to remove that space from any connected Datadog organizations. {% /callout %} {% callout %} # Important note for users on the following Datadog sites: ap1.datadoghq.com, ap2.datadoghq.com, us5.datadoghq.com, us3.datadoghq.com, app.datadoghq.eu From a Datadog organization, remove a space from the [Google Chat integration tile](https://app.datadoghq.com/integrations/google_hangouts_chat) {% /callout %} {% callout %} # Important note for users on the following Datadog sites: app.datadoghq.com, app.datadoghq.eu, us3.datadoghq.com, us5.datadoghq.com, ap1.datadoghq.com, ap2.datadoghq.com ## Delegated user permissions{% #delegated-user-permissions %} To enable Incident Management features, the Google Chat integration requires a connected, delegated Google user to grant the following permissions. Enable product-specific permissions from that product's settings page, or grant all permission scopes by connecting a delegated user in the [Google Chat integration tile](https://app.datadoghq.com/integrations/google_hangouts_chat). | Permission name | Request Reason | | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- | | chat.spaces.create | Enable the delegated user to automatically create new conversations in Google Chat when an incident is declared in Datadog Incident Management. | {% /callout %} ## Data Collected{% #data-collected %} ### Metrics{% #metrics %} The Google Chat integration does not include any metrics. ### Events{% #events %} The Google Chat integration does not include any events. ### Service Checks{% #service-checks %} The Google Chat integration does not include any service checks. ## Troubleshooting{% #troubleshooting %} Need help? Contact [Datadog support](https://docs.datadoghq.com/help/). ## Further Reading{% #further-reading %} - [Integrate Datadog with Google Hangouts Chat](https://www.datadoghq.com/blog/google-hangouts-chat-integration/) - [Google Chat | Google for Developers](https://developers.google.com/hangouts/chat/)