Naptár-integráció

Csatlakozz egyszer, kezelj mindenhonnan. Miután csatlakoztattad a Google Calendart vagy a Microsoft Outlookot (Teams), a Voilà óráid pontosan úgy jelennek meg a naptáradon, mint bármely más megbeszélés — és bármi, amit az eseménnyel a naptáradból csinálsz, automatikusan visszakerül a Voilàba. Ütemezz át, szakíts meg, fogadj el vagy utasíts el — mindkét oldal másodperceken belül szinkronban marad.

Ez az oldal oktatók számára íródott. A „Mit tapasztalnak a tanulóid" rész pontosan elmagyarázza, mit látnak a tanulóid a saját végükön, így magabiztosan kezelheted az egész ütemezésed a naptáradból.

Támogatott szolgáltatók

Szolgáltató	Videó link automatikusan csatolva	Mit hoznak létre
Google Calendar	Google Meet	Egy esemény óránként, fő esemény ismétlődő sorozatonként
Microsoft Outlook / Teams	Microsoft Teams	Egy esemény óránként, egy esemény ismétlődő előfordulásként

Egyszerre csak egy naptárszolgáltatót csatlakoztathatsz. A váltáshoz először bontsd meg az aktuálisat a Beállítások → Integrációk alatt.

Google Calendar csatlakoztatása

1. Lépj a Beállítások → Integrációk vagy az Ütemezés → Google Calendar csatlakoztatása menüpontba.
2. Kattints a Google Calendar csatlakoztatása gombra.
3. Jelentkezz be a Google-fiókodba és engedélyezd a Voilànak az események olvasását és írását.
4. A naptárad azonnal szinkronizálni kezd.

Mi történik a csatlakoztatás pillanatában: minden megerősített jövőbeli Voilà óra feltöltődik a Google Calendarra — mindegyik Google Meet linkkel, előre kitöltött résztvevőkkel és egy „Voilàban foglalva" szövegtörzssel. Nincs semmi más teendő.

Microsoft Outlook / Teams csatlakoztatása

1. Lépj a Beállítások → Integrációk vagy az Ütemezés → Outlook naptár csatlakoztatása menüpontba.
2. Kattints az Outlook naptár csatlakoztatása gombra.
3. Jelentkezz be a Microsoft-fiókodba és engedélyezd a Voilànak az események olvasását és írását.
4. A naptárad azonnal szinkronizálni kezd.

Minden óra Teams-megbeszélésként jelenik meg az Outlook-naptáradon (a csatlakozási link automatikusan csatolva van), a tanulóval a résztvevők között. Ugyanez a visszatöltési viselkedés érvényes: a jövőbeli Voilà órák azonnal megjelennek az Outlook-naptáradon.

Mi jelenik meg a naptáradon (Voilà → naptár)

Voilà esemény	Mit látsz a naptáron
Egy 1:1 foglalás megerősítésre kerül	Egy meghívó az óra időpontjában, a Meet/Teams linkkel, a tanulóval a résztvevők között, és egy Voilà által szerzett szövegtörzssel.
Egy csoportóra megerősítésre kerül	Ugyanez az esemény, minden elfogadott taggal a résztvevők listáján. Ahogy több tag fogad el, hozzáadódnak; ha egy tag kilép, eltávolítódnak.
Egy ismétlődő óra létrehozásra kerül	Google: egy fő ismétlődő esemény a teljes sorozatra. Outlook: egy esemény előfordulásként (így az egyes előfordulások frissítései tisztán átfolynak a Microsoft Graphon).
Egy átütemezés elfogadásra kerül a Voilàban	A meghívó kezdési/befejezési ideje frissül, és a résztvevők frissítési értesítést kapnak. Mindkét Google és Outlook esetén működik.
Egy óra lemondásra kerül a Voilàban	A naptáresemény eltávolítódik és a résztvevők lemondási értesítést kapnak. Mindkét Google és Outlook esetén működik.
Egy ismétlődő előfordulás kihagyásra kerül a Voilàban	Csak az egyik előfordulás törlődik — a sorozat többi része érintetlen marad.

Mi szinkronizálódik vissza a Voilàba (naptár → Voilà)

Ez az a rész, amely lehetővé teszi, hogy „a naptáradban élj". Az alábbiak bármelyike automatikusan megváltoztatja a Voilà állapotát.

Áthelyezed az esemény időpontját

Egy Voilà esemény húzása egy másik időpontra, vagy a kezdési/befejezési idejének szerkesztése egy átütemezési javaslatot nyit meg a Voilàban. Miután a tanuló megerősíti (az alkalmazásban vagy az e-mailre válaszolva), az esemény időpontja mindkét rendszerben zárolódik. Addig az esemény függőben lévő javaslatként marad — a tanuló továbbra is láthatja és elfogadhatja/elutasíthatja azt a Voilàban.

Törlöd vagy lemondod az eseményt

A Voilà lemondottnak jelöli az órát és futtatja a lemondási szabályzat oktatói lemondási ágát:

