debian-mirror-gitlab/doc/user/project/integrations/hangouts_chat.md
2023-01-12 18:35:48 +00:00

2.5 KiB

stage group info
Manage Integrations To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/product/ux/technical-writing/#assignments

Google Chat integration (FREE)

Integrate your project to send notifications from GitLab to a room of your choice in Google Chat (former Google Hangouts).

Integration workflow

To enable this integration, first you need to create a webhook for the room 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 room.

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 room where you want to receive notifications from GitLab.
  2. Open the room dropdown list on the top-left and select 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

Introduced in GitLab 15.4.

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 room.
  5. Optional. Select Test settings to verify the connection.
  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 room.