Google Calendar

Verfügbarkeit der Integration#

Google Calendar ist noch nicht allgemein verfügbar. Solange die Integration nicht aktiviert ist, zeigt Agent → Aktionen → Google Calendar „Demnächst verfügbar“ an, und die Verbindung ist nicht möglich. Eine Agent-Einstellung kann sie nicht aktivieren. Cal.com bleibt als separate Option verfügbar.

Kalender verbinden#

Sobald die Integration aktiviert ist, öffnen Sie den Bereich „Google Calendar“ und wählen Verbinden. Melden Sie sich bei Google an und prüfen Sie die angeforderten Berechtigungen für Kalenderereignisse und Frei/Besetzt-Verfügbarkeit. Diese Verbindung ist unabhängig von der Anmeldung bei Make Agent Fast. Der Server speichert das Refresh-Token verschlüsselt; weder das Dashboard noch der Agent erhalten es.

Angefordert werden die Scopes calendar.events, calendar.freebusy sowie die nicht sensiblen Scopes openid und email. Der Callback setzt eine verifizierte E-Mail-Adresse voraus und speichert sie verschlüsselt, damit primary derselben Kalender-ID zugeordnet werden kann wie die ausdrücklich angegebene E-Mail-Adresse. Es wird kein Profil-Scope angefordert. Ältere Verbindungen ohne verifizierte E-Mail-Adresse müssen vor einer Buchung getrennt und neu verbunden werden.

Ein Agent nutzt jeweils nur einen Kalenderanbieter. Trennen Sie einen bestehenden Anbieter, bevor Sie wechseln. Wählen Sie die Kalender-ID (primary für den Hauptkalender des verbundenen Kontos) und die zugehörige IANA-Zeitzone, zum Beispiel Asia/Seoul. Auf einen freigegebenen Kalender muss mit den Berechtigungen des verbundenen Kontos zugegriffen werden können. Beim Trennen wird die Google-Freigabe widerrufen und die Verbindung entfernt; bestehende Termine werden dabei nicht storniert.

Arbeitszeiten festlegen#

Neue Verbindungen haben keine Arbeitszeiten, daher werden keine Zeitfenster angeboten, bis Sie welche hinzufügen. Fügen Sie für jeden Arbeitstag Öffnungs- und Schließzeiten hinzu. Ein Tag ohne Eintrag gilt als geschlossen; mehrere sich nicht überschneidende Zeitfenster ermöglichen eine Mittagspause. Die Zeiten werden in der ausgewählten Zeitzone interpretiert. Die Einstellungen werden automatisch gespeichert.

Die Verfügbarkeit ergibt sich aus den Arbeitszeiten abzüglich der belegten Zeiten des ausgewählten Kalenders, des Puffers, der Mindestvorlaufzeit und des Buchungszeitraums. Legen Sie die Zeiten in der für den Kalender vorgesehenen Zeitzone fest und prüfen Sie bei Bedarf die Umstellung zwischen Sommer- und Winterzeit. Wenn keine Zeitfenster angezeigt werden, liegt das eher an geschlossenen Zeiten oder belegten Terminen als an einem Verbindungsfehler.

Von der Verfügbarkeit zur Buchung#

Der Agent nutzt denselben Ablauf mit find_slots und book_slot wie bei Cal.com: Er bietet bis zu acht verfügbare Zeiten an, erfasst Name und E-Mail-Adresse sowie optional eine Anmerkung, prüft das gewählte Zeitfenster erneut und zeigt anschließend eine Bestätigungskarte an. Angebote und Vorschläge verfallen nach 15 Minuten; keines von beiden reserviert das Zeitfenster. Nur der Tipp des Kunden auf die Schaltfläche autorisiert die Buchung. Ein gesprochenes „Ja“ während eines Live-Anrufs kann sie nicht auslösen.

Nach der Bestätigung erhält Google ein Ereignis mit einer deterministischen ID, die an die Ausführung der Aktion gebunden ist, und versendet Einladungen an die Teilnehmer. Ein validiertes, bestätigtes Ereignis erzeugt einen abgeschlossenen Beleg; vorläufige Ereignisse bleiben ausstehend. Ist ein Zeitfenster bereits vergeben, fragen Sie neue Zeiten ab und lassen Sie erneut bestätigen. Bei einem unklaren Netzwerkergebnis erfolgt eine Prüfung anhand derselben Ereignis-ID; werten Sie ein Timeout nicht als Erfolg und legen Sie nicht blind eine weitere Buchung an. Konfigurationsänderungen machen ältere Angebote und Vorschläge ungültig.

Um benachrichtigt zu werden, wenn ein Termin frei wird, nutzen Sie eine Beobachtung mit Einwilligung. Prüfen Sie vor dem Einsatz mit Kunden eine echte Buchung und Einladung in Google, testen Sie ein bereits vergebenes Zeitfenster und kontrollieren Sie das Trennen und erneute Verbinden sowie den vorgesehenen Messaging-Channel.