iCal feed

Az iCal egy szabványos naptár-feed-formátum. Apple Calendar, Outlook, és bármi naptár-app képes olvasni. A Bookinda generál egy URL-t, te azt hozzáadod a naptár-app-hoz.

Hol találod

/manager/connect/calendar → + iCal feed gomb.

Csatlakozás

Lépések

+ iCal feed gomb
Privacy szint kiválasztása (FULL / LIMITED / BUSY_ONLY)
Generate URL → kapsz egy egyedi URL-t

A URL formátum: https://api.bookinda.hu/ical/{token}.ics

A token egy hosszú véletlen string, csak rólad-szól (= autentikáció URL-szinten).

Apple Calendar-ban hozzáadás

Apple Calendar megnyitás (macOS vagy iPhone)
File → New Calendar Subscription (macOS) vagy Settings → Calendar → Add Account → Other → iCal Subscription (iPhone)
Beillesztés a Bookinda URL
Sync gyakoriság: 5 perc / 15 perc / óra / nap (Apple-en állítható)
OK / Subscribe

A Bookinda foglalások megjelennek a megosztott naptáron.

Outlook-ban hozzáadás

Outlook → Calendar → Add Calendar → From Internet
URL beillesztés
OK → import

(Az Outlook-szinkron általában lassabb, 1-3 óra között).

Read-only sync

Csak Bookinda → külső irány:

Új foglalás → megjelenik az Apple-ben (a következő pull-on)
Módosítás → update
Lemondás → cancelled status

Apple → Bookinda NEM működik iCal-en. Ehhez Google Calendar kell.

Sync gyakoriság

Az iCal-feed-et az olvasó-app pull-ozza (nem a Bookinda push-ozza).

Apple Calendar: 5-60 perc (default 15 perc)
Outlook: 1-3 óra
Google Calendar (ha iCal-feed-ként importálod): 6-12 óra

A pull-frequency az olvasó-app sajátja.

Token-újrageneration

Ha a URL kompromittálódott (megosztottad valakinek):

Calendar-sync oldal → Token regenerate
Új URL generálódik
A régi URL érvénytelen (érvénytelenítve)
Az olvasó-app nem fog többet adatot kapni
Új URL hozzáadása az olvasó-app-ban

Privacy levelek

Csakúgy mint Google-nál:

FULL_DETAILS: vendég-név + szolgáltatás
LIMITED: csak szolgáltatás-név
BUSY_ONLY: csak "Foglalt"

A medical-szabású salon BUSY_ONLY-t használ a personal sync-hez (vendég-név külső naptárban privacy-rizikó).

Korlátok

Nincs 2-irányú sync

Az iCal csak read-only. Az Apple-ben létrehozott personal event-ek nem szinkronizálódnak vissza Bookinda busy-blockként. Ehhez Google kell.

Pull-késleltetés

Az új foglalás 5-60 percen belül jelenik meg az Apple-en. Real-time elvárásra Google-t használj.

Per-staff vs per-tenant

Az iCal feed lehet:

Personal (per-staff): csak az ő foglalásai
Salon (per-tenant): minden foglalás

Mikor használd

Szcenárió 1, Apple Calendar user, csak read-only kell A staff Apple Calendar-t használ a személyes naptár-jához. Bookinda iCal feed-et hozzáad. Foglalások megjelennek. Apple-event-ek NEM blokkolják a Bookindát (de read-only OK).

Szcenárió 2, multi-app sync A staff Apple-t + Google-t is használ. Apple-be iCal feed (read-only). Google-ba OAuth (2-way). Mindkettő működik.

Szcenárió 3, csapat-tag csak látni akarja a foglalásait Reception-staff csak látni akarja a salon-foglalásokat a saját Apple-én. Per-tenant iCal feed. Read-only.

Szcenárió 4, biztonsági incident A staff véletlenül megosztotta az iCal URL-t. Token regenerate. Új URL, régi inaktív.

Tippek

Az iCal feed read-only, ezért NEM helyettesíti a Google-sync-et 2-irányú esetén.
Az Apple-pull-frequency 15 perc default, állítsd 5 percre, ha sok új foglalás.
A token-URL-t bizalmasan kezeld, ne küldd el sehova publikusan.
A privacy-szint BUSY_ONLY az iCal-en a legbiztonságosabb, mert az Apple-ben mások is láthatják a megosztott naptárt.
A Google Calendar mint olvasó az iCal-feed-en lassú (6+ óra), nem ajánlott. Inkább OAuth-tal csatold.
A token regenerate vissza-csatolást igényel minden olvasó-app-on, ne csináld feleslegesen.

iCal feed (Apple Calendar)