Google Sheets Integration Template

Nutze Google Sheets als einfache, aber mächtige Datenquelle für deine Mid-call Actions. Ideal für kleinere Teams oder spezielle Use Cases, wo komplexe CRM-Systeme überdimensioniert wären.

Überblick & Anwendungsfälle

Einfache Datenhaltung

Kundenlisten ohne komplexes CRM
Produktkataloge und Preislisten
Terminkalender und Verfügbarkeiten
Inventory-Tracking für kleine Unternehmen

Kollaborative Workflows

Mehrere Teams arbeiten am gleichen Datenbestand
Echtzeit-Updates für alle Beteiligten
Einfache Berechtigungsverwaltung
No-Code-Ansatz für nicht-technische Mitarbeiter

Vorbereitende Schritte

1. Google Cloud Console Setup

Projekt erstellen

Geh zur Google Cloud Console
Erstelle ein neues Projekt oder wähle ein bestehendes
Notiere dir die Projekt-ID

Google Sheets API aktivieren

Navigiere zu “APIs & Services” → “Bibliothek”
Suche nach “Google Sheets API”
Klicke auf “Aktivieren”

Service Account erstellen

Schritte:
"APIs & Services" → "Anmeldedaten"
"+ ANMELDEDATEN ERSTELLEN" → "Dienstkonto"
Name: "Famulor-Mid-call Actions"
Rolle: "Editor" oder "Viewer" (je nach Bedarf)
JSON-Key herunterladen und sicher speichern

Sheet-Berechtigungen setzen

Öffne dein Google Sheet
Klicke auf “Teilen”
Füge die Service Account E-Mail hinzu
Setze Berechtigungen auf “Bearbeiter” oder “Betrachter”

2. Sheet-Struktur vorbereiten

Kundendaten-Sheet
Produkt-Katalog
Terminkalender

| A: E-Mail         | B: Name        | C: Telefon    | D: Firma      | E: Status    | F: Letzte Aktualisierung |
|------------------|----------------|---------------|---------------|--------------|---------------------------|
| max@beispiel.de  | Max Mustermann | +49123456789  | Beispiel GmbH | Aktiv        | 2024-01-15 10:30         |
| anna@test.de     | Anna Schmidt   | +49987654321  | Test AG       | Lead         | 2024-01-14 15:22         |

| A: Produkt-ID | B: Name              | C: Preis | D: Verfügbar | E: Kategorie | F: Beschreibung          |
|---------------|---------------------|----------|--------------|--------------|--------------------------|
| PROD001       | Basic Package       | 99.00    | Ja           | Software     | Standard-Features        |
| PROD002       | Professional Package| 199.00   | Ja           | Software     | Erweiterte Funktionen    |

| A: Datum     | B: Uhrzeit | C: Verfügbar | D: Gebucht von    | E: Typ      | F: Notizen |
|--------------|------------|--------------|-------------------|-------------|------------|
| 2024-01-16   | 10:00      | Nein         | max@beispiel.de   | Demo        | Website    |
| 2024-01-16   | 14:00      | Ja           |                   |             |            |

Daten-Abruf-Tool konfigurieren

1. Tool-Basis-Konfiguration

Tool-Setup
Authentication

Parameter	Wert
Funktionsname	`get_sheets_data`
Beschreibung	”Ruft Daten aus Google Sheets ab. Verwenden Sie dies für Kundendaten, Produktinfos oder andere strukturierte Informationen.”
HTTP-Methode	`GET`
URL	`https://sheets.googleapis.com/v4/spreadsheets/{sheet_id}/values/{range}`
Timeout	`8000ms`

Authentication Type: "OAuth 2.0" oder "Service Account"

Service Account (empfohlen):
  Headers:
    Authorization: "Bearer {access_token}"
    Content-Type: "application/json"

OAuth 2.0 (für User-Context):
  Headers:
    Authorization: "Bearer {user_access_token}"
    Content-Type: "application/json"

2. Parameter-Schema für Datenabfrage

