Kalendoriaus integracija

Prijunk vieną kartą — valdyk iš bet kur. Kai prijungi „Google Calendar" arba „Microsoft Outlook" (Teams), tavo „Voilà" pamokos atsiranda kalendoriuje lygiai kaip bet kuris kitas susitikimas — ir viskas, ką darai su įvykiu savo kalendoriuje, automatiškai atsispindi „Voilà". Perkelk, atšauk, priimk, atmeskite — abi pusės sinchronizuojamos per kelias sekundes.

Šis puslapis skirtas mokytojams. Skyriuje „Ką mato tavo mokiniai" tiksliai paaiškinama, ką mato mokiniai savo pusėje, kad galėtum drąsiai valdyti visą savo tvarkaraštį iš kalendoriaus.

Palaikomi tiekėjai

Tiekėjas	Automatiškai pridedama vaizdo nuoroda	Kas sukuriama
Google Calendar	Google Meet	Vienas įvykis vienai pamokai, pagrindinis įvykis pasikartojančiai serijai
Microsoft Outlook / Teams	Microsoft Teams	Vienas įvykis vienai pamokai, vienas įvykis kiekvienam pasikartojimui

Vienu metu galima prijungti vieną kalendoriaus tiekėją. Norėdamas perjungti, pirmiausia atjunk dabartinį skiltyje Nustatymai → Integracijos.

„Google Calendar" prijungimas

1. Eik į Nustatymai → Integracijos arba Tvarkaraštis → Prijungti „Google Calendar".
2. Spustelėk Prijungti „Google Calendar".
3. Prisijunk su savo „Google" paskyra ir suteik „Voilà" leidimą skaityti bei rašyti įvykius.
4. Kalendorius pradeda sinchronizuotis iš karto.

Kas nutinka tą akimirką, kai prisijungi: visos patvirtintos būsimos „Voilà" pamokos iš karto perkeliamos į tavo „Google Calendar" — kiekviena su „Google Meet" nuoroda, iš anksto užpildytais dalyviais ir tekstu „Booked via Voilà". Daugiau nieko daryti nereikia.

„Microsoft Outlook / Teams" prijungimas

1. Eik į Nustatymai → Integracijos arba Tvarkaraštis → Prijungti „Outlook Calendar".
2. Spustelėk Prijungti „Outlook Calendar".
3. Prisijunk su savo „Microsoft" paskyra ir suteik „Voilà" leidimą skaityti bei rašyti įvykius.
4. Kalendorius pradeda sinchronizuotis iš karto.

Kiekviena pamoka atsiranda tavo „Outlook" kalendoriuje kaip „Teams" susitikimas (prisijungimo nuoroda pridedama automatiškai), o mokinys įtraukiamas kaip dalyvis. Tas pats papildymo elgesys taikomas ir čia: būsimos „Voilà" pamokos iš karto atsiranda tavo „Outlook" kalendoriuje.

