Skip to main content
When you connect AI Helpdesk to Google Chat, users can send inquiries to the AI bot from Google Chat spaces, threads, and direct messages. Google Chat integration uses the Custom Bot method, in which you configure a GCP project and a Google Chat app in your own environment. Replies in threads are supported.

​
Prerequisites

  • You must have the Admin role in AI Helpdesk.
  • You must have Google Workspace super admin access (required to configure domain-wide delegation).
  • You need access to the Google Cloud Console (GCP) (it can be the same account as your Google Workspace admin, or a different one).

​
Required information

The connection form asks for the four values below. You will collect them as you go through the steps.
ItemDescription
GCP Project NumberThe Project number of your GCP project (numeric — not the Project ID)
Service Account JSONThe full JSON key file of the service account
Bot Display NameThe bot’s display name in Google Chat (same value as the App name set in Step 5)
Admin EmailThe Google Workspace super admin email address the service account will impersonate

​
Step 1: Create a GCP project

1

Open the Google Cloud Console

Go to https://console.cloud.google.com and click the project selector at the top of the page, then click New Project.
2

Create the project

Enter a project name (e.g. minabot-chat) and click Create. Once created, select the project.
3

Copy the Project Number

From the Dashboard, copy the Project number in the Project info card (e.g. 123456789012). This is the GCP Project Number in the connection form.
Use the Project number (numeric value), not the Project ID.

​
Step 2: Enable the required APIs

In the GCP project, open APIs & Services > Library and enable the following two APIs.
  • Google Chat API
  • Admin SDK API

​
Step 3: Create a service account

1

Create the service account

Open IAM & Admin > Service Accounts in the GCP project and click Create Service Account.
  • Name: any value (e.g. minabot-chat-bot)
  • Description: optional
Click Create and Continue, then click Done without assigning roles.
2

Download the JSON key

Click the service account you just created and open the Keys tab. Click Add Key > Create new key, choose JSON, and click Create.A JSON file is downloaded automatically.
The JSON file cannot be re-downloaded. Store it securely.
The entire JSON (including the surrounding braces) is the value you will paste into the Service Account JSON field.

​
Step 4: Set up domain-wide delegation (DWD)

This allows the service account to look up users in your Google Workspace directory.
1

Enable DWD on the service account

In GCP, open IAM & Admin > Service Accounts and select your service account. On the Details tab, expand Advanced settings and enable Domain-wide delegation, then save.Take note of the Client ID (numeric) that appears after saving.
2

Authorize the OAuth scopes in the Google Workspace Admin Console

Open https://admin.google.com and go to Security > Access and data control > API controls. Under Manage Domain Wide Delegation, click Add new.
  • Client ID: the value noted in the previous step
  • OAuth scopes: enter the three scopes below as a single comma-separated line
    • https://www.googleapis.com/auth/chat.spaces.create
    • https://www.googleapis.com/auth/admin.directory.user.readonly
    • https://www.googleapis.com/auth/chat.bot
    Copy the following line as-is (no whitespace between commas): 
    https://www.googleapis.com/auth/chat.spaces.create,https://www.googleapis.com/auth/admin.directory.user.readonly,https://www.googleapis.com/auth/chat.bot
Click Authorize.
3

Decide on the Admin Email

Decide which Google Workspace super admin email address the service account will impersonate (e.g. admin@example.com). This is the Admin Email value in the connection form.

​
Step 5: Configure the Google Chat app

1

Open the Google Chat API configuration

In your GCP project, open APIs & Services > Google Chat API > Configuration.
2

Fill in basic information

  • App name: the bot’s display name (e.g. Mina)
  • Avatar URL: optional (URL of the bot’s icon)
  • Description: optional
3

Configure functionality and connection

Under Functionality, enable:
  • Receive 1:1 messages
  • Join spaces and group conversations
Under Connection settings, choose App URL and enter:
https://assist.i.moneyforward.com/chat/googlechat
4

Set the visibility

Under Permissions, choose the visibility:
  • Specific people and groups in your domain (recommended for testing)
  • Everyone in your domain
Click Save.

​
Step 6: Add the bot to a space

In Google Chat, open the space where you want to use the bot and:
  1. Click the space name > Apps & integrations > Add apps.
  2. Search for your configured app name and click Add.
The bot is now active in that space.

​
Step 7: Finish the connection in AI Helpdesk

1

Open integration settings

In Settings > Integrations > Messaging of AI Helpdesk, click Add connection and choose Google Chat — Custom Bot.
2

Enter the credentials

Enter the following values:
  • GCP Project Number: the numeric value from Step 1
  • Service Account JSON: the entire JSON downloaded in Step 3
  • Bot Display Name: the App name configured for the Google Chat app in Step 5
  • Admin Email: the Google Workspace super admin email from Step 4
3

Complete the connection

Click Connect. If the credentials are valid, the connected card appears in the Messaging section.

​
Using the bot

Once connected, users can interact with the bot from Google Chat.

​
Ask questions via direct message

Send a question to the bot in a direct message to receive an AI response.

​
Mention the bot in a space

Mention the bot inside a space to receive an AI response in a thread. Continue replying in the same thread to keep the session going.

​
Disconnect Google Chat

In the Messaging section of Settings > Integrations, click the trash icon on the card to disconnect.
Disconnecting stops accepting new inquiries from that Google Workspace.

​
Troubleshooting

“Invalid credentials”
  • Confirm that the GCP Project Number is the numeric value (not the Project ID).
  • Confirm that the Service Account JSON includes the outer braces { } and is pasted in full.
  • Confirm that the Admin Email is a Google Workspace super admin account.
“Insufficient permissions”
  • Confirm that Google Chat API and Admin SDK API are both enabled (Step 2).
  • Confirm that all required OAuth scopes are authorized in the Google Workspace Admin Console (Step 4).
The bot is not responding
  • Confirm that the Connection settings > App URL in Step 5 points to the correct webhook URL.
  • Confirm that the bot has been added to the space in Step 6.
  • Confirm that you are correctly mentioning the bot in the space.
Last modified on July 10, 2026