Skip to content
Lobu Lobu
API Blog

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.

C
Coding
online
List open PRs in lobu-ai/lobu12:01
Can't reach github.com, not in the agent's allowed domains. Grant access?12:01
Allow for 1 hour12:01
Added github.com to allowed domains. 3 open PRs in lobu-ai/lobu: • #214 Fix worker memory leak • #219 Telegram adapter retries • #223 Add Bedrock provider12:01
O
Ops Assistant
online
Summarize my active Linear sprint12:01
I need the `linear` skill to query Linear. It bundles the Linear MCP and handles OAuth via Lobu.12:01
Go ahead12:01
Installed and connected. Sprint "Week 15" (68% done): • 11 merged, 3 in review, 2 todo • Blocked: AUTH-234 (design) • At risk: API-89 (due tomorrow)12:01
A
Assistant
online
Switch to Claude Sonnet12:01
You can change the model from your settings, opens a scoped page with your current agent config.12:01
Done, set to claude-sonnet-4-612:01
Now running on claude-sonnet-4-6 via OpenRouter. Next messages will use the new model.12:01

Setup

Section titled “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 → Platforms in the web app to add Google Chat to your agent, or run lobu init to scaffold a local project and pick Google Chat in the wizard.

Configuration

Section titled “Configuration”

Authentication

Section titled “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

Section titled “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

Section titled “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.