Zum Hauptinhalt springen
DocumentationAPI ReferenceVideo Tutorials

Google Calendar

Verbinden Sie Google Calendar, damit Ihre Sprachagenten Verfügbarkeiten prüfen und echte Termine buchen können, während der Anrufer noch in der Leitung ist. Einmal verbunden, kann jeder Agent in Ihrem Konto den Kalender nutzen — keine separate Autorisierung pro Agent nötig.

In jedem Tarif verfügbar

Google Calendar ist in allen Tarifen verfügbar, einschließlich Free. Keine Zusatzgebühr — Kalenderabfragen und Eventerstellung verbrauchen wenige Worte LLM-Ausgabe pro Sprechwechsel und werden zum normalen Minutenpreis abgerechnet.

Was es leistet​

  • Verfügbarkeitsprüfung — der Agent liest Ihren Kalender und bestätigt, ob ein gewünschter Slot frei ist.
  • Termin anlegen — der Agent legt einen bestätigten Termin als neuen Kalender-Event an, mit Name, Telefonnummer und allen während des Gesprächs erfassten Notizen.
  • Stornierungslinks — jede Buchung enthält einen Self-Service-Stornolink, den der Anrufer per E-Mail oder SMS erhält und mit dem er Termine ohne Rückruf ändern kann.

Der Agent liest keine Details fremder Termine, ändert keine unbeteiligten Events und gibt keine Kalenderinhalte preis — nur die Slots, die er zur Beantwortung des Anrufers benötigt.

Google-Konto verbinden​

  1. Öffnen Sie Integrationen in der Seitenleiste und klicken Sie auf Connect Google Calendar.
  2. Sie werden zum Standard-Zustimmungsbildschirm von Google weitergeleitet.
  3. Melden Sie sich mit dem Google-Konto an, dem der zu nutzende Kalender gehört.
  4. Prüfen Sie die angeforderte Berechtigung — Termine in Ihren Kalendern ansehen und bearbeiten — und klicken Sie auf Zulassen.
  5. Sie kehren zu HANC zurück und die Integrationskarte zeigt Verbunden mit der verwendeten E-Mail-Adresse.

Angeforderter Scope​

HANC fordert einen einzigen OAuth-Scope an: https://www.googleapis.com/auth/calendar.events.

Das ist ein Sensitive-Scope (kein Restricted), was bedeutet:

  • HANC kann Events lesen und anlegen, aber nicht Ihre vollständige Kalenderliste, Freigabe-Einstellungen oder andere Google-Dienste lesen (kein Gmail, kein Drive, keine Kontakte).
  • Google verlangt für diesen Scope kein Security Assessment und keine jährliche Re-Verifizierung.

Kontoweit, nicht pro Agent​

Die Verbindung liegt auf Konto-Ebene in HANC. Tokens werden einmal in einem gemeinsamen Speicher abgelegt und stehen jedem Sprachagenten Ihres Kontos zur Verfügung. Sie autorisieren einmal und aktivieren das Kalender-Tool dann auf beliebig vielen Agenten.

Das unterscheidet sich von agentenspezifischen Einstellungen wie Prompt, Knowledge Base oder Stimme — die werden je Agent separat konfiguriert.

Tool-Konfiguration pro Agent​

Die Verbindung von Google mit Ihrem HANC-Konto macht das Tool verfügbar. Um es tatsächlich zu nutzen, fügen Sie das Google Calendar-Tool im Tab Actions des Agenten hinzu und konfigurieren es.

EinstellungWas sie bewirkt
KalenderWelcher verbundene Kalender vom Agenten gelesen und beschrieben wird
ZeitzoneDie Zeitzone, in der jeder vom Agenten genannte Slot ausgesprochen wird (siehe unten)
ArbeitszeitenTage und Zeiträume, die der Agent anbietet (z. B. Mo–Fr, 09:00–18:00)
Slot-DauerStandard-Termindauer (z. B. 30 Minuten)
PufferPuffer zwischen aufeinanderfolgenden Terminen (z. B. 15 Minuten)

Jeder Agent in Ihrem Konto kann diese Werte unabhängig setzen — praktisch, wenn ein Agent 30-minütige Sales-Demos und ein anderer 90-minütige Beratungen aus demselben Kalender bucht.

Vollständige Einrichtungsanleitung inklusive Outlook-Pendant: Integrationen → Google Calendar.

Umgang mit Zeitzonen​

Alle Slot-Vorschläge, Bestätigungen und angelegten Events nutzen die auf dem Kalender-Tool des Agenten konfigurierte Zeitzone (z. B. Europe/Vienna, Europe/Berlin, America/New_York). Der Agent nennt die Zeitzone laut, wenn er einen Slot anbietet — zum Beispiel „Dienstag um fünfzehn Uhr Wiener Zeit, passt das?" — damit der Anrufer nicht rätseln muss.

Befindet sich Ihr Anrufer in einer anderen Zeitzone, konfigurieren Sie den Agenten so, dass er die lokale Entsprechung vor der Buchung verbal bestätigt. Der angelegte Google-Calendar-Event speichert die Zeit immer in der konfigurierten Zeitzone; Google übernimmt die Anzeige in der jeweiligen Lokalzeit jedes Teilnehmers.

Trennen und erneut verbinden​

Sie können Google Calendar jederzeit auf der Seite Integrationen trennen.

Wenn Sie trennen:

  • Gespeicherte Tokens werden entfernt.
  • Jedes Google-Calendar-Tool auf jedem Agenten Ihres Kontos wird deaktiviert — das Tool bleibt auf den Agenten stehen, wird in Anrufen aber nicht mehr ausgelöst.
  • Bereits gebuchte Events in Google selbst werden nicht gelöscht oder verändert.

Wenn Sie erneut verbinden (oder ein anderes Google-Konto verbinden), reaktivieren sich die zuvor deaktivierten Tools automatisch mit ihren alten Arbeitszeiten, Slot-Dauern und Zeitzonen — Sie müssen das Tool nicht erneut auf jedem Agenten hinzufügen.

Sie können den HANC-Zugriff auch direkt in den Sicherheitseinstellungen Ihres Google-Kontos widerrufen. Der Effekt ist derselbe wie das Trennen aus HANC heraus; der nächste Anruf, der den Kalender nutzen möchte, schlägt sauber fehl und die Tools werden bei der nächsten Synchronisierung deaktiviert.

Gebuchte Termine in HANC​

Jedes vom Agenten angelegte Event erscheint zusätzlich in CRM → Kalender, neben allen Outlook-Buchungen, mit einem Link zurück zum Kontaktdatensatz des Anrufers. Siehe CRM → Kalender für die vereinheitlichte Ansicht.

Verwandt​