{
  "type": "object",
  "properties": {
    "sheet_id": {
      "type": "string",
      "description": "Google Sheets ID (aus der URL extrahiert)"
    },
    "range": {
      "type": "string",
      "description": "Zellbereich im A1-Notation (z.B. 'Sheet1!A:F' oder 'Kunden!A2:F100')",
      "examples": ["Sheet1!A:F", "Kunden!A2:F100", "Produkte!A1:D"]
    },
    "search_column": {
      "type": "string", 
      "description": "Spalte für Suchkriterium (z.B. 'A' für E-Mail)"
    },
    "search_value": {
      "type": "string",
      "description": "Suchwert (z.B. E-Mail-Adresse des Kunden)"
    },
    "major_dimension": {
      "type": "string",
      "enum": ["ROWS", "COLUMNS"],
      "default": "ROWS",
      "description": "Datenausrichtung in der Antwort"
    },
    "value_render_option": {
      "type": "string",
      "enum": ["FORMATTED_VALUE", "UNFORMATTED_VALUE", "FORMULA"],
      "default": "FORMATTED_VALUE",
      "description": "Wie Werte zurückgegeben werden sollen"
    }
  },
  "required": ["sheet_id", "range"]
}

3. Erweiterte Suchfunktion

Zeilen-spezifische Suche

URL für gefilterte Suche:

https://sheets.googleapis.com/v4/spreadsheets/{sheet_id}/values/{range}

Post-Processing in der KI:

Logik:
Alle Daten aus Bereich abrufen
Erste Zeile als Headers verwenden
Nach E-Mail oder anderem Kriterium filtern
Gefundene Zeile als strukturierte Daten zurückgeben

Batch-Abfragen

URL für mehrere Bereiche:

https://sheets.googleapis.com/v4/spreadsheets/{sheet_id}/values:batchGet?ranges={range1}&ranges={range2}

Verwendung:

Beispiel:
  ranges: ["Kunden!A:F", "Produkte!A:D", "Termine!A:F"]
  Zweck: Alle relevanten Daten in einem API-Call
  Performance: Reduziert Latenz bei Multi-Table-Lookup

Daten-Update-Tool

1. Tool-Konfiguration für Updates

Update-Tool-Setup
Request Body

Parameter	Wert
Funktionsname	`update_sheets_data`
Beschreibung	”Aktualisiert Daten in Google Sheets basierend auf Gesprächsinformationen.”
HTTP-Methode	`PUT`
URL	`https://sheets.googleapis.com/v4/spreadsheets/{sheet_id}/values/{range}`

{
  "range": "{range}",
  "majorDimension": "ROWS",
  "values": [
    ["{value1}", "{value2}", "{value3}", "{timestamp}"]
  ],
  "valueInputOption": "USER_ENTERED"
}

2. Parameter-Schema für Updates

{
  "type": "object",
  "properties": {
    "sheet_id": {
      "type": "string",
      "description": "Google Sheets ID"
    },
    "range": {
      "type": "string",
      "description": "Spezifischer Zellbereich für Update (z.B. 'Sheet1!A2:F2')"
    },
    "values": {
      "type": "array",
      "items": {
        "type": "array",
        "items": {"type": "string"}
      },
      "description": "2D-Array mit den neuen Werten"
    },
    "value_input_option": {
      "type": "string",
      "enum": ["RAW", "USER_ENTERED"],
      "default": "USER_ENTERED",
      "description": "Wie Eingabewerte interpretiert werden"
    }
  },
  "required": ["sheet_id", "range", "values"]
}

Praktische Implementierung

Szenario 1: Kundenservice mit Sheets-Datenbank

Kundenerkennung

Kunde: "Meine E-Mail ist max@beispiel.de"

Tool-Call:
  get_sheets_data(
    sheet_id: "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms",
    range: "Kunden!A:F",
    search_column: "A",
    search_value: "max@beispiel.de"
  )

Datenverarbeitung

Response-Verarbeitung:
  - Zeile mit E-Mail gefunden
  - Name: "Max Mustermann"
  - Status: "Aktiv"
  - Letzte Aktualisierung: "2024-01-15"
  
KI-Integration:
  "Hallo Herr Mustermann! Ich sehe, Sie sind seit dem 15. Januar bei uns registriert."

Status-Update

Nach Gespräch:
  update_sheets_data(
    range: "Kunden!E2:F2",
    values: [["Kontaktiert", "2024-01-16 14:30"]]
  )

Szenario 2: Produktberatung mit Sheets-Katalog

