Naptár-integráció

Csatlakozzon egyszer, kezeljen mindenhonnan. Miután csatlakoztatja a Google Calendart vagy a Microsoft Outlookot (Teams), a Voilà leckéi pontosan úgy jelennek meg a naptárán, mint bármely más megbeszélés — és bármit is csinál az eseménnyel a naptárából, az automatikusan visszakerül a Voilà-ba. Az átütemezés, lemondás, elfogadás, elutasítás — mindkét oldal másodperceken belül szinkronban marad.

Ez az oldal oktatók számára íródott. A „Mit tapasztalnak a tanulók" rész pontosan elmagyarázza, hogy a tanulók mit látnak a végükön, így magabiztosan irányíthatja az egész ütemezést a naptárából.

Támogatott szolgáltatók

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

Egyszerre csak egy naptárszolgáltatót csatlakoztathat. A váltáshoz először válassza le az aktuálisat a Beállítások → Integrációk menüben.

Google Calendar csatlakoztatása

1. Lépjen a Beállítások → Integrációk vagy az Ütemezés → Google Calendar csatlakoztatása menübe.
2. Kattintson a Google Calendar csatlakoztatása gombra.
3. Jelentkezzen be Google-fiókjával, és engedélyezze a Voilà-nak az események olvasását és írását.
4. A naptár azonnal szinkronizálni kezd.

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

Microsoft Outlook / Teams csatlakoztatása

1. Lépjen a Beállítások → Integrációk vagy az Ütemezés → Outlook naptár csatlakoztatása menübe.
2. Kattintson az Outlook naptár csatlakoztatása gombra.
3. Jelentkezzen be Microsoft-fiókjával, és engedélyezze a Voilà-nak az események olvasását és írását.
4. A naptár azonnal szinkronizálni kezd.

Minden lecke a Outlook naptárán Teams-megbeszélésként jelenik meg (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à leckék azonnal megjelennek az Outlook naptárán.

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

Voilà esemény	Mit látsz a naptárban
Egy 1:1 foglalás megerősítésre kerül	Meghívó a lecke 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 csoportos lecke 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ő lecke 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 a per-instance frissítések tisztán átfolynak a Microsoft Graph-on).
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 lecke lemondásra kerül a Voilà-ban	A naptár eseménye 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árban élj". Az alábbiak bármelyike automatikusan megváltoztatja a Voilà állapotát.

Az esemény időpontját módosítod

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à-ból.

Az eseményt törlöd vagy lemondod

A Voilà a leckét lemondottként jelöli meg, és futtatja a lemondási szabályzat oktatóra vonatkozó 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óra vonatkozó lemondások mindig helyreállítják a tanulót.
• Csoportos lecké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.

Ú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 adott leckéhez.
• E-mailt küld a tanulónak, hogy megerősíthesse az időpontot.
• Tartja a helyet a rendelkezésedre álló időben, amíg a javaslat függőben van.

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

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

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őszakban. Nem kell semmit tenned; ez automatikus.

Mit tapasztalnak a tanulók

Amikor egy lecke megerősítésre kerül, a tanulód naptári meghívót kap ugyanarra az eseményre — a Meet vagy Teams csatlakozási linkkel benne. Így ő is kezelheti a leckét a saját naptárából. Íme pontosan, hogyan reagál a Voilà arra, amit a tanuló a postafiókjából vagy a naptár alkalmazásból tehet:

Tanuló művelete	Mit csinál a Voilà
Elfogadja a meghívót	Semmi extra — már rajta vannak a leckén. 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árbó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 leckét a naptárból	A Voilà futtatja a lemondási szabályzat tanulóra vonatkozó 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 (megtartod a fizetést).
Elutasít egy megerősített csoportos leckéből	Csak az adott tanuló helye kerül visszatérítésre; a lecke 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.
A meghívót egy másik postafiókba továbbítja	Nincs hatása a leckére — a Voilà az igazság forrása, és a meghívó továbbítása nem mozgatja a lecké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.

