Kalendoriaus integracija

Prijunkite kartą, valdykite visur. Kai prijungsite Google Calendar arba Microsoft Outlook (Teams), jūsų Voilà pamokos atsiras jūsų kalendoriuje lygiai kaip bet kuris kitas susitikimas — ir bet kas, ką darysite su įvykiu iš savo kalendoriaus, automatiškai pereis į Voilà. Perkelkite, atšaukite, priimkite, atmeskite — abi pusės išliks sinchronizuotos per kelias sekundes.

Šis puslapis skirtas dėstytojams. Skyrius „Ką patiria jūsų studentai" tiksliai paaiškina, ką mato jūsų studentai savo pusėje, kad galėtumėte užtikrintai valdyti visą savo tvarkaraštį iš savo kalendoriaus.

Palaikomi teikėjai

Teikėjas	Vaizdo nuoroda automatiškai pridedama	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 pasikartojančiam atvejui

Galite prijungti vieną kalendoriaus teikėją vienu metu. Norėdami perjungti, pirmiausia atjunkite dabartinį Nustatymai → Integracijos skiltyje.

Google Calendar prijungimas

1. Eikite į Nustatymai → Integracijos arba Planavimas → Prijungti Google Calendar.
2. Spustelėkite Prijungti Google Calendar.
3. Prisijunkite su savo Google paskyra ir leiskite Voilà skaityti bei rašyti įvykius.
4. Jūsų kalendorius pradės sinchronizuotis iš karto.

Kas nutinka tą akimirką, kai prijungiate: kiekviena patvirtinta būsima Voilà pamoka perkeliama į jūsų Google Calendar — kiekviena su Google Meet nuoroda, iš anksto užpildytais dalyviais ir „Užsakyta per Voilà" turiniu. Nieko daugiau daryti nereikia.

Microsoft Outlook / Teams prijungimas

1. Eikite į Nustatymai → Integracijos arba Planavimas → Prijungti Outlook Calendar.
2. Spustelėkite Prijungti Outlook Calendar.
3. Prisijunkite su savo Microsoft paskyra ir leiskite Voilà skaityti bei rašyti įvykius.
4. Jūsų kalendorius pradės sinchronizuotis iš karto.

Kiekviena pamoka atsiranda jūsų Outlook kalendoriuje kaip Teams susitikimas (prisijungimo nuoroda pridedama automatiškai), su studentu, įtrauktu kaip dalyviu. Taikomas tas pats atgalinio užpildymo elgesys: būsimos Voilà pamokos iš karto atsiranda jūsų Outlook kalendoriuje.

Kas atsiranda jūsų kalendoriuje (Voilà → kalendorius)

Voilà įvykis	Ką matote kalendoriuje
1:1 rezervacija patvirtinama	Kvietimas pamokos metu, su Meet/Teams nuoroda, studentu kaip dalyviu ir Voilà sukurtu turiniu.
Grupės pamoka patvirtinama	Tas pats įvykis, su kiekvienu priimtu nariu dalyvių sąraše. Kai daugiau narių priima, jie pridedami; jei narys išeina, jis pašalinamas.
Sukuriama pasikartojanti pamoka	Google: vienas pagrindinis pasikartojantis įvykis, apimantis visą seriją. Outlook: vienas įvykis kiekvienam atvejui (kad atskiri atnaujinimai sklandžiai pereitų per Microsoft Graph).
Voilà priimamas perkėlimas	Kvietimo pradžios/pabaigos laikas atnaujinamas vietoje ir dalyviai gauna atnaujinimo pranešimą. Veikia tiek Google, tiek Outlook.
Pamoka atšaukiama Voilà	Kalendoriaus įvykis pašalinamas ir dalyviai informuojami atšaukimo pranešimu. Veikia tiek Google, tiek Outlook.
Pasikartojantis atvejis praleidžiamas Voilà	Atšaukiamas tik tas vienas atvejis — likusi serijos dalis lieka nepažeista.

Kas sinchronizuojasi atgal į Voilà (kalendorius → Voilà)

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

Jūs perkeliate įvykio laiką

Tempiant Voilà įvykį į kitą laiką arba redaguojant jo pradžią/pabaigą, atidaromas perkėlimo pasiūlymas Voilà viduje. Kai studentas patvirtina (programėlėje arba atsakydamas į el. laišką), įvykio laikas užfiksuojamas abiejose sistemose. Iki tol įvykis lieka kaip laukiantis pasiūlymas — studentas vis dar gali jį matyti ir priimti/atmesti Voilà viduje.

Jūs ištrinate arba atšaukiate įvykį

Voilà pažymi pamoką kaip atšauktą ir vykdo dėstytojo atšaukimo šakos atšaukimo politiką:

• Studentui 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 ribinio laiko. Dėstytojo atšaukimai visada kompensuoja studentui.
• Grupės pamokoms grąžinamos visos apmokėtos vietos.
• Studentas gauna atšaukimo el. laišką ir pokalbio kortelės atnaujinimą.