• A tanuló teljes visszatérítést kap (ha Stripe) vagy a munkamenet-kreditje visszakerül (ha munkamenet-csomag), függetlenül attól, hogy a lemondás a határidő előtt vagy után történt-e. Az oktatóhoz kapcsolódó lemondások mindig helyreállítják a tanulót.
• Csoportórák esetén minden fizetett hely visszatérítésre kerül.
• A tanuló lemondási e-mailt és csevegés-kártya frissítést kap.

Egy új eseményt hozol létre az egyik tanulóddal résztvevőként

Ha aktív tanuló–oktató kapcsolat van közötted, a Voilà:

• Automatikusan létrehoz egy foglalási javaslatot az órához.
• E-mailt küld a tanulónak, hogy megerősíthesse az időpontot.
• Tartja a helyet az elérhetőségedben, amíg a javaslat függőben van.

Ha a résztvevő nem ismert tanulód, a Voilà az eseményt az elérhetőségedben egy szokásos foglalt időként rögzíti — de nem hoz létre foglalást.

Bármilyen más eseményt adsz hozzá a naptáradhoz

Bármilyen eseményt, amit hozzáadsz — munkaértekezletek, fogorvosi időpontok, ebéd egy baráttal — foglalt időként kezelik és blokkolják az új tanulói foglalásokat az adott időablakban. Nem kell semmit csinálnod; ez automatikus.

Mit tapasztalnak a tanulóid

Amikor egy óra megerősítésre kerül, a tanulód meghívót kap ugyanahhoz az eseményhez — a Meet vagy Teams csatlakozási linkkel benne. Így ő is kezelheti az órát a saját naptárjából. Íme pontosan, hogyan reagál a Voilà arra, amit a tanuló a beérkezett üzeneteiből vagy a naptáralkalmazásból csinálhat:

Tanuló művelete	Mit csinál a Voilà
Elfogadja a meghívót	Semmi extra — már az órán vannak. Az RSVP-jük rögzítésre kerül a láthatóság érdekében.
Elutasít egy függőben lévő javaslatot a naptárjából	A javaslat elutasítódik a Voilàban. E-mailben és csevegésben értesítésre kerülsz.
Elutasít egy megerősített 1:1 órát a naptárjából	A Voilà futtatja a lemondási szabályzat tanulói lemondási ágát. A határidő előtt = teljes visszatérítés vagy kredit visszaadása; a határidő után = elvesztés (te megtartod a fizetést).
Elutasít egy megerősített csoportóráról	Csak az adott tanuló helye kerül visszatérítésre; az óra folytatódik mindenki másnak (a minimális helyek szabályának függvényében).
Elutasít egy ismétlődő előfordulást	Az adott előfordulás kihagyódik (visszatérítés vagy elvesztés a lemondási szabályzat szerint). A sorozat többi része érintetlen marad.
Továbbítja a meghívót egy másik postafiókba	Nincs hatása az órára — a Voilà az igazság forrása, és a meghívó továbbítása nem helyezi át az órát vagy nem adja ki újra a visszatérítéseket.

Röviden: a tanulók teljes mértékben kezelhetik a részvételüket a naptári meghívóból, és minden műveletet másodperceken belül látni fogsz a Voilà oldalon.

Csoportórák a naptáron keresztül

A csoportórák egy extra csavart adnak — a minimális helyek szabálya:

• Egy tag elutasít → az adott hely visszatérítésre kerül, a résztvevő eltávolítódik a naptáreseményből, az óra folytatódik.
• Az elutasítás a lemondasási határidő ELŐTT az órát a min_seats alá csökkenti → az egész óra lemondódik, minden fizetett hely visszatérítésre kerül, a naptáresemény eltávolítódik.
• Az elutasítás a lemondási határidő UTÁN az órát a min_seats alá csökkenti → az óra marad (akik megtartották a helyüket, már fizettek az időpontért), és e-mailt kapsz, hogy eldönthesd, hogyan kezeld.

Ismétlődő órák a naptáron keresztül

Az ismétlődő órákat mindegyik szolgáltató másképp tárolja, de a tapasztalat ugyanaz:

• Google: a sorozat egy fő ismétlődő esemény. Egy előfordulás elutasítása a naptárból csak azt az előfordulást hagyja ki a Voilàban; a fő esemény elutasítása minden jövőbeli előfordulást töröl.
• Outlook: minden előfordulás egyénileg kapcsolódik, így a Microsoft Graphból származó előfordulás-szintű frissítések tisztán átfolynak. Egy előfordulás elutasítása kihagyja azt a Voilàban; a sorozat elutasítása befejezi a jövőbeli előfordulásokat.
• Egy előfordulás kihagyása a Voilàban belülről automatikusan törli a megfelelő naptáreseményt egy tiszta lemondási értesítéssel a résztvevőknek.
• Az oktató lemondási szabályzatának módosítása nem alkalmazódik visszamenőlegesen az már létező előfordulásokra — minden előfordulás zárolódik az abban az időpontban aktív szabályzattal, amikor létrehozták.

Hogyan működik a szinkronizálás

A Voilà leküldéses értesítéseket (webhookokat) használ elsődleges triggerként:

