Integrácia kalendára

Pripojte raz, spravujte všade. Keď pripojíte Google Calendar alebo Microsoft Outlook (Teams), vaše Voilà lekcie sa zobrazia vo vašom kalendári presne ako akékoľvek iné stretnutie — a čokoľvek urobíte s udalosťou vo vašom kalendári sa automaticky prenesie späť do Voilà. Preložte, zrušte, prijmite, odmietnte — obe strany zostanú synchronizované do niekoľkých sekúnd.

Táto stránka je napísaná pre lektorov. Sekcia "Čo zažívajú vaši študenti" presne vysvetľuje, čo vaši študenti vidia na svojej strane, takže môžete sebavedomne riadiť celý svoj rozvrh z kalendára.

Podporovaní poskytovatelia

Poskytovateľ	Video odkaz automaticky pripojený	Čo sa vytvorí
Google Calendar	Google Meet	Jedna udalosť na lekciu, hlavná udalosť na opakujúcu sa sériu
Microsoft Outlook / Teams	Microsoft Teams	Jedna udalosť na lekciu, jedna udalosť na každý opakujúci sa výskyt

Môžete pripojiť jedného poskytovateľa kalendára naraz. Na prepnutie najprv odpojte aktuálneho v Nastavenia → Integrácie.

Pripojenie Google Calendar

1. Prejdite na Nastavenia → Integrácie, alebo Plánovanie → Pripojiť Google Calendar.
2. Kliknite na Pripojiť Google Calendar.
3. Prihláste sa svojím Google účtom a autorizujte Voilà na čítanie a zapisovanie udalostí.
4. Váš kalendár sa začne synchronizovať okamžite.

Čo sa stane v momente pripojenia: každá potvrdená budúca Voilà lekcia sa presunie do vašeho Google Calendar — každá s Google Meet odkazom, vopred vyplnenými účastníkmi a telom "Rezervované cez Voilà". Nie je potrebné robiť nič iné.

Pripojenie Microsoft Outlook / Teams

1. Prejdite na Nastavenia → Integrácie, alebo Plánovanie → Pripojiť Outlook Calendar.
2. Kliknite na Pripojiť Outlook Calendar.
3. Prihláste sa svojím Microsoft účtom a autorizujte Voilà na čítanie a zapisovanie udalostí.
4. Váš kalendár sa začne synchronizovať okamžite.

Každá lekcia sa zobrazí vo vašom Outlook kalendári ako Teams stretnutie (odkaz na pripojenie sa pripojí automaticky), so študentom uvedeným ako účastník. Platí rovnaké správanie spätného dopĺňania: budúce Voilà lekcie sa zobrazia vo vašom Outlook kalendári okamžite.

Čo sa zobrazí vo vašom kalendári (Voilà → kalendár)

Voilà udalosť	Čo vidíte v kalendári
1:1 rezervácia je potvrdená	Pozvánka v čase lekcie, s Meet/Teams odkazom, študentom ako účastníkom a telom napísaným Voilà.
Skupinová lekcia sa potvrdí	Rovnaká udalosť, s každým prijatým členom na zozname účastníkov. Keď viac členov prijme, pridajú sa; ak člen odpadne, odstráni sa.
Vytvorí sa opakujúca sa lekcia	Google: jedna hlavná opakujúca sa udalosť pokrývajúca celú sériu. Outlook: jedna udalosť na výskyt (takže aktualizácie jednotlivých inštancií plynule prechádzajú cez Microsoft Graph).
Preloženie je prijaté vo Voilà	Čas začiatku/konca pozvánky sa aktualizuje na mieste a účastníci dostanú oznámenie o aktualizácii. Funguje na Google aj Outlook.
Lekcia je zrušená vo Voilà	Kalendárová udalosť sa odstráni a účastníci sú upozornení oznámením o zrušení. Funguje na Google aj Outlook.
Opakujúci sa výskyt je preskočený vo Voilà	Iba ten jeden výskyt sa zruší — zvyšok série zostane nedotknutý.

Čo sa synchronizuje späť do Voilà (kalendár → Voilà)

Toto je sekcia, ktorá vám umožňuje "žiť vo vašom kalendári". Čokoľvek nižšie automaticky mení stav Voilà.

Presuniete čas udalosti

Pretiahnutie Voilà udalosti na iný slot alebo úprava jej začiatku/konca otvorí návrh preloženia vo Voilà. Keď študent potvrdí (v aplikácii alebo odpovedaním na email), čas udalosti sa uzamkne v oboch systémoch. Dovtedy udalosť sedí ako čakajúci návrh — študent ju stále môže vidieť a prijať/odmietnuť vo Voilà.

Odstránite alebo zrušíte udalosť

Voilà označí lekciu ako zrušenú a spustí vetvu zrušenia lektorom zrušovacích podmienok:

