Integrácia kalendára

Prepoj raz, spravuj odkiaľkoľvek. Keď prepojíš Google Calendar alebo Microsoft Outlook (Teams), tvoje lekcie Voilà sa zobrazia v kalendári presne ako každé iné stretnutie — a všetko, čo s udalosťou urobíš v kalendári, sa automaticky prenesie späť do Voilà. Presuň, zruš, prijmi, odmietni — obe strany zostanú synchronizované v priebehu sekúnd.

Táto stránka je určená pre lektorov. Sekcia „Čo vidia tvoji študenti" presne vysvetľuje, čo vidia tvoji študenti na svojej strane, aby si mohol/mohla s istotou spravovať celý rozvrh priamo z kalendára.

Podporovaní poskytovatelia

Poskytovateľ	Automaticky priložený video odkaz	Čo sa vytvorí
Google Calendar	Google Meet	Jedna udalosť na lekciu, hlavná udalosť pre opakujúcu sa sériu
Microsoft Outlook / Teams	Microsoft Teams	Jedna udalosť na lekciu, jedna udalosť na každý výskyt opakovania

Naraz môžeš prepojiť jedného poskytovateľa kalendára. Ak chceš prepnúť, najprv odpoj aktuálneho v časti Nastavenia → Integrácie.

Prepojenie Google Calendar

1. Prejdi do Nastavenia → Integrácie alebo Rozvrhovanie → Prepojiť Google Calendar.
2. Klikni na Prepojiť Google Calendar.
3. Prihlás sa pomocou svojho účtu Google a povol Voilà čítať a zapisovať udalosti.
4. Kalendár sa začne okamžite synchronizovať.

Čo sa stane v momente prepojenia: každá potvrdená budúca lekcia Voilà sa prenesie do tvojho Google Calendar — každá s odkazom na Google Meet, vopred vyplnenými účastníkmi a telom správy „Rezervované cez Voilà". Nemusíš robiť nič iné.

Prepojenie Microsoft Outlook / Teams

1. Prejdi do Nastavenia → Integrácie alebo Rozvrhovanie → Prepojiť Outlook Calendar.
2. Klikni na Prepojiť Outlook Calendar.
3. Prihlás sa pomocou svojho účtu Microsoft a povol Voilà čítať a zapisovať udalosti.
4. Kalendár sa začne okamžite synchronizovať.

Každá lekcia sa zobrazí v tvojom Outlook kalendári ako Teams stretnutie (odkaz na pripojenie sa priloží automaticky) a študent je uvedený ako účastník. Rovnaké správanie pri spätnom naplnení platí aj tu: budúce lekcie Voilà sa okamžite zobrazia v tvojom Outlook kalendári.

Čo sa zobrazí v tvojom kalendári (Voilà → kalendár)

Udalosť vo Voilà	Čo vidíš v kalendári
Potvrdená individuálna rezervácia	Pozvánka v čase lekcie s odkazom Meet/Teams, študentom ako účastníkom a telom správy od Voilà.
Potvrdená skupinová lekcia	Rovnaká udalosť so všetkými prijatými členmi v zozname účastníkov. Keď ďalší členovia prijmú, sú pridaní; ak člen odíde, je odstránený.
Vytvorená opakujúca sa lekcia	Google: jedna hlavná opakujúca sa udalosť pokrývajúca celú sériu. Outlook: jedna udalosť na každý výskyt (aby aktualizácie jednotlivých výskytov plynulo prechádzali cez Microsoft Graph).
Presunutie lekcie potvrdené vo Voilà	Čas začiatku/konca pozvánky sa aktualizuje na mieste a účastníci dostanú upozornenie o zmene. Funguje pre Google aj Outlook.
Lekcia zrušená vo Voilà	Udalosť v kalendári sa odstráni a účastníci dostanú upozornenie o zrušení. Funguje pre Google aj Outlook.
Preskočenie výskytu opakujúcej sa lekcie vo Voilà	Zruší sa len daný výskyt — zvyšok série zostane nedotknutý.

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

Táto sekcia ti umožňuje „žiť v kalendári". Čokoľvek nižšie automaticky zmení stav vo Voilà.

Presunieš čas udalosti

Pretiahnutie udalosti Voilà na iný slot alebo úprava jej začiatku/konca otvorí vo Voilà návrh na presunutie. Keď to študent potvrdí (v aplikácii alebo odpoveďou na e-mail), čas udalosti sa uzamkne v oboch systémoch. Dovtedy udalosť zostáva ako čakajúci návrh — študent ho môže stále vidieť a prijať/odmietnuť priamo vo Voilà.

