# Google Chat

This page consists of all details and implementation overview for Google Chat channel. The installation is completed first in the Google Cloud site, and then in Aisera's AISX.

### Setup Google Chatbot on Google Cloud Site <a href="#pdf-page-qlknw9oe8xo2zprsw7s4-setup-google-chatbot-on-google-cloud-site" id="pdf-page-qlknw9oe8xo2zprsw7s4-setup-google-chatbot-on-google-cloud-site"></a>

1. Login to your Google Account wiht Workspace Credentials
2. Go to the Google Cloud Platform: <https://console.cloud.google.com/>
3. Click on the **Projects Dropdown**
4. Select **New Project**
5. Fill out the detials for your project

Keep in mind that the Project ID that is created here you will be needed in Aisera's AISX, it's unique and cannot be changed. Save your changes by clicking on the "CREATE" button. Make sure that the newly created project is already selected on the dropdown menu.

6. Click on **Enable APIs and Services**
7. Search for the **Chat Service** from the API library
8. Select **Google Chat API** and **Enable**
9. Click on **Create Credentials**
10. Fill out the credential detials and click **Next**
11. Fill out the service account credential details and click **Create and Continue**
12. Grant this service account access to the project by selecting the role of **Owner** in the dropdown menu and click **Next**
13. Navigate to **Google Chat API > Credentials** and click on the newly created **Service Account**
14. Select **Keys**
15. Select **Add Key**
16. Select **JSON** as the **Key Type**, and then click **Create.** The newly generated key will be stored in your local computer in JSON format.&#x20;
17. Click **Close**
18. Navigate to **APIs & Serivces > Enabled APIs & Services > Google Chat API > Configuration**
19. Fill out the application info details

* **App name:** is the name of the bot and this name will be displayed in Google Chat
* **Avatar URL:** the icon that will be displayed in Google Chat
* **Description:** a description for the bot and also what appears when someone searches for the bot

20. Check both checkboxes under the **Functionality Settings**
21. Fill out the **Connection Settings**

* **App URL -** This URL points to the Aisera chatbot accompanied with the **projectId** and **domain** parameters. For example: `https://<vanity_url>/googleChat/receive?projectid=<project_id>&domain=<domain>`

22. Select Permissions Settings

* First option if you want the chatbot to be available to all users under the workspace domain
* Second option if you want to limit the access to specific users

23. Click **Save**

{% hint style="warning" %}
Scroll up and a new field has appeared App status. Select from the dropdown: LIVE

This makes the chatbot available to users.
{% endhint %}

### Setup Google Chatbot on the Aisera Platform <a href="#pdf-page-qlknw9oe8xo2zprsw7s4-setup-google-chatbot-on-aisx-platform" id="pdf-page-qlknw9oe8xo2zprsw7s4-setup-google-chatbot-on-aisx-platform"></a>

1. Login the Aisera Admin UI
2. Navigate to **Settings > Channels > New Channel**
3. Select **Google Chat** from the channel options
4. Fill out the configuration fields
   1. Service account credentials field are inside the JSON file downloaded in the previous steps.
5. Click **Ok**

### Installing Google Chat <a href="#pdf-page-qlknw9oe8xo2zprsw7s4-installing-google-chat" id="pdf-page-qlknw9oe8xo2zprsw7s4-installing-google-chat"></a>

1. Open your browser and navigate to the following address: <https://mail.google.com/chat/u/0/#chat/welcome>
2. Login with you Google Workspace Credentials
3. Go to the **Chat** section on the left menu and click the **+** icon
4. Search and **Add Bot** to the **Chat** section