• Študentovi sa vráti celá platba (ak Stripe) alebo sa mu vráti kredit za lekciu (ak balík lekcií), bez ohľadu na to, či sa zrušenie stalo pred alebo po limite. Zrušenia pripísané lektorovi vždy urobia študenta celým.
• Pre skupinové lekcie sa refunduje každé platené miesto.
• Študent dostane email o zrušení a aktualizáciu chat karty.

Vytvoríte novú udalosť s jedným z vašich študentov ako účastníkom

Ak existuje aktívny vzťah študent–lektor medzi vami, Voilà:

• Automaticky vytvorí návrh rezervácie pre túto lekciu.
• Pošle email študentovi, aby mohol potvrdiť čas.
• Podrží slot vo vašej dostupnosti, kým návrh čaká.

Ak účastník nie je váš známy študent, Voilà zaznamená udalosť ako bežný zaneprázdnený blok vo vašej dostupnosti — ale nevytvorí rezerváciu.

Pridáte akúkoľvek inú udalosť do kalendára

Akákoľvek udalosť, ktorú pridáte — pracovné stretnutia, návšteva zubára, obed s priateľom — sa považuje za zaneprázdnený čas a blokuje nové rezervácie študentov počas tohto okna. Nemusíte robiť nič; toto je automatické.

Čo zažívajú vaši študenti

Kedykoľvek sa lekcia potvrdí, váš študent dostane pozvánku do kalendára na tú istú udalosť — s Meet alebo Teams odkazom na pripojenie vnútri. Takže môžu spravovať lekciu aj zo svojho vlastného kalendára. Tu je presne to, ako Voilà reaguje na každú vec, ktorú študent môže urobiť zo svojej pošty alebo kalendárovej aplikácie:

Akcia študenta	Čo Voilà robí
Prijme pozvánku	Nič navyše — už sú na lekcii. Ich RSVP sa zaznamená pre viditeľnosť.
Odmietne čakajúci návrh zo svojho kalendára	Návrh sa odmietne vo Voilà. Ste upozornený emailom a chatom.
Odmietne potvrdenú 1:1 lekciu zo svojho kalendára	Voilà spustí vetvu zrušenia študentom zrušovacích podmienok. Pred limitom = plná refundácia alebo vrátenie kreditu; po limite = prepadnutie (platbu si ponecháte).
Odmietne potvrdenú skupinovú lekciu	Iba miesto toho študenta sa refunduje; lekcia pokračuje pre všetkých ostatných (podľa vášho pravidla minimálnych miest).
Odmietne opakujúci sa výskyt	Ten jeden výskyt sa preskočí (refundácia alebo prepadnutie podľa zrušovacích podmienok). Zvyšok série zostane nedotknutý.
Prepošle pozvánku na inú schránku	Žiadny vplyv na lekciu — Voilà je zdrojom pravdy a preposielanie pozvánky nepresúva lekciu ani nevydáva refundácie.

Stručne: študenti môžu spravovať svoju účasť úplne zo svojej kalendárovej pozvánky a každú akciu uvidíte odrazenú na strane Voilà do niekoľkých sekúnd.

Skupinové lekcie cez kalendár

Skupinové lekcie pridávajú jednu extra komplikáciu — pravidlo minimálnych miest:

• Jeden člen odmietne → to miesto sa refunduje, účastník sa odstráni z kalendárovej udalosti, lekcia pokračuje.
• Odmietnutie zníži lekciu pod min_seats PRED limitom zrušenia → celá lekcia sa zruší, každé platené miesto sa refunduje, kalendárová udalosť sa odstráni.
• Odmietnutie zníži lekciu pod min_seats PO limite zrušenia → lekcia zostáva (ľudia, ktorí si podržali miesto, už za slot zaplatili) a dostanete upozorňujúci email, takže môžete rozhodnúť, ako to riešiť.

Opakujúce sa lekcie cez kalendár

Opakujúce sa lekcie sa ukladajú odlišne u každého poskytovateľa, ale zážitok je rovnaký:

• Google: séria je jedna hlavná opakujúca sa udalosť. Odmietnutie jednej inštancie z kalendára preskočí iba ten výskyt vo Voilà; odmietnutie hlavnej zruší každý budúci výskyt.
• Outlook: každý výskyt je prepojený individuálne, takže aktualizácie jednotlivých inštancií z Microsoft Graph plynule prechádzajú. Odmietnutie jedného výskytu ho preskočí vo Voilà; odmietnutie série ukončí budúce výskyty.
• Preskočenie výskytu z Voilà automaticky zruší zodpovedajúcu kalendárovú inštanciu s čistým oznámením o zrušení účastníkom.
• Zmena zrušovacích podmienok lektora sa neuplatňuje retroaktívne na výskyty, ktoré už existujú — každý výskyt si uzamkne podmienky, ktoré boli aktívne, keď bol vytvorený.

Ako sa doručuje synchronizácia

Voilà používa push notifikácie (webhooks) ako primárny spúšťač:

