Google Calendar-Integration¶
WFM kann geplante Schichten und Pausen mit Google Calendar synchronisieren. Die Synchronisierung wird manuell über die Schaltfläche „Google Sync" im Schichtplan ausgelöst. Die Ereignisse werden in einem Google-Kalender erstellt, der dem Arbeitsplatz zugewiesen ist.
Voraussetzungen¶
Google Cloud Console¶
- Dienstkonto – In der Google Cloud Console mit aktivierter domänenweiter Delegierung (Domain-wide Delegation) erstellt.
- OAuth-Scopes – In der Google Workspace Admin-Konsole konfiguriert:
https://www.googleapis.com/auth/calendarhttps://www.googleapis.com/auth/calendar.events
WFM-Einstellungen¶
Konfigurieren Sie die Google-Integration unter Einstellungen > Integrierte Anwendungen > Google:
| Feld | Beschreibung | Wo zu finden |
|---|---|---|
| Client ID | Client-ID des Dienstkontos | Google Cloud Console > IAM > Dienstkonten |
| Client Email | E-Mail-Adresse des Dienstkontos | JSON-SchlĂĽsseldatei (Feld client_email) |
| Signing Key | Privater Schlüssel | JSON-Schlüsseldatei (Feld private_key), fügen Sie den vollständigen Schlüssel inklusive -----BEGIN/END PRIVATE KEY----- ein |
| Subject | E-Mail-Adresse des Google-Workspace-Benutzers | E-Mail des Benutzers, in dessen Namen das Dienstkonto handelt (z. B. admin@company.com) |
Arbeitsplatzeinstellungen¶
Konfigurieren Sie jeden Arbeitsplatz im Tab Google des Arbeitsplatzformulars:
| Feld | Typ | Beschreibung |
|---|---|---|
| Google Kalender-ID | Dropdown | Kalender, in den die Ereignisse geschrieben werden. „Primärer Kalender" = Hauptkalender des Subjects. Es werden nur Kalender mit Schreibzugriff angezeigt. |
| Zeitpläne synchronisieren | Umschalter | Synchronisierung von Schichten aktivieren |
| Pausen synchronisieren | Umschalter | Synchronisierung von Pausen aktivieren |
| Teilnehmernamen im Titel anzeigen | Umschalter | Mitarbeiternamen im Ereignistitel anzeigen (z. B. „Frühschicht (John Doe, Jane Smith)") |
Domänenweite Delegierung einrichten¶
Die domänenweite Delegierung ermöglicht es dem Dienstkonto, im Namen von Benutzern in Ihrem Google Workspace zu handeln.
- Gehen Sie zu Google Cloud Console > IAM & Verwaltung > Dienstkonten.
- Wählen Sie das Dienstkonto aus und gehen Sie zu Erweiterte Einstellungen > Domänenweite Delegierung.
- Gehen Sie zur Google Workspace Admin-Konsole (admin.google.com) > Sicherheit > API-Steuerung > Domänenweite Delegierung.
- Klicken Sie auf Neu hinzufĂĽgen und geben Sie Folgendes ein:
- Client-ID des Dienstkontos
- Scopes:
https://www.googleapis.com/auth/calendar,https://www.googleapis.com/auth/calendar.events
- Warten Sie einige Minuten, bis sich die Änderungen verbreitet haben.
Schichtpläne synchronisieren¶
So synchronisieren Sie¶
- Ă–ffnen Sie den Schichtplan.
- Klicken Sie in der oberen Leiste auf Google Sync.
- Warten Sie, bis die Synchronisierung abgeschlossen ist.
Was synchronisiert wird¶
Schichten:
- Alle Schichten aus dem Schichtplan (nicht nur Notfallschichten)
- Bedingungen:
- Für den Arbeitsplatz ist Zeitpläne synchronisieren aktiviert.
- Der Schicht sind Mitarbeiter (Teilnehmer) zugewiesen.
- Jedes Ereignis enthält:
- Titel: Name der Schicht (optional mit Teilnehmernamen)
- Teilnehmer: E-Mails aller zugewiesenen Mitarbeiter
- Zeit: Beginn und Ende der Schicht
Pausen:
- Bedingungen:
- FĂĽr den Arbeitsplatz ist Pausen synchronisieren aktiviert.
- Wenn Pausensynchronisation auswählen aktiviert ist: nur ausgewählte Pausen (Whitelist)
- Jedes Ereignis enthält einen Teilnehmer (den Mitarbeiter in der Pause)
Benachrichtigungen¶
Ereignisse werden mit sendUpdates: 'all' erstellt – alle Teilnehmer erhalten eine E-Mail-Benachrichtigung von Google Calendar. Beachten Sie vor der ersten Synchronisierung, dass alle zugewiesenen Mitarbeiter E-Mails erhalten.
Hinweise¶
- Die Synchronisierung ist manuell – klicken Sie jedes Mal auf die Schaltfläche, wenn Sie synchronisieren möchten.
- Ereignisse werden aktualisiert, wenn sie bereits existieren (abgeglichen ĂĽber die interne Ereignis-ID).
- Gelöschte oder verwaiste Ereignisse (ohne Teilnehmer) werden aus Google Calendar entfernt.
- Die Authentifizierung wird ĂĽber Cookies auf derselben Domain geteilt.
- Das Kalender-Dropdown zeigt nur Kalender an, auf die der Subject-Benutzer Schreibzugriff hat.