Integrace Google Calendar¶

WFM může synchronizovat naplánované směny a přestávky do Google Calendar. Synchronizace se spouští ručně tlačítkem "Google Sync" na plánu směn. Události se vytvářejí v Google Calendar přiřazeném k pracovišti.

Předpoklady¶

Google Cloud Console¶

Service Account - Vytvořený v Google Cloud Console s povoleným Domain-wide Delegation.
OAuth Scopes - Nakonfigurované v Google Workspace Admin Console:
- https://www.googleapis.com/auth/calendar
- https://www.googleapis.com/auth/calendar.events

Nastavení WFM¶

Nakonfigurujte integraci Google v Nastavení > Integrace > Aplikace > Google:

Pole	Popis	Kde získat
Client ID	Client ID service accountu	Google Cloud Console > IAM > Service Accounts
Client Email	Email service accountu	JSON soubor klíče (pole `client_email`)
Signing Key	Privátní klíč	JSON soubor klíče (pole `private_key`), včetně `-----BEGIN/END PRIVATE KEY-----`
Subject	Email Google Workspace uživatele	Email uživatele, za kterého service account vystupuje (např. `admin@firma.com`)

Nastavení pracoviště¶

Nakonfigurujte každé pracoviště v Nastavení > Konfigurace > Pracoviště > otevřít pracoviště > záložka Google:

Pole	Typ	Popis
Google Calendar ID	Dropdown	Kalendář, kam se budou zapisovat události. "Primary Calendar" = hlavní kalendář subjekta. Zobrazují se pouze kalendáře s právem zápisu.
Synchronizovat rozvrhy	Přepínač	Povolit synchronizaci směn
Synchronizovat přestávky	Přepínač	Povolit synchronizaci přestávek
Zobrazit jména účastníků v titulku	Přepínač	Zobrazit jména zaměstnanců v titulku události (např. "Ranní směna (Jan Novák, Jana Svobodová)")

Nastavení Domain-wide Delegation¶

Domain-wide Delegation umožňuje service accountu vystupovat jménem uživatelů ve vašem Google Workspace.

Přejděte do Google Cloud Console > IAM & Admin > Service Accounts.
Vyberte service account a přejděte do Advanced settings > Domain-wide Delegation.
Přejděte do Google Workspace Admin Console (admin.google.com) > Security > API Controls > Domain-wide Delegation.
Klikněte na Add new a zadejte:
- Client ID service accountu
- Scopes: https://www.googleapis.com/auth/calendar,https://www.googleapis.com/auth/calendar.events
Počkejte několik minut na propagaci změn.

Synchronizace rozvrhu¶

Jak synchronizovat¶

Otevřete plán směn.
Klikněte na Google Sync v horní liště.
Počkejte na dokončení synchronizace.

Co se synchronizuje¶

Směny:

Všechny směny z plánu směn (nejen pohotovostní)
Podmínky:
- Pracoviště má povoleno Synchronizovat rozvrhy
- Směna má přiřazené zaměstnance (účastníky)
Každá událost obsahuje:
- Název: Název směny (volitelně se jmény účastníků)
- Účastníci: Emaily všech přiřazených zaměstnanců
- Čas: Začátek a konec směny

Přestávky:

Podmínky:
- Pracoviště má povoleno Synchronizovat přestávky
- Pokud je povoleno Vybrat přestávky k synchronizaci: pouze vybrané přestávky (whitelist)
Každá událost obsahuje jednoho účastníka (zaměstnanec na přestávce)

Notifikace¶

Události se vytvářejí s sendUpdates: 'all' - všichni účastníci přijmou emailovou notifikaci z Google Calendar. Před první synchronizací počítejte s tím, že všichni přiřazení zaměstnanci přijmou emaily.

Poznámky¶

Synchronizace je ruční - klikněte na tlačítko pokaždé, když chcete synchronizovat.
Události se aktualizují, pokud již existují (párování podle interního ID události).
Smazané nebo osiřelé události (bez účastníků) jsou odstraněny z Google Calendar.
Autentizace se sdílí přes cookies na stejné doméně.
Dropdown kalendáře zobrazuje pouze kalendáře, kde má subject uživatel právo zápisu.