debian-mirror-gitlab/doc/user/project/integrations/hangouts_chat.md

52 lines
1.9 KiB
Markdown
Raw Normal View History

2020-10-24 23:57:45 +05:30
---
2021-10-27 15:23:28 +05:30
stage: Ecosystem
group: Integrations
2021-02-22 17:27:13 +05:30
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
2020-10-24 23:57:45 +05:30
---
2021-06-08 01:23:25 +05:30
# Google Chat integration **(FREE)**
2018-11-18 11:00:15 +05:30
2021-06-08 01:23:25 +05:30
Integrate your project to send notifications from GitLab to a
room of your choice in [Google Chat](https://chat.google.com/) (former Google
Hangouts).
2018-11-18 11:00:15 +05:30
2021-06-08 01:23:25 +05:30
## How it works
2018-11-18 11:00:15 +05:30
2021-06-08 01:23:25 +05:30
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.
2018-11-18 11:00:15 +05:30
2021-06-08 01:23:25 +05:30
After that, enable the integration in GitLab and choose the events you want to
be notified about in your Google Chat room.
2018-11-18 11:00:15 +05:30
2021-06-08 01:23:25 +05:30
For every selected event in your project, GitLab acts like a bot sending
notifications to Google Chat:
2018-11-18 11:00:15 +05:30
2021-06-08 01:23:25 +05:30
![Google Chat integration illustration](img/google_chat_integration_v13_11.png)
2018-11-18 11:00:15 +05:30
2021-06-08 01:23:25 +05:30
## In Google Chat
2018-11-18 11:00:15 +05:30
2021-06-08 01:23:25 +05:30
Select a room and create a webhook:
2018-11-18 11:00:15 +05:30
2021-06-08 01:23:25 +05:30
1. Enter the room where you want to receive notifications from GitLab.
1. Open the room dropdown menu on the top-left and select **Manage webhooks**.
1. Enter the name for your webhook, for example "GitLab integration".
2022-01-26 12:08:38 +05:30
1. Optional. Add an avatar for your bot.
2021-06-08 01:23:25 +05:30
1. Select **Save**.
1. Copy the webhook URL.
2021-09-30 23:02:18 +05:30
For further details, see [the Google Chat documentation for configuring webhooks](https://developers.google.com/chat/how-tos/webhooks).
2021-06-08 01:23:25 +05:30
## In GitLab
Enable the Google Chat integration in GitLab:
1. In your project, go to **Settings > Integrations** and select **Google Chat**.
1. Scroll down to the end of the page where you find a **Webhook** field.
1. Enter the webhook URL you copied from Google Chat.
1. Select the events you want to be notified about in your Google Chat room.
2022-01-26 12:08:38 +05:30
1. Optional. Select **Test settings** to verify the connection.
2021-06-08 01:23:25 +05:30
1. 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.