Google Chat App Setup

Integrating Digital Agent into Google Chat elevates collaboration and efficiency within your workspace. By seamlessly combining the power of Google Chat's real-time communication with the intelligence of Digital Agent, streamline tasks, provide instant information, and enhance user experiences. 

Start using Digital Agent in Google Chat channel by setting up the Google Chat App.

Setup Google Chat App through the Google Console Developer Portal 

Login to the Google console portal to setup your Google Chat app. 

To setup Google Chat app for Digital Agent, perform the following steps: 

Step 1: Create a new project on Google Console 

Begin setting up Google Chat App for Digital Agent by creating a new project on Google Console. 

To create a new project on Google Console, perform the following steps: 

1. Login to your Google account.  
2. Go to the Google Console Developer portal. 
3. Click Go to Create a Project. (Refer the following screenshot)
   
   
   Figure: Google Console – Create a project 
4. Enter the Project name, Organization, and Location, as shown in the below screenshot. Click Create to create a project. (Refer the following screenshot)
   
   
   Figure: Google Console - Project Details 
5. Once you click Create, a project is successfully created on Google Console. The following screenshot displays the details of the create project on Google Console.
   
    
   Figure: Google Console - Project Creation Successful

Step 2: Enable Service account and Generate Keys 

After creating a new project on Google Console, you have to enable the Service account and generate the keys. Enabling the Service account allows Digital Agent to securely interact with Google Cloud services. And generating keys provides secure authentication for Digital Agent to access APIs and resources associated with the Google Chat integration. 

To enable Service account and generate keys, perform the following steps: 

1. From the left navigation panel, navigate to IAM & Admin > Service Accounts. (Refer the following screenshot)
   
   
   Figure: Google Console – Service Accounts
2. Click + CREATE SERVICE ACCOUNT to create Service account for Digital Agent. (Refer the following screenshot)
   
   
   Figure: Google Console - Create Service Account 
3. In the next screen fill in Service Account details in Step 1 such as Service account name, Service account ID, and Service account description.
4. Click CREATE AND CONTINUE to create Service account.
   
   
   Figure: Create Service Account - details 
5. Steps 2 and 3 are optional and can be skipped.
6. The details of the service account for your project are added successfully. Click the email link once the service account is created. (Refer the following screenshot)
   
   
   Figure: Service Account - Click email link 
7. Navigate to the KEYS tab. Click ADD KEY and select Create new key from the dropdown menu.
   
   
   Figure: Generate Key - Add New Key 
8. A pop-up window will appear. Select the Key type as JSON. Click Create.
   

   Note

   Save this file carefully, as it cannot be recovered once it is lost.

   
   
   Figure: Generate Key - Select Key Type 
9. A new pop-up window displays a confirmation message saying Private key saved to your computer.
   
   
   Figure: Generate Key - Private Key Saved
   

   Note

   Retrieve the Client Email and Private Key from the downloaded JSON file, then pass them along to the SymphonyAI team for configuration in the Bot setting.

Step 3: Enable Google Chat API 

Enabling the Google Chat API is a crucial step in integrating Digital Agent with Google Chat. The Google Chat API allows developers to build applications that can interact programmatically with Google Chat spaces. 

To enable Google Chat API, perform the following steps:

1. From the left navigation panel, click APIs & Services > Enabled APIs and services.
   
   
   Figure: Enable Google Chat API 
2. Click + Enable APIs and services to enable the APIs for Digital Agent.
   
   
   Figure: Enable API and Services 
3. Navigate to the search bar and search for Google Chat API and select it.
   
   
   Figure: Search Google Chat API
4. Click Enable to enable the Google Chat API.
   
   
   Figure: Enable Google Chat API
5. Configure your Google Chat bot once the Google Chat API is enabled.

Step 4: Configure your Google Chat bot 

Configuring your Google Chat bot is a vital step in the process of integrating Digital Agent with Google Chat. This configuration involves setting up the necessary parameters, permissions, and behavior of Digital Agent within the Google Chat environment. 

To configure your Google Chat bot, perform the following steps: 

1. Navigate to CONFIGURATION tab.
   
   
   Figure: Configuration tab
2. Click Save to save all the configuration details. Mention the below details in the following screen to configure your Google Chat bot:
   
   
   Figure: Google Chat bot - configuration details
   
   
   1. Enter the name for your app.
   2. Add the avatar URL.
   3. Enter the description relevant to your app.
   4. Toggle the switch next to Interactive features to enable it.
   5. Click on both the checkboxes under the Functionality section.
   6. Under Connection settings, select App URL and add the app URL in the App URL field.
      

      Note

      The app URL will be provided by the SymphonyAI team.

   7. Scroll down to the Visibility section and enter the email addresses to add individuals and groups to your domain. 
   8. Click Save to save all the configuration details.