Skip to main content

​
Überblick

Mit dem Google Calendar Toolset können Agenten Termine ansehen, erstellen, ändern und löschen, Kalender auflisten und Google Meet Links anlegen. Ein Kalender-Konnektor dient dagegen dazu, Ereignisse für die Suche zu importieren. Novaplan übernimmt den Großteil der Einrichtung. Die Schritte bleiben als Referenz für Administratoren verfügbar.

​
Einrichtung

  1. Öffnen Sie die Google Cloud Console und wählen oder erstellen Sie ein Projekt.
  2. Aktivieren Sie unter APIs & Services → Library die Google Calendar API.
Google Calendar API aktivieren
  1. Konfigurieren Sie unter APIs & Services → OAuth consent screen die Einwilligungsseite.
  2. Öffnen Sie in Novaplan AI Workspace Settings → Actions → Calendar → + Setup oder Configure und kopieren Sie die angezeigte Redirect URI.
Redirect URI für das Google Calendar Toolset kopieren
  1. Erstellen Sie unter APIs & Services → Credentials eine OAuth client ID vom Typ Web application. Tragen Sie die kopierte Adresse unter Authorized redirect URI ein und kopieren Sie anschließend Client ID und Client Secret.
Übernehmen Sie die Redirect URI exakt aus Ihrem Workspace. Eine abweichende Adresse verhindert die Authentifizierung.
  1. Prüfen Sie auf der OAuth-Einwilligungsseite die von der zugänglichen Toolset-Implementierung angeforderten Berechtigungen:
Die zugänglichen Calendar-Tools versenden Einladungen über die Calendar API mit der Option sendUpdates; sie rufen die Gmail API nicht auf. Google nennt für das Erstellen und Aktualisieren von Terminen Calendar-Scopes, nicht gmail.send. Die zugängliche Implementierung fordert gmail.send dennoch an. Lassen Sie Novaplan vor der Freigabe prüfen, ob das bereitgestellte Enterprise-Toolset diese zusätzliche Berechtigung benötigt oder die Anfrage entfernen kann.
  1. Tragen Sie Client ID und Client Secret in Novaplan AI ein und wählen Sie Authenticate.
OAuth-Zugangsdaten für Google Calendar eintragen
  1. Melden Sie sich im Google-Fenster an und bestätigen Sie die angeforderten Rechte mit Allow. Anschließend sollte das Toolset den Status Authenticated anzeigen.
Google-Einwilligungsseite für den Kalenderzugriff

​
Konnektor oder Toolset?

Nennen Sie einem entsprechend berechtigten Agenten Titel, Datum, Uhrzeit und Teilnehmende, wenn er einen Termin anlegen soll. Für Änderungen geben Sie an, welcher Termin gemeint ist und was sich ändern soll. Zum Verschieben eines Termins benötigt der Agent sowohl die neue Start- als auch die Endzeit. Fehlt eine davon, bleibt der Termin unverändert und der Agent fragt nach beiden. Geben Sie bei wichtigen Uhrzeiten die Zeitzone an, etwa „10:00 Europe/Berlin“. Ohne Zeitversatz gilt die zum Termin übermittelte Zeitzone, andernfalls UTC. Ungültige Zeitzonen und eine Endzeit vor der Startzeit werden abgelehnt. Ein ganztägiger Termin umfasst den gewünschten Kalendertag in seiner Zeitzone. Bei Fehlern meldet der Agent beispielsweise eine Begrenzung durch Google, eine abgelaufene Anmeldung oder fehlende Rechte. Wurde der Termin angelegt, aber der Besprechungslink konnte nicht mehr gelesen werden, wird die erfolgte Erstellung gemeldet, damit keine zweite Einladung versendet wird.