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
Step 1 - Login to Google Account with Workspace Credentials
Step 2 - Go to Google Cloud Platform
https://console.cloud.google.com/
Step 3 - Click on the Projects Dropdown
Located on the header of the page (ex. Aisera Staging0 Bot in below image).
Step 4 - Select "NEW PROJECT"
Step 5 - Fill out the Details 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.
Step 6 - Click on "ENABLE APIS AND SERVICES"
Button is located on the top of the page.
Step 7 - Search for the Chat Service from the API library
Step 8 - Select Google Chat API and "ENABLE"
Step 9 - Click on "CREATE CREDENTIALS"
Button is located on the top right of the page.
Step 10 - Fill Out the Credential Details, then Click "NEXT"
Follow image below:
Step 11 - Fill Out the Service Account Credential Details
Submit Changes by Clicking the "CREATE AND CONTINUE" button.
Step 12 - Grant This Service Account Access to Project
Select the role of Owner in the dropdown menu and click "CONTINUE".
Finish the setup by clicking the "DONE" button.
Step 13 - Navigate Back to the Main Google Chat API Screen -> Credentials Tab -> Click on Newly Created Service Account
Step 14 - Select "KEYS" Tab
Step 15 - Create New Key
Select the "ADD KEY" dropdown and then click on the "Create new key" option.
Select JSON as a key type in the modal window and click on "CREATE" button. The newly generated key will be stored in your local computer in json format (will be used later on the Aisera Admin UI). Click on the "CLOSE" button in the modal window.
Step 16 - Navigate to APIs & Services → Enabled APIs & Services → Google Chat API -> CONFIGURATION Tab
Click on the Navigation menu next to Google Cloud Platform logo.
Step 17 - 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
Step 18 - Check both Checkboxes Under the Functionality Setting
Step 19 - Fill Out the Connection Settings
App URL: the URL points to Aisera chatbot server accompanied with projectid and domain parameters (e.g. https://dev4.chatbot.aws-000-us-west-2.aisera.cloud/googleChat/receive?projectid=aisera-dev4-bot&domain=aisera.com)
Step 20 - Select Permissions Settings
First option if you want the chatbot to be available to all users under the workspace domain (e.g. everyone under aisera.com domain)
Secont option if you want to limit the access to specific users
Step 21 - Submit Changes by Clicking on the "SAVE" Button
IMPORTANT: Scroll up and a new field has appeared App status. Select from the dropdown: LIVE - available to users in order to enable the chatbot.
Setup Google Chatbot on AISX Platform
Step 1 - Login to the AISX Platform
Step 2 - Navigate to Settings → Channels → New Channel
Step 3 - Select Google Chat from the Channel Options
Step 4 - Fill Out the Configuration Fields
Follow image below (Service Account Credentials field are inside the json file downloaded in previous steps).
Step 5 - Save Your Changes with "OK"
Installing Google Chat
Step 1 - Open your browser and navigate to following URL
https://mail.google.com/chat/u/0/#chat/welcome
Step 2 - Login with Your Google Workspace Credentials
Go to the Chat section on the left menu (not Spaces or Meet) and click the plus icon.
Step 3 - Search and Add Bot to Chat Section
Search for the bot with its name either from the search bar or from the Find apps option and add it in the Chat section.
Step 4 - You are Ready to Go!
Last updated