Kas atsiranda tavo kalendoriuje („Voilà" → kalendorius)

„Voilà" įvykis	Ką matai kalendoriuje
Patvirtinamas individualus užsakymas	Kvietimas pamokos laiku su „Meet"/„Teams" nuoroda, mokiniu kaip dalyviu ir „Voilà" parašytu tekstu.
Patvirtinama grupinė pamoka	Tas pats įvykis su visais priėmusiais nariais dalyvių sąraše. Kai daugiau narių priima, jie pridedami; jei narys pasitraukia, jis pašalinamas.
Sukuriama pasikartojanti pamoka	Google: vienas pagrindinis pasikartojantis įvykis, apimantis visą seriją. Outlook: vienas įvykis kiekvienam pasikartojimui (kad atskiro egzemplioriaus atnaujinimai sklandžiai pereitų per „Microsoft Graph").
Perkėlimas patvirtinamas „Voilà"	Kvietimo pradžios/pabaigos laikas atnaujinamas vietoje, o dalyviai gauna pranešimą apie pakeitimą. Veikia tiek „Google", tiek „Outlook".
Pamoka atšaukiama „Voilà"	Kalendoriaus įvykis pašalinamas, o dalyviai gauna atšaukimo pranešimą. Veikia tiek „Google", tiek „Outlook".
Pasikartojantis egzempliorius praleidžiamas „Voilà"	Atšaukiamas tik tas vienas egzempliorius — likusi serija lieka nepakitusi.

Kas sinchronizuojama atgal į „Voilà" (kalendorius → „Voilà")

Šis skyrius leidžia tau „gyventi savo kalendoriuje". Viskas, kas nurodyta žemiau, automatiškai keičia „Voilà" būseną.

Perkelsi įvykio laiką

Vilkdamas „Voilà" įvykį į kitą laiką arba redaguodamas jo pradžią/pabaigą, „Voilà" viduje sukuri perkėlimo pasiūlymą. Kai mokinys patvirtina (programėlėje arba atsakydamas į el. laišką), įvykio laikas užfiksuojamas abiejose sistemose. Tol įvykis lieka kaip laukiantis pasiūlymas — mokinys vis dar gali jį matyti ir priimti/atmesti „Voilà" viduje.

Ištrinsi arba atšauksi įvykį

„Voilà" pažymi pamoką kaip atšauktą ir vykdo atšaukimo politikos mokytojo atšaukimo šaką:

• Mokiniui grąžinamas visas mokėjimas (jei „Stripe") arba grąžinamas sesijos kreditas (jei sesijų paketas), nepriklausomai nuo to, ar atšaukimas įvyko prieš ar po termino. Mokytojui priskiriami atšaukimai visada kompensuoja mokiniui visą sumą.
• Grupinėms pamokoms grąžinamos visos apmokėtos vietos.
• Mokinys gauna atšaukimo el. laišką ir pokalbio kortelės atnaujinimą.

Sukursi naują įvykį su vienu iš savo mokinių kaip dalyviu

Jei tarp jūsų yra aktyvi mokinio–mokytojo sąsaja, „Voilà":

• Automatiškai sukurs užsakymo pasiūlymą tai pamokai.
• Išsiųs mokiniui el. laišką, kad jis galėtų patvirtinti laiką.
• Rezervuos laiką tavo prieinamume, kol pasiūlymas laukia.

Jei dalyvis nėra žinomas tavo mokinys, „Voilà" įrašo įvykį kaip įprastą užimto laiko bloką tavo prieinamume — bet užsakymo nesukuria.

Pridėsi bet kurį kitą įvykį į savo kalendorių

Bet koks įvykis, kurį pridedi — darbo susitikimai, vizitai pas odontologą, pietūs su draugu — laikomas užimtu laiku ir blokuoja naujus mokinių užsakymus tuo laikotarpiu. Tau nieko daryti nereikia — tai vyksta automatiškai.

Ką mato tavo mokiniai

Kai pamoka patvirtinama, tavo mokinys gauna kalendoriaus kvietimą į tą patį įvykį — su „Meet" arba „Teams" prisijungimo nuoroda viduje. Taigi jie taip pat gali valdyti pamoką iš savo kalendoriaus. Štai kaip tiksliai „Voilà" reaguoja į kiekvieną veiksmą, kurį mokinys gali atlikti iš savo pašto dėžutės ar kalendoriaus programėlės:

Mokinio veiksmas	Ką daro „Voilà"
Priima kvietimą	Nieko papildomo — jie jau yra pamokoje. Jų RSVP įrašomas matomumui.
Atmeta laukiantį pasiūlymą iš savo kalendoriaus	Pasiūlymas atmetamas „Voilà". Tu gauni pranešimą el. paštu ir pokalbyje.
Atmeta patvirtintą individualią pamoką iš savo kalendoriaus	„Voilà" vykdo atšaukimo politikos mokinio atšaukimo šaką. Prieš terminą = visas grąžinimas arba kredito grąžinimas; po termino = prarandama (tu išlaikai mokėjimą).
Atmeta iš patvirtintos grupinės pamokos	Grąžinama tik to mokinio vieta; pamoka tęsiasi visiems kitiems (atsižvelgiant į tavo minimalių vietų taisyklę).
Atmeta pasikartojantį egzempliorių	Tas vienas egzempliorius praleidžiamas (grąžinimas arba praradimas pagal atšaukimo politiką). Likusi serija nepaliečiama.
Persiunčia kvietimą į kitą pašto dėžutę	Jokio poveikio pamokai — „Voilà" yra tiesos šaltinis, o kvietimo persiuntimas neperkelia pamokos ir negrąžina lėšų.

Trumpai tariant: mokiniai gali visiškai valdyti savo dalyvavimą iš savo kalendoriaus kvietimo, o tu matysi kiekvieną veiksmą „Voilà" pusėje per kelias sekundes.

Grupinės pamokos per kalendorių

Grupinės pamokos turi vieną papildomą niuansą — minimalių vietų taisyklę:

• Vienas narys atsisako → ta vieta grąžinama, dalyvis pašalinamas iš kalendoriaus įvykio, pamoka tęsiasi.
• Atsisakymas sumažina pamoką žemiau min_seats PRIEŠ atšaukimo terminą → visa pamoka atšaukiama, grąžinamos visos apmokėtos vietos, kalendoriaus įvykis pašalinamas.
• Atsisakymas sumažina pamoką žemiau min_seats PO atšaukimo termino → pamoka tęsiasi (žmonės, kurie išlaikė savo vietą, jau sumokėjo už laiką), o tu gauni informacinį el. laišką, kad galėtum nuspręsti, kaip elgtis.

Pasikartojančios pamokos per kalendorių

Pasikartojančios pamokos saugomos skirtingai kiekviename tiekėjuje, tačiau patirtis yra ta pati:

• Google: serija yra vienas pagrindinis pasikartojantis įvykis. Atsisakius vieno egzemplioriaus iš kalendoriaus, „Voilà" praleidžiamas tik tas egzempliorius; atsisakius pagrindinio, atšaukiami visi būsimi egzemplioriai.
• Outlook: kiekvienas egzempliorius susietas atskirai, kad atskiro egzemplioriaus atnaujinimai iš „Microsoft Graph" pereitų sklandžiai. Atsisakius vieno egzemplioriaus, jis praleidžiamas „Voilà"; atsisakius serijos, baigiami būsimi egzemplioriai.
• Praleidus egzempliorių „Voilà" viduje, atitinkamas kalendoriaus egzempliorius automatiškai atšaukiamas su tvaringu atšaukimo pranešimu dalyviams.
• Mokytojo atšaukimo politikos pakeitimas netaikomas atgaline data jau egzistuojantiems egzemplioriams — kiekvienas egzempliorius užfiksuoja politiką, kuri buvo aktyvi jo sukūrimo metu.

Kaip vykdomas sinchronizavimas

„Voilà" naudoja push pranešimus (webhooks) kaip pagrindinį trigerį:

• Google Calendar — „Voilà" prenumeruoja tavo kalendorių per „Google" events.watch kanalą; atnaujinimai pasiekia per kelias sekundes po to, kai išsaugai „Google Calendar".
• Microsoft Outlook / Teams — „Voilà" prenumeruoja per „Microsoft Graph" webhooks; elgesys toks pat.

Nedidelis apsaugos tinklų rinkinys palaiko kanalo sveikatą:

• Valandinis priežiūros darbas atnaujina prenumeratas prieš joms pasibaigiant ir inicijuoja trūkstamas stebėjimo priemones.
• Papildymas prisijungus perkelia esamas būsimas „Voilà" pamokas į tavo naują kalendorių (ir importuoja atgal tavo esamo kalendoriaus užimto laiko blokus).
• Rankinis atnaujinimas pasiekiamas iš tvarkaraščio puslapio — naudingas, kai testuoji arba kai webhook trumpam neįvykdė pristatymo.

Ankstesnėse šio puslapio versijose buvo minimas „5 minučių apklausos ciklas". Tai nebėra tikslu — sinchronizavimas yra push pagrindu ir paprastai įvyksta gerokai greičiau nei per 30 sekundžių.

Atšaukimo politika ir grąžinimai per kalendorių

Atšaukimai iš kalendoriaus pusės laikosi lygiai tos pačios atšaukimo politikos, kurią sukonfigūravai „Stripe" apmokėtiems užsakymams (žr. „Stripe Connect" mokėjimai):

• Tu atšauki (ištrinki/atšauki iš savo kalendoriaus): mokiniui visiškai grąžinama, nepriklausomai nuo laiko.
• Mokinys atsisako iš savo kalendoriaus prieš terminą: mokiniui grąžinamas visas mokėjimas arba kreditas.
• Mokinys atsisako iš savo kalendoriaus po termino: mokėjimas prarandamas (tu jį išlaikai) arba sesijos kreditas sunaudojamas.
• Grupinės pamokos: grąžinimai už atskiras vietas individualių atsisakymų atveju; visų apmokėtų vietų grąžinimas, jei mokytojo atšaukimas arba atsisakymas prieš terminą sumažina skaičių žemiau min_seats ir pamoka atšaukiama.

Privatumas ir apimtis

• „Voilà" skaito ir rašo įvykius tik tame kalendoriuje, kurį prijungi — niekada kituose tavo paskyros kalendoriuose.
• „Voilà" nuskaitomi įvykiai naudojami tik tvarkaraščio sudarymo ir prieinamumo skaičiavimams.
• Prieigą gali atšaukti bet kada skiltyje Nustatymai → Integracijos (arba tiesiogiai iš savo „Google" / „Microsoft" paskyros nustatymų).

Trikčių šalinimas

Pasibaigęs prieigos raktas

Jei sinchronizavimas sustoja, greičiausiai pasibaigė OAuth rakto galiojimas. Atidaryk Nustatymai → Integracijos ir spustelėk Prisijungti iš naujo.

Sinchronizavimo vėlavimai

Webhooks paprastai pristato per ~30 sekundžių. Valandinis priežiūros darbas yra apsaugos tinklas, kuris atnaujina prenumeratas ir iš naujo sinchronizuoja bet kokį trumpai nepavykusį pristatymą. Taip pat gali paleisti rankinį atnaujinimą iš Tvarkaraščio puslapio.

Konfliktai su ne „Voilà" įvykiais

Jei bandai patvirtinti „Voilà" užsakymą laiku, kurį dengia ne „Voilà" įvykis tavo kalendoriuje, „Voilà" įspės tave ir leis nepaisyti konflikto — naudinga, kai kalendoriaus įvykis yra „minkštas" rezervavimas, kurį noriai atleisi.

Tiekėjų keitimas

Vienu metu gali būti prijungtas tik vienas kalendorius. Atjunk „Google" prieš prijungdamas „Outlook" (arba atvirkščiai) skiltyje Nustatymai → Integracijos.

Dvikryptis sinchronizavimas, nuo pradžios iki pabaigos

sequenceDiagram
    participant Student
    participant StudentCal as "Student Calendar"
    participant Voila
    participant TutorCal as "Tutor Calendar (Google or Outlook)"
    participant Tutor

    Note over Voila,TutorCal: Lesson confirmed in Voilà
    Voila->>TutorCal: Create event with Meet or Teams link
    TutorCal-->>Student: Invite delivered
    TutorCal-->>StudentCal: Invite delivered

    Note over Student,StudentCal: Student declines from inbox
    StudentCal->>TutorCal: RSVP declined
    TutorCal->>Voila: Webhook fires
    Voila->>Voila: Run cancellation policy
    Voila-->>Tutor: In-app and email notice
    Voila-->>Student: Refund or forfeit confirmation

    Note over Tutor,TutorCal: Tutor cancels the event
    TutorCal->>Voila: Webhook fires
    Voila->>Voila: Cancel and refund
    Voila->>StudentCal: Calendar event removed

Susiję straipsniai

• Tvarkaraštis — savaitinis prieinamumas, užsakymų politikos, atostogų režimas
• Grupinės pamokos — minimalios vietos, narių valdymas, grupinio atšaukimo elgesys
• „Stripe Connect" mokėjimai — atšaukimo politikos ir grąžinimų taikymas