• Google Calendar — a Voilà a Google events.watch csatornáján keresztül feliratkozik a naptáradra; a frissítések másodperceken belül érkeznek, miután mentesz a Google Calendarra.
• Microsoft Outlook / Teams — a Voilà Microsoft Graph webhookokon keresztül iratkozik fel; ugyanez a viselkedés.

Néhány biztonsági háló tartja az csatornát egészségesnek:

• Óránkénti karbantartási feladat megújítja az előfizetéseket, mielőtt lejárnának, és indítja az esetlegesen hiányzó figyeléseket.
• Visszatöltés csatlakoztatáskor feltölti a meglévő jövőbeli Voilà órákat az új naptárra (és visszaimportálja a meglévő naptári foglalt időket).
• Kézi frissítés elérhető az Ütemezés oldalról — hasznos, ha tesztelsz vagy ha egy webhook röviden lemaradt a szállításról.

Az oldal korábbi verziói egy „5 perces lekérdezési ciklust" említettek. Ez már nem pontos — a szinkronizálás leküldés-alapú és általában 30 másodpercnél gyorsabban érkezik.

Lemondási szabályzat és visszatérítések a naptáron keresztül

A naptár oldaláról történő lemondások pontosan ugyanazt a lemondási szabályzatot követik, amelyet a Stripe-pal fizetett foglalásokhoz konfigurálsz (lásd Stripe Connect Payments):

• Te mondasz le (törlés/lemondás a naptárból): a tanuló teljes visszatérítést kap, függetlenül az időzítéstől.
• A tanuló elutasít a naptárjából a határidő előtt: teljes visszatérítés vagy kredit visszaadása a tanulónak.
• A tanuló elutasít a naptárjából a határidő után: a fizetés elvész (te megtartod) vagy a munkamenet-kredit felhasználódik.
• Csoportórák: helyek szerinti visszatérítések az egyes elutasításokért; minden fizetett hely teljes visszatérítése, ha egy oktatói lemondás vagy egy határidő előtti min_seats alá csökkenés lemondja az órát.

Adatvédelem és hatókör

• A Voilà csak az általad csatlakoztatott naptárra olvas és ír — soha nem más naptárakra a fiókodban.
• A Voilà által olvasott események kizárólag az ütemezéshez és az elérhetőség-számításokhoz használódnak.
• Az elérhetőséget bármikor visszavonhatod a Beállítások → Integrációk alatt (vagy közvetlenül a Google / Microsoft fiók beállításaiból).

Hibaelhárítás

Token lejárt

Ha a szinkronizálás leáll, az OAuth token valószínűleg lejárt. Nyisd meg a Beállítások → Integrációk menüpontot és kattints az Újracsatlakoztatás gombra.

Szinkronizálási késések

A webhookok általában ~30 másodpercen belül szállítanak. Az óránkénti karbantartási feladat egy biztonsági háló, amely megújítja az előfizetéseket és újraszinkronizálja az esetlegesen röviden lemaradt szállítást. Az Ütemezés oldalról kézi frissítést is indíthatsz.

Ütközések nem-Voilà eseményekkel

Ha egy Voilà foglalást próbálsz megerősíteni egy olyan időpontra, amelyet a naptáradon egy nem-Voilà esemény fed le, a Voilà figyelmeztet és lehetővé teszi az ütközés felülbírálását — hasznos, ha a naptáresemény egy „puha" tartás, amelyet szívesen feladsz.

Szolgáltatók váltása

Egyszerre csak egy naptár csatlakoztatható. Bontsd meg a Google-t, mielőtt csatlakoztatnád az Outlookot (vagy fordítva) a Beállítások → Integrációk alatt.

Kétirányú szinkronizálás, végpontól végpontig

sequenceDiagram
    participant Student
    participant StudentCal as "Tanuló naptára"
    participant Voila
    participant TutorCal as "Oktató naptára (Google vagy Outlook)"
    participant Tutor

    Note over Voila,TutorCal: Óra megerősítésre kerül a Voilàban
    Voila->>TutorCal: Esemény létrehozása Meet vagy Teams linkkel
    TutorCal-->>Student: Meghívó szállítva
    TutorCal-->>StudentCal: Meghívó szállítva

    Note over Student,StudentCal: Tanuló elutasít a beérkezett üzenetekből
    StudentCal->>TutorCal: RSVP elutasítva
    TutorCal->>Voila: Webhook aktiválódik
    Voila->>Voila: Lemondási szabályzat futtatása
    Voila-->>Tutor: Alkalmazásbeli és e-mail értesítés
    Voila-->>Student: Visszatérítés vagy elvesztés megerősítése

    Note over Tutor,TutorCal: Oktató lemondja az eseményt
    TutorCal->>Voila: Webhook aktiválódik
    Voila->>Voila: Lemondás és visszatérítés
    Voila->>StudentCal: Naptáresemény eltávolítva

Kapcsolódó

• Ütemezés — heti elérhetőség, foglalási szabályzatok, szabadság mód
• Csoportórák — minimális helyek, tagkezelés, csoportlemondási viselkedés
• Stripe Connect Payments — lemondási szabályzatok és hogyan alkalmazódnak a visszatérítések