Integrating Digital Agent into Google Chat elevates collaboration and efficiency within your workspace. Seamlessly combine the power of Google Chat's real-time communication with the intelligence of Digital Agent to 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:
- Login to your Google account.
- Go to the Google Console Developer portal.
- Click Go to Create a Project. (Refer the following screenshot)
Figure: Google Console – Create a project - 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 - 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:
- From the left navigation panel, navigate to IAM & Admin > Service Accounts. (Refer the following screenshot)
Figure: Google Console – Service Accounts - Click + CREATE SERVICE ACCOUNT to create Service account for Digital Agent. (Refer the following screenshot)
Figure: Google Console - Create Service Account - In the next screen fill in Service Account details in Step 1 such as Service account name, Service account ID, and Service account description.
- Click CREATE AND CONTINUE to create Service account.
Figure: Create Service Account - details - Steps 2 and 3 are optional and can be skipped.
- 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 - Navigate to the KEYS tab. Click ADD KEY and select Create new key from the dropdown menu.
Figure: Generate Key - Add New Key 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 TypeA new pop-up window displays a confirmation message "Private key saved to your computer."
Figure: Generate Key - Private Key SavedNote
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:
- From the left navigation panel, click APIs & Services > Enabled APIs and services.
Figure: Enable Google Chat API - Click + Enable APIs and services to enable the APIs for Digital Agent.
Figure: Enable API and Services - Navigate to the search bar and search for Google Chat API and select it.
Figure: Search Google Chat API - Click Enable to enable the Google Chat API.
Figure: Enable Google Chat API - 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:
- Navigate to CONFIGURATION tab.
Figure: Configuration tab - 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- Enter the name for your app.
- Add the avatar URL.
- Enter the description relevant to your app.
- Toggle the switch next to Interactive features to enable it.
- Click on both the check boxes under the Functionality section.
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.
- Scroll down to the Visibility section and enter the email addresses to add individuals and groups to your domain.
- Click Save to save all the configuration details.
Step 5: Configure Digital Agent app in the Google Workspace Marketplace SDK
Using the Google Workspace Marketplace SDK is necessary for managing Digital Agent app on the Marketplace, regardless of whether you are publishing it privately or publicly.
Configure and manage Digital Agent app on the Google Workspace Marketplace using the Google Workspace Marketplace SDK. SDK is a toolkit for creating and managing apps on the Marketplace. To make Digital Agent app available in Google Chat, you need to set it up in the SDK. SDK allows you to do the following activities:
- Select whether you want Digital Agent app to be publicly accessible to all Marketplace users or privately accessible to certain Google Workspace organizations.
- Define the types of users who can install Digital Agent app from the Marketplace.
- Mention the Google Workspace apps that Digital Agent app is compatible with.
- Set the OAuth scopes required by Digital Agent app.
- Provide details about people who have created Digital Agent and maintain them.
Enable the Google Workspace Marketplace SDK
Click here to enable Google Workspace Marketplace SDK in your Google Cloud project.
To enable Google Workspace Marketplace SDK in your Google Cloud project, perform the following steps:
- Open the Google Cloud Console.