Integrace Google Calendar¶

WFM může synchronizovat naplánované směny a přestávky do Google Calendar. Synchronizace se spouští ručně akcí Google synchronizace v pravém panelu rozvrhu. 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¶

Přejděte do Nastavení > Integrace > Aplikace.
Klikněte na Nová aplikace a zvolte typ Google.

Vyplňte:

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

Klikněte na Uložit.

Každý typ aplikace lze přidat jen jednou. Když aplikace Google existuje, typ se v Nová aplikace už nenabízí - upravte tu stávající.

Nastavení pracoviště¶

Po uložení aplikace Google dostane formulář pracoviště záložku Google. 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 názvu	Přepínač	Zobrazit jména zaměstnanců v titulku události (např. "Ranní směna (Jan Novák, Jana Svobodová)")
Zobrazit dovednosti účastníků v názvu	Přepínač	Za jméno každého zaměstnance přidá jeho dovednosti, např. "Jan Novák [ Podpora, Prodej ]". Dostupné, jen když je zapnuté Zobrazit jména účastníků v názvu.

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 synchronizace v pravém panelu.
Počkejte na dokončení synchronizace.

Google synchronizace se zobrazuje, jen když je aplikace Google nastavená, a na uzavřeném plánu směn je neaktivní.

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
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.