Naptár szinkronizáció áttekintés
A 3 provider, 2-irányú sync, busy-block, multi-calendar
Naptár szinkronizáció
A Bookinda foglalásait szinkronizálhatod a személyes naptáraddal (Google Calendar, Apple Calendar, Outlook). Két irányba megy:
- Bookinda → külső naptár: a foglalások a személyes naptáradban is megjelennek
- Külső naptár → Bookinda: a személyes naptáradon foglalt időt a Bookinda blokkolja
Hol találod
/manager/connect/calendar (vagy munkatárs-profilon: Calendar Sync szekció).
A 3 provider
1. Google Calendar
- OAuth 2.0 flow (Bookinda kéri a hozzáférést)
- Real-time push: foglalás létrehozáskor azonnal megjelenik a Google-ben
- 15 perces pull cron: a Google → Bookinda irány óránként frissül
2. iCal feed (Apple Calendar / bármi)
- Token-alapú ICS URL: pl.
https://api.bookinda.hu/ical/{token}.ics - One-way push: a Bookinda foglalások megjelennek
- Apple / Outlook / bármi olvashatja, ha támogat ICS feed-et
3. Outlook / Microsoft 365
- OAuth 2.0 flow (Microsoft Graph), céges és személyes fiókkal is
- Kétirányú: foglalás-push + 15 perces busy-pull (mint a Google-nél)
- Microsoft bejelentkezés nélkül iCal feliratkozás alternatíva is van
- → Részletek: Outlook setup
Per-staff vs per-tenant
Per-staff sync
Egy munkatárs a saját Google-jét csatolja. Csak az ő foglalásai szinkronizálódnak.
- Tipikus: hairstylist a saját naptárában is látja a foglalásait
Per-tenant sync
Owner / Manager csatol egy salon-szintű naptárt. Minden staff foglalása szinkronizálódik egy közös naptárba.
- Tipikus: salon-tulajdonos egy nézetben látja az egész salont
A kettő nem zárja ki egymást: egy staff-nak lehet personal sync + tenant-szintű is.
2-irányú sync
Bookinda → külső (push)
- Új foglalás → push event a külső naptárba
- Módosítás (pl. átütemezés) → update az event-en
- Lemondás → cancelled status az event-en
A Bookinda extended-properties-szel jelöli az event-et "Bookinda-eredetű"-ként, hogy ne pull-ozzuk magunkba (loop-prevention).
Külső → Bookinda (pull, busy-blocks)
- Cron 15-percenként pull-oz
- A külső naptár event-jei
ExternalBusyBlock-ká válnak - A Bookinda-naptáron mint "Foglalt" időablak jelenik meg
- Blokkol: új online foglalás nem foglalható arra az időre
Mit pull-oz
- ✅ Confirmed event-ek
- ❌ Cancelled event-ek (kihagyva)
- ❌ All-day event-ek (kihagyva)
- ❌ Declined event-ek (kihagyva)
- ❌ "Free" (transparent) event-ek (kihagyva)
A 60 napos jövőbeli ablakban dolgozik.
Multi-calendar
Egy staff csatlakoztathat több Google Calendar-t:
- Personal Google (családi naptár)
- Work Google (üzleti naptár)
- Both pull-oznak busy-block-ot Bookinda-ba
Hasznos, ha különböző fiókokon vannak event-jeid.
Mit lát a vendég
A Bookinda online foglalási oldalon a vendég:
- A salon-foglalások blokkolják az időpontokat (default)
- A staff-személyes naptárából a "Busy" időablakok is blokkolják (busy-block)
- A vendég nem látja a staff event-tartalmát, csak a "Foglalt" jelzést
Privacy levelek
Beállítható, mennyi info menjen a külső naptárba:
- FULL_DETAILS: vendég-név + szolgáltatás + jegyzet
- LIMITED: csak szolgáltatás-név
- BUSY_ONLY: csak "Foglalt"
→ Részletek: Privacy levelek
Mikor használd
Szcenárió 1, hairstylist personal sync A staff Google Calendar-ját csatolja. A salon-foglalások személyes naptárában is megjelennek (FULL_DETAILS). A személyes event-jei (orvos, családi) busy-block-ká lesznek a Bookindában.
Szcenárió 2, salon-tulajdonos overview Owner csatol egy salon-szintű Google-t. Minden staff foglalása egy közös naptárba megy. Egy nézetből látja az egészet.
Szcenárió 3, Apple Calendar user Apple Calendar-ban iCal feed URL hozzáadása. Read-only sync (Bookinda → Apple).
Szcenárió 4, multi-calendar A staff Personal + Work Google-t is csatlakoztat. Mindkettőből pull-oz busy-block-ot.
Tippek
- Per-staff sync alapból ajánlott, mert a staff a saját naptárában is láthatja a foglalásait.
- A 15 perces pull-cron nem real-time, az új external event 0-15 percig "elveszhetnek".
- Az iCal feed read-only, csak Bookinda → külső irány. Apple-ben nem írhatsz vissza.
- A multi-calendar tipikusan 2 Google-naptárt jelent, ne csatolj 5-öt (zaj).
- A privacy-szint a salon-érzékenységét tükrözi: medical-spa szigorúbb (BUSY_ONLY), hairstylist lazább (FULL_DETAILS).
- A loop-prevention automatikus, a Bookinda nem pull-ozza magát.