> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Chat

> Auf @Erwähnungen und Direktnachrichten in Google Chat antworten

Google Chat lässt den Assistenten in Google Workspace antworten. Jemand schreibt der App direkt oder erwähnt sie mit @ in einem Space, und die Antwort bleibt in diesem Chat-Thread. Derselbe Thread liegt im Verlauf.

## Wann du ihn nutzt

Nutze ihn, wenn das Team schon in Google Chat arbeitet: eine direkte Frage an den Assistenten oder eine @Erwähnung in einem Space, in dem die Arbeit liegt. Einen Assistenten zu verbinden heißt, dass die Antwort seine Anweisungen und Werkzeuge nutzt.

## Was der Assistent hört

Google Chat stellt Direktnachrichten und @Erwähnungen an die HTTP-Adresse zu, die du an der Chat-App speicherst. Famulor richtet kein Pub/Sub ein. Nachrichten, die Google nur über Pub/Sub liefern würde, gehören nicht zu dieser Verbindung.

## Woher die Schlüssel kommen

Die verlinkte Anbieter-Anleitung zeigt die Bildschirme zu diesen Klicks. Folge den Klicks unten zusammen mit diesen Bildern.

Lege in der [Google Cloud Console](https://console.cloud.google.com) ein Dienstkonto an und lade einen JSON-Schlüssel herunter. Die Datei muss die E-Mail des Dienstkontos und den privaten Schlüssel enthalten. Die **GCP project number** ist die Nummer auf dem Projekt-Dashboard, nicht die Projekt-ID. Blockiert die Organisation neue Schlüssel, muss ein Workspace-Admin einen Schlüssel für dieses Projekt erlauben. Offizielle Anleitungen: [Chat-App konfigurieren](https://developers.google.com/workspace/chat/configure-chat-api) und [Anfragen prüfen](https://developers.google.com/workspace/chat/verify-requests-from-chat).

## Beim Anbieter anlegen

1. Lege in der Google Cloud Console ein Projekt an oder wähle eines und kopiere seine **Projektnummer**.
2. Öffne **APIs & Services → Library**, suche **Google Chat API** und aktiviere sie.
3. Öffne **IAM & Admin → Service Accounts → Create service account**.
4. Öffne das Konto, wähle **Keys → Add key → Create new key → JSON** und lade die Datei herunter.
5. Diese Datei und die Projektnummer fügst du in Famulor ein, bevor die Chat-App den Webhook aufrufen kann.

## In Famulor verbinden

Dein Plan enthält diesen Kanal. Öffne **Settings → Channels**, wähle die Karte, benenne die Verbindung, wähle einen Assistenten und speichere. Die gemeinsamen Konversationseinstellungen — Antwortverzögerung (Standard 5 Sekunden) und Inaktivitätszeit (Standard 30 Minuten) — stehen auf der Seite [Messaging-Kanäle](https://docs.famulor.io/de/channels/messaging.md).

Füge auf der Karte **Google Chat** **Service account JSON** und **GCP project number (required for JWT verification)** ein.

## Den Anbieter auf Famulor zeigen lassen

1. Kopiere die Famulor-Webhook-URL aus dem Menü der Verbindung.
2. Öffne die [Konfiguration der Google Chat API](https://console.cloud.google.com/apis/api/chat.googleapis.com/hangouts-chat).
3. Setze die HTTP-Endpunkt-URL auf diese Famulor-Adresse.
4. Setze die Authentication Audience auf dieselbe Projektnummer, die du in Famulor eingefügt hast.
5. Schalte 1:1-Nachrichten und das Beitreten zu Spaces ein. Begrenze die Sichtbarkeit beim Testen auf deine eigene Domain.
6. Speichere. Eine Direktnachricht oder eine @Erwähnung erscheint im Verlauf.

## Verlauf

Öffne den [Verlauf](https://docs.famulor.io/de/monitoring/history.md) und filtere nach **Google Chat**. Der Thread, die Antwort des Assistenten und eine vorhandene Auswertung erscheinen dort. Du kannst den Assistenten pausieren und selbst antworten.

## API, MCP und Kommandozeile

Lege diese Verbindung im Dashboard an. Die öffentliche API und die Kommandozeile können nicht jeden Wert übergeben, den diese Karte verlangt, und können dieses Setup deshalb nicht abschließen. Die Karte braucht das Dienstkonto-JSON und die Projektnummer, und ein öffentlicher Create-Aufruf nimmt diese Werte nicht an.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.