Jūs sukuriate naują įvykį su vienu iš savo studentų kaip dalyviu

Jei tarp jūsų yra aktyvus studento–dėstytojo ryšys, Voilà:

• Automatiškai sukurs rezervacijos pasiūlymą tai pamokai.
• Išsiųs studentui el. laišką, kad jis galėtų patvirtinti laiką.
• Išlaikys vietą jūsų prieinamume, kol pasiūlymas laukia.

Jei dalyvis nėra jūsų žinomas studentas, Voilà įrašo įvykį kaip įprastą užimtą bloką jūsų prieinamume — bet nesukuria rezervacijos.

Jūs pridėdate bet kurį kitą įvykį į savo kalendorių

Bet kuris jūsų pridėtas įvykis — darbo susitikimai, vizitai pas gydytoją, pietūs su draugu — laikomas užimtu laiku ir blokuoja naują studentų rezervacijų tuo metu. Jums nieko daryti nereikia; tai automatiškai.

Ką patiria jūsų studentai

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

Studento veiksmas	Ką daro Voilà
Priima kvietimą	Nieko papildomai — jie jau yra pamokoje. Jų RSVP įrašomas matomumui.
Atmeta laukiantį pasiūlymą iš savo kalendoriaus	Pasiūlymas atmetamas Voilà. Jūs informuojami el. paštu ir pokalbiu.
Atmeta patvirtintą 1:1 pamoką iš savo kalendoriaus	Voilà vykdo studento atšaukimo šakos atšaukimo politiką. Prieš ribinį laiką = visas grąžinimas arba kredito grąžinimas; po ribinio laiko = praradimas (jūs pasilaikote mokėjimą).
Atmeta iš patvirtintos grupės pamokos	Grąžinama tik to studento vieta; pamoka tęsiama visiems kitiems (pagal jūsų minimalių vietų taisyklę).
Atmeta pasikartojantį atvejį	Tas vienas atvejis praleidžiamas (grąžinimas arba praradimas pagal atšaukimo politiką). Likusi serijos dalis nepažeista.
Persiunčia kvietimą į kitą pašto dėžutę	Jokio poveikio pamokai — Voilà yra tiesos šaltinis, ir kvietimo persiuntimas neperkelia pamokos ar neišduoda grąžinimų.

Trumpai: studentai gali valdyti savo dalyvavimą visiškai iš savo kalendoriaus kvietimo, o jūs matysite kiekvieną veiksmą atsispindintį Voilà pusėje per kelias sekundes.

Grupės pamokos per kalendorių

Grupės pamokos prideda vieną papildomą niuansą — minimalių vietų taisyklę:

• Vienas narys atsisako → ta vieta grąžinama, dalyvis pašalinamas iš kalendoriaus įvykio, pamoka tęsiama.
• Atsisakymas numeta pamoką žemiau min_seats PRIEŠ atšaukimo ribinį laiką → visa pamoka atšaukiama, kiekviena apmokėta vieta grąžinama, kalendoriaus įvykis pašalinamas.
• Atsisakymas numeta pamoką žemiau min_seats PO atšaukimo ribinio laiko → pamoka lieka (žmonės, kurie išlaikė savo vietą, jau sumokėjo už laiką), ir jūs gaunate perspėjimo el. laišką, kad galėtumėte nuspręsti, kaip tai spręsti.

Pasikartojančios pamokos per kalendorių

Pasikartojančios pamokos saugomos skirtingai kiekviename teikėje, bet patirtis yra ta pati:

• Google: serija yra vienas pagrindinis pasikartojantis įvykis. Vieno atvejo atmetimas iš kalendoriaus praleidžia tik tą atvejį Voilà; pagrindinio atmetimas atšaukia kiekvieną būsimą atvejį.
• Outlook: kiekvienas atvejis susietas atskirai, kad atskiri atnaujinimai iš Microsoft Graph sklandžiai pereitų. Vieno atvejo atmetimas praleidžia jį Voilà; serijos atmetimas baigia būsimus atvejus.
• Atvejo praleidimas iš Voilà vidaus automatiškai atšaukia atitinkamą kalendoriaus atvejį su švariu atšaukimo pranešimu dalyviams.
• Dėstytojo atšaukimo politikos pakeitimas NETAIKOMAS atgaline data jau egzistuojantiems atvejams — kiekvienas atvejis užfiksuoja politiką, kuri buvo aktyvi, kai jis buvo sukurtas.

Kaip pristatoma sinchronizacija

Voilà naudoja push pranešimus (webhooks) kaip pagrindinį paleidiklį:

• Google Calendar — Voilà prenumeruoja jūsų kalendorių per Google events.watch kanalą; atnaujinimai ateina per kelias sekundes po išsaugojimo Google Calendar.
• Microsoft Outlook / Teams — Voilà prenumeruoja per Microsoft Graph webhooks; tas pats elgesys.