Response-Verarbeitung

Typische API-Antwort

{
  "range": "Kunden!A1:F3",
  "majorDimension": "ROWS",
  "values": [
    ["E-Mail", "Name", "Telefon", "Firma", "Status", "Letzte Aktualisierung"],
    ["max@beispiel.de", "Max Mustermann", "+49123456789", "Beispiel GmbH", "Aktiv", "2024-01-15 10:30"],
    ["anna@test.de", "Anna Schmidt", "+49987654321", "Test AG", "Lead", "2024-01-14 15:22"]
  ]
}

KI-Integration

Strukturierte Datenverarbeitung

Data-Processing-Logik:
  1. Erste Zeile als Header-Mapping verwenden
  2. Relevante Zeile(n) basierend auf Suchkriterium finden
  3. Key-Value-Pairs für natürliche Sprachverwendung erstellen
  
Beispiel:
  Input: ["max@beispiel.de", "Max Mustermann", "+49123456789", "Beispiel GmbH", "Aktiv", "2024-01-15 10:30"]
  Output: {
    "email": "max@beispiel.de",
    "name": "Max Mustermann", 
    "phone": "+49123456789",
    "company": "Beispiel GmbH",
    "status": "Aktiv",
    "last_updated": "2024-01-15 10:30"
  }

Natürliche Sprachverwendung

Kontextualisierte_Antworten:
  Status "Aktiv":
    "Ich sehe, Sie sind bereits bei uns registriert und Ihr Account ist aktiv."
  
  Status "Lead":
    "Ich sehe, Sie haben bereits Interesse gezeigt. Wie kann ich Ihnen weiterhelfen?"
  
  Keine_Daten:
    "Ich kann Sie noch nicht in unserem System finden. Gerne lege ich einen neuen Eintrag an."
  
  Veraltete_Daten:
    "Ihre letzten Informationen sind vom {date}. Lassen Sie mich das aktualisieren."

Erweiterte Features

Formeln und Berechnungen

Automatische Berechnungen
Bedingte Formatierung

Sheet-Formeln für Mid-call Actions:
  
  Lead-Score-Berechnung:
    Spalte G: =IF(E2="Hot",100,IF(E2="Warm",60,IF(E2="Cold",20,0)))
  
  Tage-seit-letztem-Kontakt:
    Spalte H: =TODAY()-F2
  
  Nächste-Follow-up-Erinnerung:
    Spalte I: =F2+7
  
Verwendung im Tool:
  - Berechnete Werte automatisch verfügbar
  - Keine separate Logik in Mid-call Action nötig
  - Sheets übernimmt Business-Logic

Visuelle_Indikatoren:
  High-Value-Kunden: Grüner Hintergrund bei Deal-Wert >10k
  Überfällige_Follow-ups: Roter Hintergrund bei Datum < Heute
  Neue_Leads: Blauer Hintergrund bei Status = "Neu"

Tool-Integration:
  - Formatierung nicht direkt verfügbar in API
  - Aber: Bedingte Werte über Formeln abfragbar
  - Beispiel: Status-Spalte mit berechneten Prioritäts-Indikatoren

Multi-Sheet-Workflows

Referenzielle Integrität

Sheet-Struktur:
  1. Kunden-Sheet (Master-Data):
     - Kunde-ID, Name, E-Mail, Firma
  
  2. Interaktionen-Sheet (Transaction-Log):
     - Datum, Kunde-ID, Typ, Details, Agent
  
  3. Produkte-Sheet (Catalog):
     - Produkt-ID, Name, Preis, Kategorie
  
  4. Angebote-Sheet (Opportunities):
     - Angebots-ID, Kunde-ID, Produkt-ID, Status, Wert

Cross-Sheet-Lookups:
  =VLOOKUP(A2,Kunden!A:C,2,FALSE) // Name basierend auf Kunde-ID
  =SUMIF(Angebote!B:B,A2,Angebote!F:F) // Total-Value per Kunde

Workflow-Orchestration

Komplexer_Mid-Call-Workflow:
  1. Kundendaten aus Kunden-Sheet abrufen
  2. Interaktionshistorie aus Interaktionen-Sheet laden
  3. Verfügbare Produkte aus Produkte-Sheet anzeigen
  4. Bei Interesse: Neues Angebot in Angebote-Sheet erstellen
  5. Interaktion in Interaktionen-Sheet protokollieren

