Google Chat

Lobu’s Google Chat adapter supports direct messages, space mentions, and interactive workflows. Under the hood, Lobu uses @chat-adapter/gchat with the Google Chat API and Workspace Events.

Setup

1. Create a Google Cloud project and enable the Google Chat API and Workspace Events API.
2. Create a service account with the Chat Bot role, and download the JSON key file.
3. In the Google Chat API configuration, configure the app:
   • Set the App URL to your gateway’s webhook endpoint: https://your-gateway/api/v1/webhooks/{connectionId}
   • Enable Interactive features and configure the connection settings.
4. Use Agents → Connections in the web app to add Google Chat, or declare a gchat connection in lobu.config.ts.

Configuration

Field	Required	Type	Description
credentials	No	string	Service account credentials JSON string. Defaults to GOOGLE_CHAT_CREDENTIALS env var.
useApplicationDefaultCredentials	No	boolean	Use Application Default Credentials (ADC) instead of service account JSON.
endpointUrl	No	string	HTTP endpoint URL for button click actions. Required for HTTP endpoint apps.
googleChatProjectNumber	No	string	Google Cloud project number for verifying webhook JWTs. Defaults to GOOGLE_CHAT_PROJECT_NUMBER env var.
impersonateUser	No	string	User email for domain-wide delegation. Defaults to GOOGLE_CHAT_IMPERSONATE_USER env var.
pubsubAudience	No	string	Expected audience for Pub/Sub push JWT verification. Defaults to GOOGLE_CHAT_PUBSUB_AUDIENCE env var.
userName	No	string	Override bot username.

Authentication

The adapter supports three authentication modes:

• Service account JSON (default) — provide credentials with the JSON key contents.
• Application Default Credentials (ADC) — set useApplicationDefaultCredentials: true. Works with GCE, Cloud Run, Workload Identity Federation, or local gcloud auth application-default login.
• Custom auth client — for advanced use cases (programmatic only via the SDK).

Features

• Direct messages and space @mentions trigger the agent.
• Streaming responses with throttled message edits.
• Google Chat Cards v2 for interactive elements (buttons, permission grants, configuration).
• Workspace Events integration — subscribes to spaces for real-time message delivery.
• Pub/Sub support — receive events via Google Cloud Pub/Sub push subscriptions.
• Access control — restrict which users or groups can interact.

Typical Use Cases

• Internal assistant accessible from Google Workspace.
• Workflow automation triggered by team conversations in Google Chat spaces.
• Knowledge base bot for organizations using Google Workspace.