Integracija kalendara

Povežite jednom, upravljajte svugdje. Kada povežete Google Calendar ili Microsoft Outlook (Teams), vaše Voilà lekcije žive na vašem kalendaru točno kao i bilo koji drugi sastanak — i sve što učinite s događajem iz vašeg kalendara automatski se prenosi u Voilà. Prerasporedite, otkažite, prihvatite, odbacite — obje strane ostaju sinkronizirane u roku od sekundi.

Ova stranica je napisana za tutore. Odjeljak "Što vaši studenti doživljavaju" objašnjava točno što vaši studenti vide na svojoj strani tako da možete sigurno upravljati cijelim rasporedom iz svog kalendara.

Podržani pružatelji usluga

Pružatelj usluge	Video link automatski priložen	Što se kreira
Google Calendar	Google Meet	Jedan događaj po lekciji, glavni događaj po ponavljajućoj seriji
Microsoft Outlook / Teams	Microsoft Teams	Jedan događaj po lekciji, jedan događaj po ponavljajućem pojavljivanju

Možete povezati jednog pružatelja kalendara u isto vrijeme. Za prebacivanje, prvo prekinite vezu s trenutnim pod Postavke → Integracije.

Povezivanje Google Calendara

1. Idite na Postavke → Integracije, ili Raspored → Povežite Google Calendar.
2. Kliknite Povežite Google Calendar.
3. Prijavite se sa svojim Google računom i autorizirajte Voilà da čita i piše događaje.
4. Vaš kalendar počinje sinkronizaciju odmah.

Što se događa u trenutku kada se povežete: svaka potvrđena buduća Voilà lekcija se gura na vaš Google Calendar — svaka s Google Meet linkom, sudionicima unaprijed popunjenima, i tijelom "Rezervirano putem Voilà". Nema ništa drugo za učiniti.

Povezivanje Microsoft Outlook / Teams

1. Idite na Postavke → Integracije, ili Raspored → Povežite Outlook Calendar.
2. Kliknite Povežite Outlook Calendar.
3. Prijavite se sa svojim Microsoft računom i autorizirajte Voilà da čita i piše događaje.
4. Vaš kalendar počinje sinkronizaciju odmah.

Svaka lekcija stiže na vaš Outlook kalendar kao Teams sastanak (link za pridruživanje se automatski prilaže), sa studentom navedenim kao sudionik. Isto ponašanje popunjavanja se primjenjuje: buduće Voilà lekcije se odmah pojavljuju na vašem Outlook kalendaru.

Što se pojavljuje na vašem kalendaru (Voilà → kalendar)

Voilà događaj	Što vidite na kalendaru
1:1 rezervacija je potvrđena	Pozivnica u vrijeme lekcije, s Meet/Teams linkom, studentom kao sudionik, i tijelom autorskim od Voilà.
Grupna lekcija se potvrđuje	Isti događaj, sa svakim prihvaćenim članom na listi sudionika. Kako više članova prihvaća, dodaju se; ako član odustane, uklanja se.
Ponavljajuća lekcija je kreirana	Google: jedan glavni ponavljajući događaj koji pokriva cijelu seriju. Outlook: jedan događaj po pojavljivanju (tako da ažuriranja po instanci teku glatko kroz Microsoft Graph).
Preraspoređivanje je prihvaćeno u Voilà	Početno/završno vrijeme pozivnice se ažurira na mjestu i sudionici primaju obavijest o ažuriranju. Radi na Google i Outlook.
Lekcija je otkazana u Voilà	Kalendarski događaj se uklanja i sudionici su obaviješteni obavijesti o otkazivanju. Radi na Google i Outlook.
Ponavljajuće pojavljivanje je preskočeno u Voilà	Samo to jedno pojavljivanje je otkazano — ostatak serije ostaje netaknut.

Što se sinkronizira natrag u Voilà (kalendar → Voilà)

Ovo je odjeljak koji vam omogućuje da "živite u svom kalendaru". Sve ispod automatski mijenja stanje Voilà.

Pomičete vrijeme događaja

Povlačenje Voilà događaja u drugi slot, ili uređivanje njegovog početka/kraja, otvara prijedlog preraspoređivanja unutar Voilà. Kada student potvrdi (u aplikaciji ili odgovaranjem na email), vrijeme događaja se zaključava u oba sustava. Do tada, događaj stoji kao prijedlog na čekanju — student ga još uvijek može vidjeti i prihvatiti/odbaciti iz Voilà.

Brišete ili otkažete događaj

Voilà označava lekciju otkazanom i pokreće granu otkazivanja od strane tutora pravila otkazivanja:

• Studentu se vraća puni iznos (ako Stripe) ili mu se vraća kredit sesije (ako paket sesija), bez obzira na to je li otkazivanje bilo prije ili nakon roka. Otkazivanja pripisana tutoru uvijek čine studenta cjelovitim.
• Za grupne lekcije, svako plaćeno mjesto se refundira.
• Student prima email o otkazivanju i ažuriranje chat kartice.

Kreirate novi događaj s jednim od vaših studenata kao sudionik

Ako postoji aktivna veza student–tutor između vas, Voilà će:

• Automatski kreirati prijedlog rezervacije za tu lekciju.
• Poslati email studentu tako da može potvrditi vrijeme.
• Držati slot na vašoj dostupnosti dok je prijedlog na čekanju.

Ako sudionik nije poznati student, Voilà bilježi događaj kao redoviti zauzeti blok na vašoj dostupnosti — ali ne kreira rezervaciju.

Dodajete bilo koji drugi događaj u svoj kalendar

Bilo koji događaj koji dodate — poslovni sastanci, odlazak zubaru, ručak s prijateljem — tretira se kao zauzeto vrijeme i blokira nove studentske rezervacije tijekom tog prozora. Ne morate ništa učiniti; ovo je automatski.

Što vaši studenti doživljavaju

Kad god je lekcija potvrđena, vaš student prima pozivnicu za kalendar za isti događaj — s Meet ili Teams linkom za pridruživanje unutra. Tako mogu upravljati lekcijom iz svog vlastitog kalendara također. Evo točno kako Voilà reagira na svaku stvar koju student može učiniti iz svoje pošte ili kalendarske aplikacije:

Studentska akcija	Što Voilà radi
Prihvaća pozivnicu	Ništa dodatno — već su na lekciji. Njihov RSVP je zabilježen za vidljivost.
Odbacuje prijedlog na čekanju iz svog kalendara	Prijedlog je odbačen u Voilà. Obaviješteni ste emailom i chatom.
Odbacuje potvrđenu 1:1 lekciju iz svog kalendara	Voilà pokreće granu otkazivanja od strane studenta pravila otkazivanja. Prije roka = puni povrat ili vraćanje kredita; nakon roka = gubitak (zadržavate plaćanje).
Odbacuje iz potvrđene grupne lekcije	Samo se to studentsko mjesto refundira; lekcija se nastavlja za sve ostale (podložno vašem pravilu minimalnih mjesta).
Odbacuje ponavljajuće pojavljivanje	To pojedinačno pojavljivanje se preskače (povrat ili gubitak prema pravilu otkazivanja). Ostatak serije je netaknut.
Preusmjerava pozivnicu na drugu poštu	Nema utjecaja na lekciju — Voilà je izvor istine, i preusmjeravanje pozivnice ne pomiče lekciju niti ponovno izdaje povrate.

Ukratko: studenti mogu upravljati svojim sudjelovanjem potpuno iz svoje kalendarske pozivnice, i vidjet ćete svaku akciju odraženu na Voilà strani u roku od sekundi.

Grupne lekcije putem kalendara

Grupne lekcije dodaju jednu dodatnu komplikaciju — pravilo minimalnih mjesta:

• Jedan član odbacuje → to mjesto se refundira, sudionik se uklanja iz kalendarskog događaja, lekcija se nastavlja.
• Odbacivanje spušta lekciju ispod min_seats PRIJE roka otkazivanja → cijela lekcija se otkazuje, svako plaćeno mjesto se refundira, kalendarski događaj se uklanja.
• Odbacivanje spušta lekciju ispod min_seats NAKON roka otkazivanja → lekcija ostaje (ljudi koji su zadržali svoje mjesto već su platili za slot), i primate email s obavijesti tako da možete odlučiti kako to riješiti.

Ponavljajuće lekcije putem kalendara

Ponavljajuće lekcije se pohranjuju različito na svakom pružatelju, ali iskustvo je isto:

• Google: serija je jedan glavni ponavljajući događaj. Odbacivanje jedne instance iz kalendara preskače samo to pojavljivanje u Voilà; odbacivanje glavnog otkazuje svako buduće pojavljivanje.
• Outlook: svako pojavljivanje je povezano pojedinačno tako da ažuriranja po instanci iz Microsoft Graph teku glatko. Odbacivanje jednog pojavljivanja ga preskače u Voilà; odbacivanje serije završava buduća pojavljivanja.
• Preskakanje pojavljivanja iz Voilà automatski otkazuje odgovarajuću kalendarsku instancu s čistom obavijesti o otkazivanju sudionicima.
• Promjena tutorova pravila otkazivanja se ne primjenjuje retroaktivno na pojavljivanja koja već postoje — svako pojavljivanje zaključava pravilo koje je bilo aktivno kada je kreirano.

Kako se isporučuje sinkronizacija

Voilà koristi push obavijesti (webhooks) kao primarni okidač:

• Google Calendar — Voilà se pretplaćuje na vaš kalendar putem Google events.watch kanala; ažuriranja stižu u roku od sekundi nakon što spremite u Google Calendaru.
• Microsoft Outlook / Teams — Voilà se pretplaćuje putem Microsoft Graph webhooks; isto ponašanje.

Mali skup sigurnosnih mreža održava kanal zdravim:

• Satni posao održavanja obnavlja pretplate prije nego što isteknu i pokreće sve nedostajuće praćenja.
• Popunjavanje pri povezivanju gura postojeće buduće Voilà lekcije na vaš novi kalendar (i uvozi vaša postojeća zauzeta vremena kalendara).
• Ručno osvježavanje je dostupno sa stranice Raspored — korisno ako testirate ili ako webhook kratko propusti dostavu.

Ranije verzije ove stranice spominjale su "5-minutni ciklus ankete". To više nije točno — sinkronizacija je bazirana na push i obično stiže u manje od 30 sekundi.

Pravilo otkazivanja i povrati putem kalendara

Otkazivanja sa strane kalendara slijede točno isto pravilo otkazivanja koje ste konfigurirali za rezervacije plaćene Stripe-om (vidi Stripe Connect Plaćanja):

• Vi otkažete (obriši/otkaži iz vašeg kalendara): studentu se potpuno refundira, bez obzira na vrijeme.
• Student odbacuje iz svog kalendara prije roka: puni povrat ili vraćanje kredita studentu.
• Student odbacuje iz svog kalendara nakon roka: plaćanje se gubi (zadržavate ga) ili se kredit sesije troši.
• Grupne lekcije: povrati po mjestu za pojedinačna odbacivanja; puni povrat svakog plaćenog mjesta ako tutor otkaže ili pad ispod min_seats prije roka otkazuje lekciju.

Privatnost i opseg

• Voilà čita i piše događaje samo na kalendaru koji povežete — nikad na bilo kojim drugim kalendarima na vašem računu.
• Događaji koje Voilà čita koriste se isključivo za raspored i kalkulacije dostupnosti.
• Možete opozvati pristup bilo kada pod Postavke → Integracije (ili direktno iz postavki vašeg Google / Microsoft računa).

Rješavanje problema

Token je istekao

Ako se sinkronizacija zaustavi, OAuth token je vjerojatno istekao. Otvorite Postavke → Integracije i kliknite Ponovno povežite.

Kašnjenja sinkronizacije

Webhooks obično dostavljaju u roku od ~30 sekundi. Satni posao održavanja je sigurnosna mreža koja obnavlja pretplate i ponovno sinkronizira bilo koju dostavu koja je kratko neuspjela. Također možete pokrenuti ručno osvježavanje sa stranice Raspored.

Konflikti s ne-Voilà događajima

Ako pokušate potvrditi Voilà rezervaciju na slotu koji pokriva ne-Voilà događaj na vašem kalendaru, Voilà će vas upozoriti i pustiti da nadjačate konflikt — korisno kada je kalendarski događaj "meko" zadržavanje koje ste sretni otpustiti.

Prebacivanje pružatelja

Samo jedan kalendar može biti povezan u isto vrijeme. Prekinite vezu s Google prije povezivanja Outlook (ili obrnuto) pod Postavke → Integracije.

Dvosmjerni sinkron, od početka do kraja

sequenceDiagram
    participant Student
    participant StudentCal as "Studentski kalendar"
    participant Voila
    participant TutorCal as "Tutorov kalendar (Google ili Outlook)"
    participant Tutor

    Note over Voila,TutorCal: Lekcija potvrđena u Voilà
    Voila->>TutorCal: Kreiraj događaj s Meet ili Teams linkom
    TutorCal-->>Student: Pozivnica dostavljena
    TutorCal-->>StudentCal: Pozivnica dostavljena

    Note over Student,StudentCal: Student odbacuje iz pošte
    StudentCal->>TutorCal: RSVP odbačen
    TutorCal->>Voila: Webhook se pokreće
    Voila->>Voila: Pokreni pravilo otkazivanja
    Voila-->>Tutor: Obavijest u aplikaciji i emailom
    Voila-->>Student: Potvrda povrata ili gubitka

    Note over Tutor,TutorCal: Tutor otkazuje događaj
    TutorCal->>Voila: Webhook se pokreće
    Voila->>Voila: Otkaži i refundiraj
    Voila->>StudentCal: Kalendarski događaj uklonjen

Povezano

• Raspored — tjedna dostupnost, pravila rezervacije, način odmora
• Grupne lekcije — minimalna mjesta, upravljanje članovima, ponašanje grupnog otkazivanja
• Stripe Connect Plaćanja — pravila otkazivanja i kako se primjenjuju povrati