Google Chat Plugin

<Info> The registry ID for this plugin is `google-chat` (with a hyphen). Use `eliza plugins install google-chat` to install. </Info>

The Google Chat plugin connects Eliza agents to Google Chat via a Google Cloud service account, supporting spaces, DMs, and group conversations with webhook-based event delivery.

Package: @elizaos/plugin-google-chat

Installation

bash

eliza plugins install google-chat

Setup

1. Create a Google Cloud Project

Go to the Google Cloud Console
Create a new project or select an existing one
Enable the Google Chat API

2. Create a Service Account

Navigate to IAM & Admin → Service Accounts
Create a new service account
Grant the Chat Bot role
Create a JSON key and download it

3. Configure the Chat App

Go to the Google Chat API configuration
Set the App URL to your webhook endpoint:
```
https://your-eliza-host/google-chat
```
Note the Project Number for audience configuration

4. Configure Eliza

json

{
  "connectors": {
    "googlechat": {
      "enabled": true,
      "serviceAccountFile": "./service-account.json",
      "audienceType": "project-number",
      "audience": "123456789",
      "webhookPath": "/google-chat"
    }
  }
}

Configuration

Field	Required	Description
`serviceAccountFile`	Yes*	Path to service account JSON key file
`serviceAccountJson`	Yes*	Inline service account JSON (alternative to file)
`audienceType`	Yes	`app-url` or `project-number`
`audience`	Yes	App URL or project number (matches `audienceType`)
`webhookPath`	No	Webhook endpoint path (default: `/google-chat`)
`webhookUrl`	No	Full webhook URL override
`typingIndicator`	No	`none`, `message`, or `reaction` (default: `none`)
`dmPolicy`	No	DM handling policy

* Provide either serviceAccountFile or serviceAccountJson.

Features

Service account auth — Authenticate via JSON key file or inline JSON
Webhook delivery — Receive events via configurable webhook endpoint
Typing indicators — Configurable indicator modes (none, message, reaction)
Per-space configuration — Override mention requirements and tools per space
DM support — Private conversation handling with configurable policy
Group chats — Respond in spaces with optional mention requirements
Multi-account — Supports multiple accounts via accounts map

Environment Variables

Variable	Required	Description
`GOOGLE_CHAT_ENABLED`	No	Enable or disable the connector
`GOOGLE_CHAT_SPACES`	No	Comma-separated Space IDs to join
`GOOGLE_CHAT_AUDIENCE`	No	App URL or project number for JWT verification
`GOOGLE_CHAT_BOT_USER`	No	Bot user identifier
`GOOGLE_CHAT_WEBHOOK_PATH`	No	Webhook endpoint path
`GOOGLE_CHAT_AUDIENCE_TYPE`	No	Audience type: `app-url` or `project-number`
`GOOGLE_CHAT_REQUIRE_MENTION`	No	Only respond when @mentioned
`GOOGLE_CHAT_SERVICE_ACCOUNT`	No	Inline service account JSON
`GOOGLE_APPLICATION_CREDENTIALS`	No	Path to Google application credentials JSON
`GOOGLE_CHAT_SERVICE_ACCOUNT_FILE`	No	Path to service account JSON key file

Auto-Enable

The plugin auto-enables when the connectors.googlechat block contains botToken, token, or apiKey. Note that serviceAccountFile alone does not trigger auto-enable. Include "apiKey": "placeholder" to trigger auto-enable when using service account auth, or add the plugin to plugins.allow explicitly: