Kalendri integratsioon

Ühenda kord, halda kõikjal. Kui oled ühendanud Google Calendari või Microsoft Outlooki (Teams), elavad su Voilà tunnid sinu kalendris täpselt nagu iga teine kohtumine — ja kõik, mida sa kalendris sündmusega teed, kandub automaatselt Voilàsse tagasi. Ajasta ümber, tühista, nõustu, keeldu — mõlemad pooled jäävad sekundite jooksul sünkrooni.

See lehekülg on kirjutatud õpetajatele. Jaotis "Mida su õpilased kogevad" selgitab täpselt, mida su õpilased oma poolel näevad, et saaksid enesekindlalt juhtida kogu oma ajakava kalendrist.

Toetatud teenusepakkujad

Pakkuja	Videolink automaatselt lisatud	Mis luuakse
Google Calendar	Google Meet	Üks sündmus tunni kohta, peamine sündmus korduvate seeriate kohta
Microsoft Outlook / Teams	Microsoft Teams	Üks sündmus tunni kohta, üks sündmus korduvate esinemiste kohta

Saad ühendada ühe kalendripakkuja korraga. Vahetamiseks katkesta esmalt praegune ühendus jaotises Seaded → Integratsioonid.

Google Calendari ühendamine

1. Mine Seaded → Integratsioonid või Ajastamine → Ühenda Google Calendar.
2. Klõpsa Ühenda Google Calendar.
3. Logi sisse oma Google kontoga ja anna Voilàle luba sündmusi lugeda ja kirjutada.
4. Su kalender hakkab kohe sünkroniseeruma.

Mis juhtub ühendamise hetkel: iga kinnitatud tulevane Voilà tund lükatakse su Google Calendrisse — igaüks Google Meet lingiga, osalejad eelnevalt täidetud ja "Broneeritud Voilà kaudu" sisuga. Midagi muud pole vaja teha.

Microsoft Outlook / Teams ühendamine

1. Mine Seaded → Integratsioonid või Ajastamine → Ühenda Outlook Calendar.
2. Klõpsa Ühenda Outlook Calendar.
3. Logi sisse oma Microsoft kontoga ja anna Voilàle luba sündmusi lugeda ja kirjutada.
4. Su kalender hakkab kohe sünkroniseeruma.

Iga tund ilmub su Outlook kalendrisse Teams koosolekuna (liitumislink lisatakse automaatselt), õpilane on märgitud osalejaks. Sama täitmiskäitumine kehtib: tulevased Voilà tunnid ilmuvad su Outlook kalendrisse kohe.

Mis ilmub su kalendrisse (Voilà → kalender)

Voilà sündmus	Mida näed kalendris
1:1 broneering kinnitatakse	Kutse tunni ajal, Meet/Teams lingiga, õpilane osalejana ja Voilà koostatud sisuga.
Grupitund kinnitatakse	Sama sündmus, kõik aktsepteerinud liikmed osalejate nimekirjas. Kui rohkem liikmeid aktsepteerib, lisatakse nad; kui liige lahkub, eemaldatakse nad.
Korduv tund luuakse	Google: üks peamine korduv sündmus, mis katab kogu seeriat. Outlook: üks sündmus esinemise kohta (nii voolavad eksemplari-põhised uuendused sujuvalt Microsoft Graphi kaudu).
Ümberajastamine aktsepteeritakse Voilàs	Kutse algus-/lõpuaeg uuendatakse kohapeal ja osalejad saavad uuenduseteate. Töötab nii Google'is kui Outlookis.
Tund tühistatakse Voilàs	Kalendrisündmus eemaldatakse ja osalejaid teavitatakse tühistamisteatega. Töötab nii Google'is kui Outlookis.
Korduva sündmuse esinemine jäetakse Voilàs vahele	Ainult see üks esinemine tühistatakse — ülejäänud seeria jääb puutumatuks.

Mis sünkroniseerub tagasi Voilàsse (kalender → Voilà)

See on jaotis, mis laseb sul "elada oma kalendris". Kõik allolev muudab Voilà olekut automaatselt.

Sa liigutad sündmuse aega

Voilà sündmuse lohistamine teisele kohale või selle algus-/lõpuaja muutmine avab Voilàs ümberajastamise ettepaneku. Kui õpilane kinnitab (rakenduses või e-mailile vastates), lukustatakse sündmuse aeg mõlemas süsteemis. Seni istub sündmus ootel ettepanekuna — õpilane saab seda endiselt näha ja aktsepteerida/keelduda Voilàs.

Sa kustutad või tühistad sündmuse

Voilà märgib tunni tühistatuks ja käivitab tühistamispoliitika õpetaja-tühistab haru:

• Õpilasele tagastatakse täielik makse (kui Stripe) või tagastatakse tema seansikrediit (kui seansipakett), olenemata sellest, kas tühistamine toimus enne või pärast tähtaega. Õpetajale omistatud tühistamised teevad õpilase alati terveks.
• Grupitundide puhul tagastatakse iga tasulise koha eest.
• Õpilane saab tühistamise e-maili ja vestluskaardi uuenduse.

Sa lood uue sündmuse, kus üks su õpilastest on osaleja

Kui teie vahel on aktiivne õpilane-õpetaja suhe, siis Voilà:

• Loob automaatselt selle tunni jaoks broneerimisettepaneku.
• Saadab õpilasele e-maili, et ta saaks aja kinnitada.
• Hoiab koha su kättesaadavuses, kuni ettepanek on ootel.

Kui osaleja pole su teadaolev õpilane, salvestab Voilà sündmuse tavalise hõivatud plokina su kättesaadavuses — kuid ei loo broneeringut.

Sa lisad oma kalendrisse mõne muu sündmuse

Iga sündmus, mille lisad — töökoosolekud, hambaarsti visiidid, lõuna sõbraga — käsitletakse hõivatud ajana ja blokeerib uued õpilaste broneeringud selle akna jooksul. Sa ei pea midagi tegema; see on automaatne.

Mida su õpilased kogevad

Kui tund kinnitatakse, saab su õpilane kalendrikutse samale sündmusele — Meet või Teams liitumislingiga sees. Nii saavad nad tunni ka oma kalendrist hallata. Siin on täpselt, kuidas Voilà reageerib igale asjale, mida õpilane saab teha oma postkastist või kalendrirakendusest:

Õpilase tegevus	Mida Voilà teeb
Aktsepteerib kutse	Midagi lisaks — nad on juba tunnis. Nende RSVP salvestatakse nähtavuse jaoks.
Keeldub ootel ettepanekust oma kalendrist	Ettepanek lükatakse Voilàs tagasi. Sind teavitatakse e-maili ja vestluse teel.
Keeldub kinnitatud 1:1 tunnist oma kalendrist	Voilà käivitab tühistamispoliitika õpilane-tühistab haru. Enne tähtaega = täielik tagasimakse või krediidi tagastamine; pärast tähtaega = kaotus (sa hoiad makse).
Keeldub kinnitatud grupitunnist	Ainult selle õpilase koht tagastatakse; tund jätkub kõigi teiste jaoks (vastavalt su minimaalsete kohtade reeglile).
Keeldub korduvast esinemisest	See üksik esinemine jäetakse vahele (tagasimakse või kaotus vastavalt tühistamispoliitikale). Ülejäänud seeria jääb puutumata.
Edastab kutse teisele postkastile	Tunnile mõju ei avalda — Voilà on tõe allikas ja kutse edastamine ei liiguta tunni ega väljasta tagasimakseid uuesti.

Lühidalt: õpilased saavad oma osalemist täielikult hallata oma kalendrikutsest ja näed iga tegevust Voilà poolel sekundite jooksul kajastumas.

Grupitunnid kalendri kaudu

Grupitunnid lisavad ühe lisavoldiku — minimaalsete kohtade reegel:

• Üks liige keeldub → see koht tagastatakse, osaleja eemaldatakse kalendrisündmusest, tund jätkub.
• Keeldumine viib tunni alla min_seats ENNE tühistamise tähtaega → kogu tund tühistatakse, iga tasulise koha eest tagastatakse, kalendrisündmus eemaldatakse.
• Keeldumine viib tunni alla min_seats PÄRAST tühistamise tähtaega → tund jääb (inimesed, kes oma koha hoidsid, on juba koha eest maksnud), ja saad hoiatuse e-maili, et saaksid otsustada, kuidas sellega toime tulla.

Korduvad tunnid kalendri kaudu

Korduvad tunnid salvestatakse igal pakkujal erinevalt, kuid kogemus on sama:

• Google: seeria on üks peamine korduv sündmus. Ühe eksemplari keeldumine kalendrist jätab Voilàs vahele ainult selle esinemise; peamisest keeldumine tühistab iga tulevase esinemise.
• Outlook: iga esinemine on lingitud individuaalselt, nii et eksemplari-põhised uuendused Microsoft Graphist voolavad sujuvalt läbi. Ühe esinemise keeldumine jätab selle Voilàs vahele; seeriale keeldumine lõpetab tulevased esinemised.
• Esinemise vahele jätmine Voilà seest tühistab automaatselt vastava kalendrieksemplari puhta tühistamisteatega osalejatele.
• Õpetaja tühistamispoliitika muudatust EI rakendata tagasiulatuvalt juba olemasolevatele esinemistele — iga esinemine lukustab poliitika, mis oli aktiivne selle loomisel.

Kuidas sünkroniseerimine toimub

Voilà kasutab peamise päästikuna push-teatisi (webhookid):

• Google Calendar — Voilà tellib su kalendri Google'i events.watch kanali kaudu; uuendused jõuavad sekundite jooksul pärast Google Calendris salvestamist.
• Microsoft Outlook / Teams — Voilà tellib Microsoft Graphi webhookide kaudu; sama käitumine.

Väike turvavõrkude komplekt hoiab kanali tervena:

• Tunni hooldusülesanne uuendab tellimusi enne nende aegumist ja käivitab puuduvad jälgimised.
• Täitmine ühendamisel lükkab olemasolevad tulevased Voilà tunnid su uude kalendrisse (ja impordib tagasi su olemasoleva kalendri hõivatud ajad).
• Käsitsi värskendamine on saadaval Ajastamise lehelt — kasulik testimisel või kui webhook jättis lühidalt kohaletoimetamise vahele.

Selle lehe varasemad versioonid mainisid "5-minutilist küsitlustsüklit". See pole enam täpne — sünkroniseerimine on push-põhine ja jõuab tavaliselt alla 30 sekundi.

Tühistamispoliitika ja tagasimaksed kalendri kaudu

Kalendripoolsed tühistamised järgivad täpselt sama tühistamispoliitikat, mille oled seadistanud Stripe'iga makstud broneeringutele (vaata Stripe Connect Maksed):

• Sa tühistad (kustutad/tühistad oma kalendrist): õpilasele tagastatakse täielikult, olenemata ajastusest.
• Õpilane keeldub oma kalendrist enne tähtaega: täielik tagasimakse või krediidi tagastamine õpilasele.
• Õpilane keeldub oma kalendrist pärast tähtaega: makse kaotatakse (sa hoiad selle) või seansikrediit tarbitakse.
• Grupitunnid: koha-põhised tagasimaksed individuaalsete keeldumiste eest; iga tasulise koha täielik tagasimakse, kui õpetaja tühistamine või enne tähtaega alla min_seats langus tühistab tunni.

Privaatsus ja ulatus

• Voilà loeb ja kirjutab sündmusi ainult kalendris, mille ühendad — mitte kunagi teistes su konto kalendrites.
• Sündmusi, mida Voilà loeb, kasutatakse ainult ajastamiseks ja kättesaadavuse arvutusteks.
• Saad juurdepääsu igal ajal tühistada jaotises Seaded → Integratsioonid (või otse oma Google / Microsoft konto seadetest).

Tõrkeotsing

Token aegunud

Kui sünkroniseerimine peatub, on OAuth token tõenäoliselt aegunud. Ava Seaded → Integratsioonid ja klõpsa Ühenda uuesti.

Sünkroniseerimise viivitused

Webhookid toimetatakse tavaliselt ~30 sekundi jooksul. Tunni hooldusülesanne on turvavõrk, mis uuendab tellimusi ja sünkroniseerib uuesti mis tahes kohaletoimetamise, mis lühidalt ebaõnnestus. Saad käivitada ka käsitsi värskendamise Ajastamise lehelt.

Konfliktid mitte-Voilà sündmustega

Kui proovid kinnitada Voilà broneeringut kohal, mis on kaetud mitte-Voilà sündmusega su kalendris, hoiatab Voilà sind ja laseb konflikti alistada — kasulik, kui kalendrisündmus on "pehme" hoid, mille oled nõus vabastama.

Pakkujate vahetamine

Korraga saab ühendada ainult ühe kalendri. Katkesta Google enne Outlooki ühendamist (või vastupidi) jaotises Seaded → Integratsioonid.

Kahesuunaline sünkroniseerimine, otsast lõpuni

sequenceDiagram
    participant Student as Õpilane
    participant StudentCal as "Õpilase kalender"
    participant Voila
    participant TutorCal as "Õpetaja kalender (Google või Outlook)"
    participant Tutor as Õpetaja

    Note over Voila,TutorCal: Tund kinnitatud Voilàs
    Voila->>TutorCal: Loo sündmus Meet või Teams lingiga
    TutorCal-->>Student: Kutse kohale toimetatud
    TutorCal-->>StudentCal: Kutse kohale toimetatud

    Note over Student,StudentCal: Õpilane keeldub postkastist
    StudentCal->>TutorCal: RSVP keeldutud
    TutorCal->>Voila: Webhook käivitub
    Voila->>Voila: Käivita tühistamispoliitika
    Voila-->>Tutor: Rakendusesisene ja e-maili teade
    Voila-->>Student: Tagasimakse või kaotuse kinnitus

    Note over Tutor,TutorCal: Õpetaja tühistab sündmuse
    TutorCal->>Voila: Webhook käivitub
    Voila->>Voila: Tühista ja tagasta
    Voila->>StudentCal: Kalendrisündmus eemaldatud

Seotud

• Ajastamine — nädalane kättesaadavus, broneerimispoliitikad, puhkuserežiim
• Grupitunnid — minimaalsed kohad, liikmete haldamine, grupi tühistamise käitumine
• Stripe Connect Maksed — tühistamispoliitikad ja kuidas tagasimakseid rakendatakse