Tool-Chain:
  get_customer_data → get_interaction_history → get_available_products
  → create_opportunity → log_interaction

Performance & Optimierung

Caching-Strategien

Read-Heavy-Optimization

Für häufig abgefragte Daten:

Cache für 5-10 Minuten
Besonders für Produktkataloge
Reduziert API-Quota-Verbrauch

Write-Through-Cache

Für Updates:

Sofortiges Update im Cache
Asynchrone Sheet-Aktualisierung
Konsistenz-Checks implementieren

Google Sheets API Limits

Limit-Typ	Wert	Best Practice
Requests per 100 seconds	300	Batch-Operationen verwenden
Requests per day	50,000	Caching implementieren
Concurrent requests	10	Request-Pooling verwenden
Cells updated per request	10,000,000	Effiziente Range-Spezifikation

Fehlerbehandlung

Häufige Fehlerszenarien

Authentifizierung (401/403)
Sheet nicht gefunden (404)
Rate Limiting (429)

Ursachen:
  - Service Account Key abgelaufen
  - Insufficient permissions auf Sheet
  - Sheets API nicht aktiviert

Fallback:
  "Entschuldigung, ich kann momentan nicht auf unsere Datenbank zugreifen. 
   Können Sie mir Ihre Informationen noch einmal nennen?"

Resolution:
  - Service Account Permissions prüfen
  - Sheet-Sharing-Einstellungen überprüfen  
  - API-Quota-Status checken

Ursachen:
  - Falsche Sheet-ID in Konfiguration
  - Sheet wurde gelöscht oder verschoben
  - Range existiert nicht (invalider Bereich)

Graceful-Fallback:
  "Es scheint ein Problem mit unserer Datenbank zu geben. 
   Lassen Sie mich Ihnen trotzdem weiterhelfen."
  
Prevention:
  - Sheet-ID-Validation vor Deployment
  - Health-Checks für kritische Sheets
  - Backup-Sheets für Notfälle

Handling:
  - Exponential Backoff: 1s, 2s, 4s
  - Request-Queuing implementieren
  - Batch-Updates wo möglich

User-Communication:
  "Einen Moment bitte, ich lade Ihre Daten..."
  
Prevention:
  - Intelligentes Caching
  - Request-Deduplication
  - Off-Peak-Batch-Processing

Sicherheit & Compliance

Datenschutz-Überlegungen

DSGVO-Konformität

Privacy-by-Design:
  - Minimale Datenerfassung (nur notwendige Spalten)
  - Pseudonymisierung wo möglich
  - Automatische Löschung nach Retention-Period
  
User-Rights:
  - Right to Access: Export-Funktionen
  - Right to Rectification: Update-Workflows
  - Right to Erasure: Delete-Workflows
  - Right to Portability: Standard-Export-Formate

Audit-Trail:
  - Separate "Audit"-Spalte mit Change-Timestamps
  - Change-Log-Sheet für kritische Änderungen
  - Access-Logging über Google Workspace

Access Control

Sheet-Level-Security:
  - Service Account mit minimalen Rechten
  - Sheet-spezifische Permissions
  - Regular Access Reviews

Data-Level-Security:
  - Sensitive Daten in separate Sheets
  - Range-Protection für kritische Bereiche
  - Cell-Level-Permissions wo nötig

Network-Security:
  - HTTPS-only für alle API-Calls
  - IP-Restrictions für Service Accounts
  - VPN-Requirements für Admin-Access

Migration & Skalierung

Von Sheets zu CRM migrieren

Hybrid-Ansatz

Sheets parallel zu CRM betreiben
Schrittweise Daten-Migration
Tool-Configuration für beide Systeme

Data-Sync implementieren

Bidirectional Sync zwischen Sheets und CRM
Conflict-Resolution-Strategies
Data-Quality-Checks

Graduelle Tool-Migration

Read-Operationen zuerst auf CRM umstellen
Write-Operationen weiter über Sheets
Final Switch nach Validierungsphase

Erweiterte Integrationen

Kombiniere Google Sheets mit anderen Tools:

Webhook-Automation für komplexere Workflows
Zapier-Integration für No-Code-Automatisierung
HubSpot Integration für CRM-Upgrade

