> ## 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. (Optional) Enable **Dynamic Search (Typeahead)** to provide relevant, real-time suggestions from external systems as users type. Specify the custom URL and configure authentication. The platform forwards the search term to the configured endpoint and displays the returned suggestions.

5. Select **Yes** and select **Save** to enable Google Chat channel.
   <img src="https://mintcdn.com/koreai-content-gov/x0E_3rHmPLlE-TVX/ai-for-service/channels/images/google-chat.png?fit=max&auto=format&n=x0E_3rHmPLlE-TVX&q=85&s=f1bc21783426cdfbe55042983ac0eca9" alt="save channel" width="622" height="907" data-path="ai-for-service/channels/images/google-chat.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).
