Google Calendar setup
OAuth-flow, calendar-választás, real-time push, 15 perces pull
Google Calendar setup
A Google Calendar a leghasználtabb sync-provider. OAuth-flow-val csatlakoztatható, és real-time mindkét irányban dolgozik.
Hol találod
/manager/connect/calendar → + Google Calendar gomb.
Csatlakozás (OAuth-flow)
Lépések
- + Google Calendar gomb
- Új ablak: Google login
- Hozzáférés engedélyezése (Bookinda kér: Calendar.read + Calendar.write)
- Visszairányítás Bookinda-ra
- Calendar kiválasztása: melyik Google-naptárhoz csatlakozz (pl. Primary, Munka, Családi)
- Privacy szint kiválasztása (FULL / LIMITED / BUSY_ONLY)
- Mentés → ACTIVE státusz
Mit kér a Bookinda
- Calendar.read: a naptár-event-ek olvasása (busy-block-pull)
- Calendar.write: új event-ek létrehozása (Bookinda-foglalás-push)
- Offline access: refresh-token (a connection nem szakad meg)
Sync-irányok
Bookinda → Google (real-time push)
Új foglalás létrehozása / módosítás / lemondás:
- Sent within 1-2 másodperc a Google-be
- Event-cím: a privacy-szinttől függ
- Event-leírás: vendég-info, szolgáltatás, ár
- Google-event extended-properties: Bookinda-jelölő
Google → Bookinda (15 perces pull)
- A Bookinda 15-percenként pull-ozza a Google új event-jeit
- Ezekből
ExternalBusyBlock-ot készít - A salon-naptárán "Foglalt" idősávban megjelenik
Manuális pull
- "Pull now" gomb a calendar-sync-oldalon
- Azonnali frissítés (nem várja a 15 perces cron-t)
Multi-calendar
Egy staff csatlakoztathat több Google-naptárat:
- Pl. "Personal" + "Work"
- Mindegyik külön külön ACTIVE
- Mindegyik pull-oz busy-block-ot
Sync-státuszok
ACTIVE
Minden rendben, a sync működik.
PAUSED
Te szüneteltetted (vagy admin). Sync nem fut.
ERROR
Hibás (pl. token lejárt és nem refreshelhető). Üzenet a calendar-sync-oldalon.
PENDING
Csatlakozva, de még nem választottál ki Calendar-t.
Lemondás (disconnect)
A calendar-sync-soron → Disconnect gomb:
- Token-revokáció (Google-nál)
- Bookinda-sync row törlése
- A korábban push-olt Google-event-ek MARADNAK (nem törlődnek)
- A jövőbeli foglalások már nem mennek a Google-be
Ha vissza akarod csatolni, új OAuth-flow.
Token-management
A Google OAuth tokenek:
- Access token: rövid életű (1 óra)
- Refresh token: hosszú életű (örök, kivéve ha visszavonod)
A Bookinda automatikusan refresh-eli az access token-t. Ha a refresh-token érvénytelen (te visszavontad a Google-Settings-ben), a sync ERROR státuszba kerül.
Mikor használd
Szcenárió 1, hairstylist personal sync Anna stylist a saját Google Calendar-jához csatolja a Bookinda-t. A foglalásai megjelennek a "Munka" naptárában. A személyes event-jei (orvosi vizsgálat, családi vacsora) busy-block-ká lesznek a Bookindában.
Szcenárió 2, salon owner overview Owner egy "Salon Overview" Google-naptárat hoz létre. Csatolja minden staff-hoz tenant-szintűen. Egy közös naptárban látja a salon-egészét.
Szcenárió 3, multi-account staff Béla két Google-fiókot használ (személyes + üzleti). Mindkettőt csatolja. Mindkettő külön-külön sync-ol.
Szcenárió 4, hibás sync A sync ERROR státuszban van. Megnézed: token revoked. Reconnect-elsz.
Tippek
- Az OAuth-flow 1-2 percet vesz igénybe, nem több. Ha tovább tart, valami nem stimmel.
- A Calendar-választás kritikus: ne a Primary-t add, ha az nagyon zsúfolt. Külön munka-naptárt csatolj.
- A privacy-szint a vendég-adat-érzékenységet tükrözi, medical-szigorúbb.
- A multi-calendar mértékkel, 2-3 calendar OK, 10+ zavaros.
- A 15 perces pull-cron alapja, hogy a Google-ben létrehozott event 0-15 perc után jelenik meg Bookinda-busy-blockként. Sürgős esetben "Pull now".
- Az ERROR státusz okát mindig nézd meg, ne hagyd ott figyelmen kívül.