> ## Documentation Index
> Fetch the complete documentation index at: https://koreai-content-gov.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Adding the Google Chat Channel

<Badge icon="arrow-left" color="gray">[Back to Available Channels](/ai-for-service/channels/adding-channels-to-your-bot#available-channels)</Badge>

Adding Google Chat as a channel to your AI Agent allows end-users to chat with it using Google Chat. This article shows you how to set it up.

## Step 1: Enable the Google Chat API

1. Log into [Google Cloud.](https://console.developers.google.com/projectselector2/apis/dashboard?pli=1)

2. Click **Library**, in the left side menu.
   <img src="https://mintcdn.com/koreai-content-gov/Kn-7zAe9HqOYYzJ2/ai-for-service/channels/images/google_chat.png?fit=max&auto=format&n=Kn-7zAe9HqOYYzJ2&q=85&s=506aebf51ef596d65d154aa0f642cec3" alt="Library" width="1024" height="410" data-path="ai-for-service/channels/images/google_chat.png" />

3. Search and select the **Google Chat API**.
   <img src="https://mintcdn.com/koreai-content-gov/Kn-7zAe9HqOYYzJ2/ai-for-service/channels/images/google_chat1.png?fit=max&auto=format&n=Kn-7zAe9HqOYYzJ2&q=85&s=1f020f96fec0be991a809c21023ce24c" alt="Google Chat" width="1024" height="416" data-path="ai-for-service/channels/images/google_chat1.png" />

4. Click **Enable**.

5. On enabling the API, you are redirected to the **Overview** page of the **Google Chat API**.
   <img src="https://mintcdn.com/koreai-content-gov/Kn-7zAe9HqOYYzJ2/ai-for-service/channels/images/google_chat2.png?fit=max&auto=format&n=Kn-7zAe9HqOYYzJ2&q=85&s=6a30ca0525eb5036559603512ad74627" alt="Google Chat API" width="1024" height="456" data-path="ai-for-service/channels/images/google_chat2.png" />

## Step 2: Set Up the API in Google Cloud

To set up the Google Chat API, you need to create credentials first, then configure its details and functionality, as follows:

1. From the Credentials page, click **Create credentials** and select **Service account**.
   <img src="https://mintcdn.com/koreai-content-gov/Kn-7zAe9HqOYYzJ2/ai-for-service/channels/images/google_chat3.png?fit=max&auto=format&n=Kn-7zAe9HqOYYzJ2&q=85&s=8d7972eb95f193f477b9fce13cc54ee9" alt="create credentials" width="1024" height="456" data-path="ai-for-service/channels/images/google_chat3.png" />

2. Provide a name for your service account, service account description, and click **Create and Continue**.
   <img src="https://mintcdn.com/koreai-content-gov/Kn-7zAe9HqOYYzJ2/ai-for-service/channels/images/google_chat4.png?fit=max&auto=format&n=Kn-7zAe9HqOYYzJ2&q=85&s=0da7da41944daefe7de2a783b73414ee" alt="Library" width="1024" height="456" data-path="ai-for-service/channels/images/google_chat4.png" />

3. Once the service account is created there are 2 optional steps:
   * Grant this service account access to project
   * Grant users access to this service account

4. Click on the **Done** button.
   <img src="https://mintcdn.com/koreai-content-gov/Kn-7zAe9HqOYYzJ2/ai-for-service/channels/images/google_chat5.png?fit=max&auto=format&n=Kn-7zAe9HqOYYzJ2&q=85&s=b42581af089be03ea7a393ac09dfe3a7" alt="grant users" width="1024" height="456" data-path="ai-for-service/channels/images/google_chat5.png" />

5. Go to the **Configurations** section and provide all the required details like:
   * App name
   * Avatar URL
   * Description
     <img src="https://mintcdn.com/koreai-content-gov/Kn-7zAe9HqOYYzJ2/ai-for-service/channels/images/google_chat6.png?fit=max&auto=format&n=Kn-7zAe9HqOYYzJ2&q=85&s=e632cc90f8e18f41061ae593df7148ea" alt="configurations" width="1024" height="456" data-path="ai-for-service/channels/images/google_chat6.png" />

6. Under **Functionality** choose both **Receive one-to-one messages** and **Join spaces and group conversations** options.
   <img src="https://mintcdn.com/koreai-content-gov/Kn-7zAe9HqOYYzJ2/ai-for-service/channels/images/google_chat7.png?fit=max&auto=format&n=Kn-7zAe9HqOYYzJ2&q=85&s=7c08797e049ec10bd7571117fed55332" alt="Library" width="1024" height="462" data-path="ai-for-service/channels/images/google_chat7.png" />

7. Under **Connection Settings**:
   * Select the **App URL** option.
   * Go to the Kore.ai **Channels & Flows** > **Channels** > **Digital** > **All** > **Google Chat** > **Configurations** and copy the **Webhook URL**.
   * Go back to **Connections Settings in Google Cloud** and paste the Webhook URL

8. Select the appropriate option under **Permissions**.
   <img src="https://mintcdn.com/koreai-content-gov/Kn-7zAe9HqOYYzJ2/ai-for-service/channels/images/google_chat8.png?fit=max&auto=format&n=Kn-7zAe9HqOYYzJ2&q=85&s=3b159393addb23b9840bc9486ecac33c" alt="permissions" width="1024" height="412" data-path="ai-for-service/channels/images/google_chat8.png" />

Next, we will be configuring the API keys that the Platform will use to connect to Google Chat.

## Step 3: Create API Keys

Once your service account has been created, you need to manage the keys corresponding to your API, as follows:

1. Navigate to the **Credentials** page and click on **Manage service accounts**.
   <img src="https://mintcdn.com/koreai-content-gov/Kn-7zAe9HqOYYzJ2/ai-for-service/channels/images/google_chat9.png?fit=max&auto=format&n=Kn-7zAe9HqOYYzJ2&q=85&s=93e05a95c0604a86214b655fbc53145b" alt="Manage Service" width="1024" height="456" data-path="ai-for-service/channels/images/google_chat9.png" />

2. From the Manage service accounts page click the **Actions** button corresponding to your newly created account, then on **Manage keys**.
   <img src="https://mintcdn.com/koreai-content-gov/Kn-7zAe9HqOYYzJ2/ai-for-service/channels/images/google_chat10.png?fit=max&auto=format&n=Kn-7zAe9HqOYYzJ2&q=85&s=228790fe6e11e8c904005b8ef64f310a" alt="Manage Keys" width="1024" height="456" data-path="ai-for-service/channels/images/google_chat10.png" />

3. From the **Manage Keys** page click on **Add Key** button, select **Create new key** from the drop down, select the JSON option, and click on **Create** button.
   <img src="https://mintcdn.com/koreai-content-gov/Kn-7zAe9HqOYYzJ2/ai-for-service/channels/images/google_chat11.png?fit=max&auto=format&n=Kn-7zAe9HqOYYzJ2&q=85&s=c553020c27f2f6837c604f5a6925a70a" alt="create new key" width="1024" height="456" data-path="ai-for-service/channels/images/google_chat11.png" />

A JSON file will be generated and you need to copy the **client\_email**, and **private\_key** that needs to be input into the Platform. .

## Step 4: Configure the Google Chat Channel

In the Platform, select the AI Agent you’re working with, then go to **Channels & Flows** > **Channels** > **Digital** > **All** > **Google Chat** > **Configurations**.

1. Enter the following configuration details:
   1. **Client Email** - Copy the value of the **client\_email** field present in the credentials JSON file of your Service Account and enter it here.
   2. **Private Key** - Copy the value of the **private\_key** field present in the credentials JSON file of your Service Account and enter it here.

2. Enable **Proactive Notifications** to send  relevant updates to the users without requiring them to initiate interaction with the app first.

3. Enable the **Welcome Event** toggle to automatically send a welcome message and initiate start (experience) flows when users install an app(bot) integrated with Google Chat via Google Workspace.

4. Select **Yes** and select **Save** to enable Google Chat channel.
   <img src="https://mintcdn.com/koreai-content-gov/FL64Ysq1amBvKw3e/ai-for-service/channels/images/google_chat12.png?fit=max&auto=format&n=FL64Ysq1amBvKw3e&q=85&s=8b25c792667c9be3ae9112196b88ae0d" alt="save channel" width="696" height="880" data-path="ai-for-service/channels/images/google_chat12.png" />

After enabling the channel and verifying all the configurations, you can optionally publish the app for the new channel. Learn more about [Publishing your App](/ai-for-service/deployment/publishing-app).