Udalosť vymažeš alebo zrušíš

Voilà označí lekciu ako zrušenú a spustí vetvu zrušenia lektorom v rámci storno podmienok:

• Študentovi sa vráti celá platba (ak ide o Stripe) alebo mu bude vrátený kredit na lekciu (ak ide o balík lekcií), bez ohľadu na to, či k zrušeniu došlo pred alebo po termíne. Zrušenia pripisované lektorovi vždy plne odškodnia študenta.
• Pri skupinových lekciách sa refunduje každé zaplatené miesto.
• Študent dostane e-mail o zrušení a aktualizáciu v chate.

Vytvoríš novú udalosť s jedným zo svojich študentov ako účastníkom

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

• Automaticky vytvorí návrh rezervácie pre danú lekciu.
• Pošle študentovi e-mail, aby mohol potvrdiť čas.
• Zarezervuje slot vo tvojej dostupnosti, kým návrh čaká na potvrdenie.

Ak účastník nie je tvojím známym študentom, Voilà zaznamená udalosť ako bežný blok zaneprázdnenosti vo tvojej dostupnosti — ale nevytvorí rezerváciu.

Do kalendára pridáš akúkoľvek inú udalosť

Každá udalosť, ktorú pridáš — pracovné stretnutia, návšteva zubára, obed s priateľom — sa považuje za čas zaneprázdnenosti a blokuje nové rezervácie študentov počas daného okna. Nemusíš robiť nič; je to automatické.

Čo vidia tvoji študenti

Vždy, keď je lekcia potvrdená, tvoj študent dostane pozvánku do kalendára na tú istú udalosť — s odkazom na pripojenie cez Meet alebo Teams. Takže aj oni môžu spravovať lekciu zo svojho vlastného kalendára. Tu je presný prehľad toho, ako Voilà reaguje na každú akciu, ktorú môže študent vykonať zo svojej schránky alebo aplikácie kalendára:

Akcia študenta	Čo Voilà urobí
Prijme pozvánku	Nič navyše — je už na lekcii. Jeho/jej RSVP sa zaznamená pre prehľad.
Odmietne čakajúci návrh zo svojho kalendára	Návrh sa odmietne vo Voilà. Dostaneš upozornenie e-mailom a v chate.
Odmietne potvrdenú individuálnu lekciu zo svojho kalendára	Voilà spustí vetvu zrušenia študentom v rámci storno podmienok. Pred termínom = plná refundácia alebo vrátenie kreditu; po termíne = prepadnutie (platbu si ponecháš).
Odmietne z potvrdenej skupinovej lekcie	Refunduje sa len miesto daného študenta; lekcia pokračuje pre ostatných (podľa pravidla minimálneho počtu miest).
Odmietne opakujúci sa výskyt	Daný výskyt sa preskočí (refundácia alebo prepadnutie podľa storno podmienok). Zvyšok série zostane nedotknutý.
Prepošle pozvánku do inej schránky	Nemá žiadny vplyv na lekciu — Voilà je zdrojom pravdy a preposlanie pozvánky lekciu nepresúva ani nevydáva refundácie.

Stručne povedané: študenti môžu spravovať svoju účasť úplne z pozvánky v kalendári a ty uvidíš každú akciu odrazenú na strane Voilà v priebehu sekúnd.

Skupinové lekcie cez kalendár

Skupinové lekcie pridávajú jednu ďalšiu komplikáciu — pravidlo minimálneho počtu miest:

• Jeden člen odmietne → dané miesto sa refunduje, účastník sa odstráni z udalosti v kalendári, lekcia pokračuje.
• Odmietnutie zníži počet pod min_seats PRED termínom zrušenia → celá lekcia sa zruší, každé zaplatené miesto sa refunduje, udalosť v kalendári sa odstráni.
• Odmietnutie zníži počet pod min_seats PO termíne zrušenia → lekcia pokračuje (tí, ktorí si miesto podržali, za slot už zaplatili) a dostaneš upozorňujúci e-mail, aby si sa mohol/mohla rozhodnúť, ako to riešiť.

Opakujúce sa lekcie cez kalendár

Opakujúce sa lekcie sú uložené odlišne u každého poskytovateľa, ale skúsenosť je rovnaká:

