> For the complete documentation index, see [llms.txt](https://docs.csml.dev/studio/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.csml.dev/studio/channels/google-chat/installation.md).

# Installation

## Setup a Google Chat service account

[Service accounts](https://developers.google.com/hangouts/chat/how-tos/service-accounts) are the primary way to interact with Google Cloud resources, and setting up a chatbot is no different.

The first step is to create a new Google Cloud project. Visit <https://console.cloud.google.com/projectcreate> and fill the required fields:

![](/files/-MOlBaf9YscO6XgpOVsx)

Then, [visit this page](https://console.cloud.google.com/marketplace/product/google/chat.googleapis.com) to enable the Google Chat API for this project:

![](/files/-MOlBtpZhhvK4WnWP469)

Then, go to Identity > Service Accounts in the menu (or visit <https://console.cloud.google.com/identity/serviceaccounts>) and create a service account for the project.

![](/files/-MOlCde0GJsixxFNyKoo)

In the next screen, grant the **Project > Editor** role to the service account:

![](/files/-MOlCl6iBIm4PFWDQydr)

The third step (*Grant users access to this service account*) is optional and can be skipped. Click on Done to create the service account.&#x20;

Once the service account is created, you will need to generate a key. Select the service account, click on **Add Key > Create New Key**, select **JSON** as the Key type, and save the file.

## Setup the channel in CSML Studio

In CSML Studio, under **Channels > Connect a new channel**, select the Google Chat channel. In the next screen, give your channel a name, a description and upload your service account credentials.

![](/files/-MOlcu3Dr6_lXn8brBR2)

In the next screen, you can configure the bot's Welcome Flow, and copy the **Chatbot Endpoint URL**, which we will use in the next step.

## Connect the chatbot with Google Chat

To finalize the configuration, visit <https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat> (make sure that the selected project is still the same one as before) and fill the information as requested.

![](/files/-MOle6I9UTNOdfN5KePo)

You can select **Bot works in direct messages** or **Bot works in rooms...** depending on the experience you want to give to users.

Under **Bot URL**, paste the **Chatbot Endpoint URL** from the previous step.

Click **Save**, and you are all set!

## Finding the bot in Google Chat

To find your bot in Google Chat, users have to navigate to the Bot catalog, which can be reached either by clicking the + icon next to the bot section of the left sidebar, or by searching for the name of the bot directly:

![](/files/-MOlpYr3fYgJahxue1XY)

Upon activating the bot for the first time, the Welcome Message will be displayed:

![](/files/-MOlpow9TiGy9x1Usd-N)