Nedidelis saugos tinklų rinkinys palaiko kanalo sveikatą:

• Valandinis priežiūros darbas atnaujina prenumeratas prieš joms pasibaigiant ir inicijuoja bet kokius trūkstamus stebėjimus.
• Atgalinis užpildymas prijungiant perkelia esamas būsimas Voilà pamokas į jūsų naują kalendorių (ir atgal importuoja jūsų esamus kalendoriaus užimtus laikus).
• Rankinis atnaujinimas prieinamas iš Planavimo puslapio — naudingas, jei testuojate arba jei webhook trumpam praleido pristatymą.

Ankstesnėse šio puslapio versijose buvo minimas „5 minučių apklausos ciklas". Tai nebėra tiksliai — sinchronizacija yra push pagrindo ir paprastai ateina per mažiau nei 30 sekundžių.

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

Kalendoriaus pusės atšaukimai laikosi tiksliai tos pačios atšaukimo politikos, kurią sukonfigūravote Stripe mokamoms rezervacijoms (žr. Stripe Connect mokėjimai):

• Jūs atšaukiate (ištrinate/atšaukiate iš savo kalendoriaus): studentui visiškai grąžinama, nepriklausomai nuo laiko.
• Studentas atsisako iš savo kalendoriaus prieš ribinį laiką: visas grąžinimas arba kredito grąžinimas studentui.
• Studentas atsisako iš savo kalendoriaus po ribinio laiko: mokėjimas prarandamas (jūs pasilaikote) arba sesijos kreditas sunaudojamas.
• Grupės pamokos: atskirų vietų grąžinimai už individualius atsisakymus; visų apmokėtų vietų grąžinimas, jei dėstytojo atšaukimas arba kritimas žemiau min_seats prieš ribinį laiką atšaukia pamoką.

Privatumas ir aprėptis

• Voilà skaito ir rašo įvykius tik kalendoriuje, kurį prijungiate — niekada jokiuose kituose jūsų paskyros kalendoriuose.
• Įvykiai, kuriuos skaito Voilà, naudojami tik planavimui ir prieinamumo skaičiavimams.
• Galite atšaukti prieigą bet kada Nustatymai → Integracijos skiltyje (arba tiesiogiai iš savo Google / Microsoft paskyros nustatymų).

Trikčių šalinimas

Žetonas pasibaigė

Jei sinchronizacija sustoja, OAuth žetonas tikriausiai pasibaigė. Atidarykite Nustatymai → Integracijos ir spustelėkite Prijungti iš naujo.

Sinchronizacijos vėlavimai

Webhooks paprastai pristato per ~30 sekundžių. Valandinis priežiūros darbas yra saugos tinklas, kuris atnaujina prenumeratas ir iš naujo sinchronizuoja bet kokį pristatymą, kuris trumpam nepavyko. Taip pat galite paleisti rankinį atnaujinimą iš Planavimo puslapio.

Konfliktai su ne-Voilà įvykiais

Jei bandysite patvirtinti Voilà rezervaciją laike, kurį dengia ne-Voilà įvykis jūsų kalendoriuje, Voilà įspės jus ir leis perrašyti konfliktą — naudinga, kai kalendoriaus įvykis yra „švelnus" išlaikymas, kurį mielai atleisite.

Teikėjų keitimas

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

Dvikryptė sinchronizacija, nuo pradžios iki pabaigos

sequenceDiagram
    participant Student
    participant StudentCal as "Studento kalendorius"
    participant Voila
    participant TutorCal as "Dėstytojo kalendorius (Google arba Outlook)"
    participant Tutor

    Note over Voila,TutorCal: Pamoka patvirtinta Voilà
    Voila->>TutorCal: Sukurti įvykį su Meet arba Teams nuoroda
    TutorCal-->>Student: Kvietimas pristatytas
    TutorCal-->>StudentCal: Kvietimas pristatytas

    Note over Student,StudentCal: Studentas atsisako iš pašto dėžutės
    StudentCal->>TutorCal: RSVP atmesta
    TutorCal->>Voila: Webhook suveikia
    Voila->>Voila: Vykdyti atšaukimo politiką
    Voila-->>Tutor: Programėlės ir el. pašto pranešimas
    Voila-->>Student: Grąžinimo arba praradimo patvirtinimas

    Note over Tutor,TutorCal: Dėstytojas atšaukia įvykį
    TutorCal->>Voila: Webhook suveikia
    Voila->>Voila: Atšaukti ir grąžinti
    Voila->>StudentCal: Kalendoriaus įvykis pašalintas

Susiję

• Planavimas — savaitės prieinamumas, rezervacijos politikos, atostogų režimas
• Grupės pamokos — minimalios vietos, narių valdymas, grupės atšaukimo elgesys
• Stripe Connect mokėjimai — atšaukimo politikos ir kaip taikomi grąžinimai