• Google Calendar — Voilà sa prihlási na odber vašeho kalendára cez Google events.watch kanál; aktualizácie prichádzajú do niekoľkých sekúnd od uloženia v Google Calendar.
• Microsoft Outlook / Teams — Voilà sa prihlási na odber cez Microsoft Graph webhooks; rovnaké správanie.

Malá sada bezpečnostných sietí udržuje kanál zdravý:

• Hodinová údržbová úloha obnovuje odbery pred ich vypršaním a bootstrapuje akékoľvek chýbajúce sledovania.
• Spätné dopĺňanie pri pripojení presúva existujúce budúce Voilà lekcie do vašeho nového kalendára (a spätne importuje vaše existujúce zaneprázdnené časy kalendára).
• Manuálne obnovenie je dostupné zo stránky Plánovanie — užitočné ak testujete alebo ak webhook krátko zmeškal doručenie.

Skoršie verzie tejto stránky spomínali "5-minútový cyklus dotazovania". To už nie je presné — synchronizácia je založená na push a typicky prichádza za menej ako 30 sekúnd.

Zrušovacie podmienky a refundácie cez kalendár

Zrušenia na strane kalendára nasledujú presne tie isté zrušovacie podmienky, ktoré ste nakonfigurovali pre Stripe-platené rezervácie (pozri Stripe Connect Platby):

• Zrušíte vy (odstránite/zrušíte zo svojho kalendára): študentovi sa plne refunduje, bez ohľadu na načasovanie.
• Študent odmietne zo svojho kalendára pred limitom: plná refundácia alebo vrátenie kreditu študentovi.
• Študent odmietne zo svojho kalendára po limite: platba prepadne (ponecháte si ju) alebo sa spotrebuje kredit za lekciu.
• Skupinové lekcie: refundácie za miesto pre individuálne odmietnutia; plná refundácia každého plateného miesta ak zrušenie lektorom alebo pokles pod min_seats pred limitom zruší lekciu.

Súkromie a rozsah

• Voilà číta a zapisuje udalosti iba v kalendári, ktorý pripojíte — nikdy v žiadnych iných kalendároch na vašom účte.
• Udalosti, ktoré Voilà číta, sa používajú výlučne na plánovanie a výpočty dostupnosti.
• Prístup môžete kedykoľvek odvolať v Nastavenia → Integrácie (alebo priamo z nastavení vašeho Google / Microsoft účtu).

Riešenie problémov

Token vypršal

Ak sa synchronizácia zastaví, OAuth token pravdepodobne vypršal. Otvorte Nastavenia → Integrácie a kliknite na Znovu pripojiť.

Oneskorenia synchronizácie

Webhooks sa obvykle doručujú do ~30 sekúnd. Hodinová údržbová úloha je bezpečnostná sieť, ktorá obnovuje odbery a znovu synchronizuje akékoľvek doručenie, ktoré krátko zlyhalo. Môžete tiež spustiť manuálne obnovenie zo stránky Plánovanie.

Konflikty s ne-Voilà udalosťami

Ak sa pokúsite potvrdiť Voilà rezerváciu na slot, ktorý je pokrytý ne-Voilà udalosťou vo vašom kalendári, Voilà vás upozorní a umožní vám konflikt prepísať — užitočné, keď kalendárová udalosť je "mäkké" podržanie, ktoré ste ochotní uvoľniť.

Prepínanie poskytovateľov

Iba jeden kalendár môže byť pripojený naraz. Odpojte Google pred pripojením Outlook (alebo naopak) v Nastavenia → Integrácie.

Obojsmerná synchronizácia, end-to-end

sequenceDiagram
    participant Student
    participant StudentCal as "Kalendár študenta"
    participant Voila
    participant TutorCal as "Kalendár lektora (Google alebo Outlook)"
    participant Tutor

    Note over Voila,TutorCal: Lekcia potvrdená vo Voilà
    Voila->>TutorCal: Vytvorí udalosť s Meet alebo Teams odkazom
    TutorCal-->>Student: Pozvánka doručená
    TutorCal-->>StudentCal: Pozvánka doručená

    Note over Student,StudentCal: Študent odmietne zo schránky
    StudentCal->>TutorCal: RSVP odmietnuté
    TutorCal->>Voila: Webhook sa spustí
    Voila->>Voila: Spustí zrušovacie podmienky
    Voila-->>Tutor: Oznámenie v aplikácii a emailom
    Voila-->>Student: Potvrdenie refundácie alebo prepadnutia

    Note over Tutor,TutorCal: Lektor zruší udalosť
    TutorCal->>Voila: Webhook sa spustí
    Voila->>Voila: Zruší a refunduje
    Voila->>StudentCal: Kalendárová udalosť odstránená

Súvisiace

• Plánovanie — týždenná dostupnosť, rezervačné podmienky, režim dovolenky
• Skupinové lekcie — minimálne miesta, správa členov, správanie zrušenia skupiny
• Stripe Connect Platby — zrušovacie podmienky a ako sa uplatňujú refundácie