Csoportos leckék a naptáron keresztül

A csoportos lecké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ár eseményéből, a lecke folytatódik.
• Az elutasítás a leckét a min_seats alá csökkenti A LEMONDÁSI HATÁRIDŐ ELŐTT → az egész lecke lemondódik, minden fizetett hely visszatérítésre kerül, a naptár eseménye eltávolítódik.
• Az elutasítás a leckét a min_seats alá csökkenti A LEMONDÁSI HATÁRIDŐ UTÁN → a lecke marad (akik megtartották a helyüket, már fizettek az időpontért), és értesítési e-mailt kapsz, hogy eldönthesd, hogyan kezeld.

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

Az ismétlődő leckéket minden szolgáltatón másképp tárolják, de a tapasztalat ugyanaz:

• Google: a sorozat egy fő ismétlődő esemény. Az egyik 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 Graph-ból származó per-instance frissítések tisztán átfolynak. Az egyik 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à-ból automatikusan törli a megfelelő naptár előfordulást 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 azzal a szabályzattal, amely akkor volt aktív, amikor létrehozták.

Hogyan történik a szinkronizálás

A Voilà push é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árra; a frissítések másodperceken belül érkeznek, miután mentesz a Google Naptárban.
• Microsoft Outlook / Teams — a Voilà Microsoft Graph webhookokon keresztül feliratkozik; ugyanez a viselkedés.

A csatorna egészségességét néhány biztonsági háló tartja:

• Óránkénti karbantartási feladat megújítja az előfizetéseket, mielőtt lejárnának, és bootstrappel indítja az esetlegesen hiányzó figyeléseket.
• Visszatöltés csatlakoztatáskor feltölti a meglévő jövőbeli Voilà leckéket az új naptárra (és visszaimportálja a meglévő naptár foglalt időit).
• Kézi frissítés elérhető az Ütemezés oldalról — hasznos, ha teszteléshez vagy ha egy webhook rövid ideig lemaradt a szállítástó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 push-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áltak (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árból a határidő előtt: teljes visszatérítés vagy kredit visszaadása a tanulónak.
• A tanuló elutasít a naptárból a határidő után: a fizetés elvész (megtartod) vagy a munkamenet-kredit felhasználódik.
• Csoportos leckék: per-hely visszatérítések az egyéni elutasításokért; minden fizetett hely teljes visszatérítése, ha egy oktatóra vonatkozó lemondás vagy egy pre-cutoff csökkenés a min_seats alá lemondja a leckét.

Adatvédelem és hatókör

• A Voilà csak az általad csatlakoztatott naptárban olvas és ír eseményeket — soha nem más naptárakban a fiókodban.
• A Voilà által olvasott események kizárólag az ütemezéshez és a rendelkezésre állás kiszámításához használatosak.
• Az hozzáférést bármikor visszavonhatod a Beállítások → Integrációk menüben (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üt, és kattintson 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 biztonsági háló, amely megújítja az előfizetéseket és újraszinkronizálja az esetlegesen rövid ideig sikertelen 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árban 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ár eseménye egy „puha" tartás, amelyet szívesen feladsz.

Szolgáltatók váltása

Egyszerre csak egy naptár csatlakoztatható. Válassza le a Google-t, mielőtt csatlakoztatnád az Outlookot (vagy fordítva) a Beállítások → Integrációk menüben.

Kétirányú szinkronizálás, végpontok közötti

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: Lecke 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 postafiókbó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ár eseménye eltávolítva

Kapcsolódó

• Ütemezés — heti rendelkezésre állás, foglalási szabályzatok, szabadság mód
• Csoportos leckék — minimális helyek, tagkezelés, csoportos lemondási viselkedés
• Stripe Connect Payments — lemondási szabályzatok és hogyan alkalmazódnak a visszatérítések