GetMyBot-Wissensdatenbank

Termine und Google Kalender

Lassen Sie einen KI-Agenten Beratungen buchen: Google Kalender verbinden, verfügbare Zeiten festlegen und Buchen, Verschieben oder Absagen erlauben.

Auf dieser Seite

Ein KI-Agent kann freie Termine vorschlagen und Kunden in Google Kalender eintragen, etwa eine halbstündige Beratung an Werktagen. Je nach Berechtigung kann er Termine auch verschieben oder absagen.

Verbinden Sie unter KI → Kalender ein Konto, erstellen Sie eine Terminart und prüfen Sie verfügbare Zeiten. Erlauben Sie dann die passenden Kalenderaktionen in den Agenteneinstellungen. Ein buchbares Zeitfenster heißt in der Oberfläche Slot.

Derzeit wird nur Google Kalender unterstützt. Terminarten, Buchungen und Agentenwerkzeuge verwenden eine gemeinsame Plattformschnittstelle; andere Kalenderanbieter lassen sich noch nicht verbinden.

Konto verbinden

Klicken Sie auf Google Kalender verbinden und erlauben Sie den Zugriff im Google-Fenster. Angefragt werden Kalenderliste, Ereignisse und Belegungsinformationen. Schließen Sie die Verbindung nicht innerhalb von fünf Minuten ab, beginnen Sie erneut.

Technisch schützt ein einmaliger, an Bot und Konto gebundener state-Parameter die Verbindung, zusammen mit PKCE und einer festen Rücksprungadresse. state gilt fünf Minuten.

Der Token zur Zugriffsverlängerung wird verschlüsselt gespeichert und nicht wieder angezeigt. Die Verbindungskarte zeigt nur die Kontobezeichnung und einen von vier Zuständen: Verbunden, Zugriff abgelaufen, Getrennt, Fehler. Bei abgelaufenem Zugriff verbinden Sie das Konto erneut.

Kalender trennen ist gesperrt, solange bei einem aktiven Agenten Kalenderwerkzeuge eingeschaltet sind. Die Oberfläche nennt die betroffenen Agenten. Entfernen Sie zuerst diese Werkzeuge oder pausieren Sie den Agenten.

Terminarten

Eine Terminart legt fest, was der Agent anbietet:

  • Name: Für Sie in Berichten und für Kunden im Kalendereintrag sichtbar.
  • Kalender des verbundenen Kontos. Die gespeicherte Kalender-ID ist verschlüsselt und wird nicht erneut angezeigt; beim Bearbeiten wählen Sie den Kalender neu.
  • Dauer: 5 bis 480 Minuten.
  • Zeitzone: IANA-Name wie Europe/Berlin; sie definiert die folgenden Verfügbarkeitszeiten.
  • Verfügbare Zeiten: 1 bis 28 wöchentliche Intervalle mit Grenzen im Format HH:MM pro Wochentag. Intervalle dürfen sich nicht überschneiden; liegt das Ende vor dem Anfang, verläuft das Intervall über Mitternacht.
  • Mindestvorlauf: 0 bis 1.440 Minuten; frühere Buchungen sind nicht möglich.
  • Buchungshorizont: 1 bis 366 Tage im Voraus.
  • Puffer davor und danach: jeweils 0 bis 1.440 Minuten, die um den Termin frei bleiben.
  • Terminart aktiviert: Nur aktivierte Arten können angeboten und gebucht werden.

Freie Slots anzeigen liefert echte Ergebnisse des verbundenen Kalenders für die nächste Woche, keine Simulation.

Wie ein Slot gewählt wird

Die Verfügbarkeit kombiniert vier Quellen: Wochenzeiten der Terminart, belegte Kalenderintervalle, Pufferzeiten und vorhandene Buchungen dieser Verbindung. Kandidaten werden alle 15 Minuten gebildet. Standardmäßig werden 10, höchstens 20 Slots zurückgegeben.

Zeiten werden in der Zeitzone des Kunden gezeigt und in UTC gespeichert. Eine Sommerzeitumstellung verschiebt somit die vorgeschlagene Ortszeit, nicht den gespeicherten Zeitpunkt.

Die Buchung ist bewusst vorsichtig:

  1. Der gewählte Slot wird unmittelbar vor jeder Buchung erneut geprüft.
  2. Eine wartende Buchung mit Idempotenzschlüssel wird gespeichert; ein wiederholter Aufruf erzeugt keinen zweiten Termin.
  3. Im Kalender wird ein Ereignis erstellt, bei Bedarf mit Videokonferenzlink.
  4. Bei Timeout oder vorübergehendem Fehler von Google Kalender wird die Buchung zuerst über den Idempotenzschlüssel gesucht. Ein unklarer Timeout erzeugt dadurch kein Duplikat.
  5. Erst danach wird die Buchung bestätigt. Ereignis-ID des Anbieters und Besprechungslink werden verschlüsselt gespeichert.

Verschieben und Absagen folgen demselben Muster. Belegt inzwischen jemand anderes den Slot, endet die Aktion mit Fehler statt einer Doppelbuchung.

Buchungsstatus: Wartet, Bestätigt, Verschoben, Abgesagt, Fehler.

Agentenwerkzeuge freigeben

Aktivieren Sie im Agenteneditor unter Erlaubte Werkzeuge die benötigten Kalenderaktionen:

  • Freie Slots anzeigen
  • Termin buchen
  • Termin verschieben
  • Termin absagen

Für jedes aktivierte Kalenderwerkzeug muss mindestens eine aktuelle, aktivierte Terminart gewählt sein. Andernfalls lässt die Bereitschaftsprüfung den Agenten nicht aktivieren. Ein aktiver Agent kann derzeit nur Kalenderwerkzeuge tatsächlich ausführen; andere Werkzeuge starten noch nicht.

Das Modell wählt weder Kalender noch Kunden noch eine beliebige Anfrage. Es kann nur einen Werkzeugaufruf vorschlagen, dessen Argumente einem geschlossenen Schema entsprechen. Bot, Kunde und erlaubte Terminarten stammen aus dem Serverkontext. Der Aufruf hat ein Limit von 15 Sekunden und einen Idempotenzschlüssel aus Turn und Aufrufnummer. Im Journal werden Argumente und Ergebnis ohne Besprechungslinks und Kontaktdaten gespeichert.

Berichte

KI → Analytik zeigt Kalenderaktionen und Buchungsergebnisse neben anderen Agentenkennzahlen. Die Buchungen selbst finden Sie unter KI → Kalender.

Fehler beheben

  • Kalenderwerkzeuge sind aktiv, aber keine Terminart ist aktiviert: Erstellen oder aktivieren Sie vor der Agentenaktivierung eine Terminart.
  • Die Kalenderliste lässt sich nicht laden: Möglicherweise muss das Konto neu verbunden werden. Als vorübergehenden Umweg können Sie die Verbindungs-ID manuell eingeben.
  • Keine freien Slots in der nächsten Woche: Prüfen Sie Wochenzeiten, Mindestvorlauf, Puffer und Belegung des Kalenders.
  • Eine Terminart kann wegen Verwendung nicht gelöscht werden: Kalenderwerkzeuge eines aktiven Agenten verweisen darauf.

Verwandte Themen