• Google: séria je jedna hlavná opakujúca sa udalosť. Odmietnutie jedného výskytu z kalendára preskočí len daný výskyt vo Voilà; odmietnutie hlavnej udalosti zruší každý budúci výskyt.
• Outlook: každý výskyt je prepojený individuálne, takže aktualizácie jednotlivých výskytov z Microsoft Graph prechádzajú čisto. Odmietnutie jedného výskytu ho preskočí vo Voilà; odmietnutie série ukončí budúce výskyty.
• Preskočenie výskytu priamo vo Voilà automaticky zruší zodpovedajúci výskyt v kalendári s čistým upozornením o zrušení pre účastníkov.
• Zmena storno podmienok lektora sa retroaktívne neuplatňuje na výskyty, ktoré už existujú — každý výskyt si uzamkne podmienky, ktoré boli aktívne v čase jeho vytvorenia.

Ako funguje synchronizácia

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

• Google Calendar — Voilà sa prihlási na odber tvojho kalendára cez kanál events.watch od Googlu; aktualizácie dorazí v priebehu sekúnd od uloženia v Google Calendar.
• Microsoft Outlook / Teams — Voilà sa prihlási na odber cez webhooky Microsoft Graph; rovnaké správanie.

Malá sada záchranných sietí udržiava kanál v zdravom stave:

• Hodinová údržbová úloha obnovuje odbery pred ich vypršaním a bootstrapuje chýbajúce sledovania.
• Spätné naplnenie pri prepojení prenesie existujúce budúce lekcie Voilà do tvojho nového kalendára (a spätne importuje existujúce časy zaneprázdnenosti z tvojho kalendára).
• Manuálne obnovenie je dostupné na stránke Rozvrhovanie — užitočné pri testovaní alebo ak webhook krátko zmeškal doručenie.

Staršie verzie tejto stránky uvádzali „5-minútový cyklus pollingu". To už nie je presné — synchronizácia je push-based a zvyčajne prebehne za menej ako 30 sekúnd.

Storno podmienky a refundácie cez kalendár

Zrušenia na strane kalendára sa riadia presne tými istými storno podmienkami, ktoré si nakonfiguroval/nakonfigurovala pre rezervácie platené cez Stripe (pozri Platby cez Stripe Connect):

• Ty zrušíš (vymažeš/zrušíš z kalendára): študentovi sa plne refunduje, bez ohľadu na načasovanie.
• Študent odmietne z kalendára pred termínom: plná refundácia alebo vrátenie kreditu študentovi.
• Študent odmietne z kalendára po termíne: platba prepadne (ponecháš si ju) alebo sa kredit na lekciu spotrebuje.
• Skupinové lekcie: refundácia za jednotlivé miesta pri individuálnych odmietnutiach; plná refundácia každého zaplateného miesta, ak lekciu zruší lektor alebo ak pokles pod min_seats pred termínom zruší lekciu.

Súkromie a rozsah oprávnení

• Voilà číta a zapisuje udalosti len v kalendári, ktorý prepojíš — nikdy v iných kalendároch na tvojom účte.
• Udalosti, ktoré Voilà číta, sa používajú výlučne na účely rozvrhovania a výpočtu dostupnosti.
• Prístup môžeš kedykoľvek odvolať v časti Nastavenia → Integrácie (alebo priamo v nastaveniach svojho účtu Google / Microsoft).

Riešenie problémov

Vypršaný token

Ak sa synchronizácia zastaví, OAuth token pravdepodobne vypršal. Otvor Nastavenia → Integrácie a klikni na Znovu prepojiť.

Oneskorenia synchronizácie

Webhooky zvyčajne doručia do ~30 sekúnd. Hodinová údržbová úloha je záchranná sieť, ktorá obnovuje odbery a znovu synchronizuje každé doručenie, ktoré krátko zlyhalo. Manuálne obnovenie môžeš spustiť aj zo stránky Rozvrhovanie.

Konflikty s udalosťami mimo Voilà

Ak sa pokúsiš potvrdiť rezerváciu Voilà na slot, ktorý je pokrytý udalosťou mimo Voilà v tvojom kalendári, Voilà ťa upozorní a umožní ti konflikt prepísať — užitočné, keď je udalosť v kalendári „mäkkou" rezerváciou, ktorú si ochotný/ochotná uvoľniť.

Prepínanie poskytovateľov

Naraz môže byť prepojený len jeden kalendár. Odpoj Google pred prepojením Outlooku (alebo naopak) v časti Nastavenia → Integrácie.

Obojsmerná synchronizácia, od začiatku do konca

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

Súvisiace

• Rozvrhovanie — týždenná dostupnosť, rezervačné podmienky, režim dovolenky
• Skupinové lekcie — minimálny počet miest, správa členov, správanie pri skupinovom zrušení
• Platby cez Stripe Connect — storno podmienky a spôsob uplatňovania refundácií