Skip to content

Google Chat

DETAILS: Tier: Free, Premium, Ultimate Offering: SaaS, self-managed

You can configure your project to send notifications from GitLab to a room of your choice in Google Chat (formerly Google Hangouts).

Integration workflow

To enable this integration, you must first create a webhook for the space in Google Chat where you want to receive the notifications from your project.

After that, enable the integration in GitLab and choose the events you want to be notified about in your Google Chat space.

For every selected event in your project, GitLab acts like a bot sending notifications to Google Chat:

Google Chat integration illustration

Enable the integration in Google Chat

To enable the integration in Google Chat:

  1. Enter the space where you want to receive notifications from GitLab.
  2. In the upper-left corner, from the space dropdown list, select Apps and Integrations > Manage webhooks.
  3. Enter the name for your webhook (for example, GitLab integration).
  4. Optional. Add an avatar for your bot.
  5. Select Save.
  6. Copy the webhook URL.

For further details, see the Google Chat documentation for configuring webhooks.

Enable threads in Google Chat

WARNING: In March 2023, Google deprecated threaded replies in Google Chat. This feature does not work for new Google Chat spaces. You can still use this feature in existing Google Chat spaces where threaded replies are already enabled.

To enable threaded notifications for the same GitLab object (for example, an issue or merge request):

  1. Go to Google Chat.
  2. In Spaces, select + > Create space.
  3. Enter the space name and (optionally) other details, and select Use threaded replies.
  4. Select Create.

You cannot enable threaded replies for existing Google Chat spaces.

Enable the integration in GitLab

To enable the integration in GitLab:

  1. In your project, go to Settings > Integrations and select Google Chat.
  2. Scroll down to the end of the page where you find a Webhook field.
  3. Enter the webhook URL you copied from Google Chat.
  4. Select the events you want to be notified about in your Google Chat space.
  5. Optional. Select Test settings.
  6. Select Save changes.

To test the integration, make a change based on the events you selected and see the notification in your Google Chat space.