Performance-Tipp: Für Teams mit >50 täglichen Mid-call Action-Nutzern solltest du ein dediziertes CRM-System in Betracht ziehen. Google Sheets ist ideal für kleinere Teams oder spezielle Use Cases.

Backup-Strategie: Google Sheets bietet automatische Versionierung, aber implementiere zusätzliche Backup-Mechanismen für geschäftskritische Daten.

Statt einzelner HTTP-Aktionen ein ganzes Toolset auf einmal? Externen MCP-Server verbinden — Tools werden automatisch erkannt. Siehe MCP-Server.

Mid-Call-Tools

Mid-Call-Tools Integrationen

Google Sheets Integration

Google Sheets Integration Template

Überblick & Anwendungsfälle

Einfache Datenhaltung

Kollaborative Workflows

Vorbereitende Schritte

1. Google Cloud Console Setup

2. Sheet-Struktur vorbereiten

Daten-Abruf-Tool konfigurieren

1. Tool-Basis-Konfiguration

2. Parameter-Schema für Datenabfrage

3. Erweiterte Suchfunktion

Daten-Update-Tool

1. Tool-Konfiguration für Updates

2. Parameter-Schema für Updates

Praktische Implementierung

Szenario 1: Kundenservice mit Sheets-Datenbank

Szenario 2: Produktberatung mit Sheets-Katalog

Response-Verarbeitung

Typische API-Antwort

KI-Integration

Erweiterte Features

Formeln und Berechnungen

Multi-Sheet-Workflows

Performance & Optimierung

Caching-Strategien

Read-Heavy-Optimization

Write-Through-Cache

Google Sheets API Limits

Fehlerbehandlung

Häufige Fehlerszenarien

Sicherheit & Compliance

Datenschutz-Überlegungen

Migration & Skalierung

Von Sheets zu CRM migrieren

Erweiterte Integrationen

​Google Sheets Integration Template

​Überblick & Anwendungsfälle

Einfache Datenhaltung

Kollaborative Workflows

​Vorbereitende Schritte

​1. Google Cloud Console Setup

​2. Sheet-Struktur vorbereiten

​Daten-Abruf-Tool konfigurieren

​1. Tool-Basis-Konfiguration

​2. Parameter-Schema für Datenabfrage

​3. Erweiterte Suchfunktion

​Daten-Update-Tool

​1. Tool-Konfiguration für Updates

​2. Parameter-Schema für Updates

​Praktische Implementierung

​Szenario 1: Kundenservice mit Sheets-Datenbank

​Szenario 2: Produktberatung mit Sheets-Katalog

​Response-Verarbeitung

​Typische API-Antwort

​KI-Integration

​Erweiterte Features

​Formeln und Berechnungen

​Multi-Sheet-Workflows

​Performance & Optimierung

​Caching-Strategien

Read-Heavy-Optimization

Write-Through-Cache

​Google Sheets API Limits

​Fehlerbehandlung

​Häufige Fehlerszenarien

​Sicherheit & Compliance

​Datenschutz-Überlegungen

​Migration & Skalierung

​Von Sheets zu CRM migrieren

Erweiterte Integrationen

Google Sheets Integration Template

Überblick & Anwendungsfälle

Vorbereitende Schritte

1. Google Cloud Console Setup

2. Sheet-Struktur vorbereiten

Daten-Abruf-Tool konfigurieren

1. Tool-Basis-Konfiguration

2. Parameter-Schema für Datenabfrage

3. Erweiterte Suchfunktion

Daten-Update-Tool

1. Tool-Konfiguration für Updates

2. Parameter-Schema für Updates

Praktische Implementierung

Szenario 1: Kundenservice mit Sheets-Datenbank

Szenario 2: Produktberatung mit Sheets-Katalog

Response-Verarbeitung

Typische API-Antwort

KI-Integration

Erweiterte Features

Formeln und Berechnungen

Multi-Sheet-Workflows

Performance & Optimierung

Caching-Strategien

Google Sheets API Limits

Fehlerbehandlung

Häufige Fehlerszenarien

Sicherheit & Compliance

Datenschutz-Überlegungen

Migration & Skalierung

Von Sheets zu CRM migrieren