Integracja kalendarza

Połącz raz, zarządzaj wszędzie. Po połączeniu Google Calendar lub Microsoft Outlook (Teams) Twoje lekcje Voilà pojawiają się w Twoim kalendarzu dokładnie jak każde inne spotkanie — a wszystko, co zrobisz z wydarzeniem w kalendarzu, automatycznie wraca do Voilà. Przesunięcia, anulowania, akceptacje, odrzucenia — obie strony pozostają zsynchronizowane w ciągu sekund.

Ta strona jest napisana dla korepetytorów. Sekcja "Co widzą Twoi uczniowie" wyjaśnia dokładnie, co Twoi uczniowie widzą po swojej stronie, abyś mógł pewnie zarządzać całym harmonogramem z poziomu kalendarza.

Obsługiwani dostawcy

Dostawca	Link do wideo dołączony automatycznie	Co się tworzy
Google Calendar	Google Meet	Jedno wydarzenie na lekcję, główne wydarzenie na serię powtarzającą się
Microsoft Outlook / Teams	Microsoft Teams	Jedno wydarzenie na lekcję, jedno wydarzenie na każde powtórzenie

Możesz połączyć jeden dostawca kalendarza na raz. Aby przełączyć się, najpierw rozłącz obecny w Ustawienia → Integracje.

Łączenie Google Calendar

1. Przejdź do Ustawienia → Integracje lub Planowanie → Połącz Google Calendar.
2. Kliknij Połącz Google Calendar.
3. Zaloguj się na swoje konto Google i autoryzuj Voilà do odczytywania i zapisywania wydarzeń.
4. Twój kalendarz zaczyna się synchronizować natychmiast.

Co się dzieje w momencie połączenia: każda potwierdzona przyszła lekcja Voilà jest wysyłana do Twojego Google Calendar — każda z linkiem Google Meet, wstępnie wypełnionymi uczestnikami i treścią "Zarezerwowano przez Voilà". Nie musisz nic więcej robić.

Łączenie Microsoft Outlook / Teams

1. Przejdź do Ustawienia → Integracje lub Planowanie → Połącz Outlook Calendar.
2. Kliknij Połącz Outlook Calendar.
3. Zaloguj się na swoje konto Microsoft i autoryzuj Voilà do odczytywania i zapisywania wydarzeń.
4. Twój kalendarz zaczyna się synchronizować natychmiast.

Każda lekcja pojawia się w Twoim kalendarzu Outlook jako spotkanie Teams (link do dołączenia jest dołączany automatycznie), z uczniem na liście uczestników. Obowiązuje to samo zachowanie wstecznego wypełniania: przyszłe lekcje Voilà pojawiają się w Twoim kalendarzu Outlook natychmiast.

Co pojawia się w Twoim kalendarzu (Voilà → kalendarz)

Wydarzenie Voilà	Co widzisz w kalendarzu
Rezerwacja 1:1 jest potwierdzona	Zaproszenie na czas lekcji, z linkiem Meet/Teams, uczniem na liście uczestników i treścią napisaną przez Voilà.
Lekcja grupowa jest potwierdzona	To samo wydarzenie, ze wszystkimi zaakceptowanymi członkami na liście uczestników. W miarę jak więcej członków akceptuje, są dodawani; jeśli członek się wycofuje, są usuwani.
Lekcja powtarzająca się jest tworzona	Google: jedno główne powtarzające się wydarzenie obejmujące całą serię. Outlook: jedno wydarzenie na każde powtórzenie (dzięki czemu aktualizacje dla poszczególnych instancji przepływają czyszczej przez Microsoft Graph).
Przesunięcie jest zaakceptowane w Voilà	Czas rozpoczęcia/zakończenia zaproszenia jest aktualizowany na miejscu i uczestnicy otrzymują powiadomienie o aktualizacji. Działa zarówno w Google, jak i Outlook.
Lekcja jest anulowana w Voilà	Wydarzenie w kalendarzu jest usuwane i uczestnicy są powiadamiani o anulowaniu. Działa zarówno w Google, jak i Outlook.
Powtórzenie lekcji jest pominięte w Voilà	Tylko to jedno powtórzenie jest anulowane — reszta serii pozostaje nienaruszona.

Co synchronizuje się z powrotem do Voilà (kalendarz → Voilà)

Ta sekcja pozwala Ci "żyć w swoim kalendarzu". Wszystko poniżej zmienia stan Voilà automatycznie.

Przesuwasz czas wydarzenia

Przeciągnięcie wydarzenia Voilà do innego slotu lub edycja jego czasu rozpoczęcia/zakończenia otwiera propozycję przesunięcia w Voilà. Po potwierdzeniu przez ucznia (w aplikacji lub odpowiadając na e-mail), czas wydarzenia jest zablokowany w obu systemach. Do tego czasu wydarzenie pozostaje jako oczekująca propozycja — uczeń może ją nadal widzieć i zaakceptować/odrzucić z poziomu Voilà.

Usuwasz lub anulujesz wydarzenie

Voilà oznacza lekcję jako anulowaną i uruchamia gałąź anulowania przez korepetytora polityki anulowania:

• Uczeń otrzymuje pełny zwrot płatności (jeśli Stripe) lub ma zwrócony kredyt sesji (jeśli pakiet sesji), niezależnie od tego, czy anulowanie nastąpiło przed czy po terminie. Anulowania przypisane korepetytorowi zawsze wyrównują sytuację ucznia.
• W przypadku lekcji grupowych każde opłacone miejsce jest zwracane.
• Uczeń otrzymuje e-mail o anulowaniu i aktualizację karty czatu.

Tworzysz nowe wydarzenie z jednym ze swoich uczniów jako uczestnikiem

Jeśli istnieje aktywna relacja uczeń–korepetytora między Tobą, Voilà będzie:

• Auto-tworzyć propozycję rezerwacji dla tej lekcji.
• Wysłać e-mail do ucznia, aby mógł potwierdzić czas.
• Zarezerwować slot w Twojej dostępności, podczas gdy propozycja jest oczekująca.

Jeśli uczestnik nie jest znanym uczniem, Voilà rejestruje wydarzenie jako zwykły zajęty blok w Twojej dostępności — ale nie tworzy rezerwacji.

Dodajesz jakiekolwiek inne wydarzenie do kalendarza

Każde wydarzenie, które dodasz — spotkania robocze, wizyty u dentysty, lunch z przyjacielem — jest traktowane jako zajęty czas i blokuje nowe rezerwacje uczniów w tym oknie. Nie musisz nic robić; to jest automatyczne.

Co widzą Twoi uczniowie

Zawsze, gdy lekcja jest potwierdzona, Twój uczeń otrzymuje zaproszenie do kalendarza na to samo wydarzenie — z linkiem do dołączenia Meet lub Teams w środku. Dzięki temu mogą również zarządzać lekcją z własnego kalendarza. Oto dokładnie, jak Voilà reaguje na każdą czynność, którą uczeń może wykonać ze swojej skrzynki odbiorczej lub aplikacji kalendarza:

Działanie ucznia	Co robi Voilà
Akceptuje zaproszenie	Nic dodatkowego — są już na lekcji. Ich RSVP jest rejestrowane dla widoczności.
Odrzuca oczekującą propozycję z kalendarza	Propozycja jest odrzucona w Voilà. Jesteś powiadamiany e-mailem i czatem.
Odrzuca potwierdzoną lekcję 1:1 z kalendarza	Voilà uruchamia gałąź anulowania przez ucznia polityki anulowania. Przed terminem = pełny zwrot lub zwrot kredytu; po terminie = przepadek (zachowujesz płatność).
*Odrzuca z potwierdzonej lekcji grupowej	Tylko miejsce tego ucznia jest zwracane; lekcja trwa dla wszystkich pozostałych (z zastrzeżeniem Twojej reguły minimalnych miejsc).
Odrzuca powtórzenie lekcji	To jedno powtórzenie jest pominięte (zwrot lub przepadek zgodnie z polityką anulowania). Reszta serii pozostaje nienaruszona.
Przekazuje zaproszenie do innej skrzynki odbiorczej	Brak wpływu na lekcję — Voilà jest źródłem prawdy, a przekazanie zaproszenia nie przenosi lekcji ani nie ponownie wystawia zwrotów.

Krótko mówiąc: uczniowie mogą zarządzać swoim udziałem całkowicie z zaproszenia do kalendarza, a Ty zobaczysz każdą akcję odzwierciedloną po stronie Voilà w ciągu sekund.

Lekcje grupowe przez kalendarz

Lekcje grupowe dodają jedno dodatkowe zawiłość — regułę minimalnych miejsc:

• Jeden członek odrzuca → to miejsce jest zwracane, uczestnik jest usuwany z wydarzenia w kalendarzu, lekcja trwa.
• Odrzucenie spada poniżej min_seats PRZED terminem anulowania → cała lekcja jest anulowana, każde opłacone miejsce jest zwracane, wydarzenie w kalendarzu jest usuwane.
• Odrzucenie spada poniżej min_seats PO terminie anulowania → lekcja trwa (osoby, które utrzymały swoje miejsce, już zapłaciły za slot), a Ty otrzymujesz e-mail z powiadomieniem, abyś mógł zdecydować, jak to obsłużyć.

Lekcje powtarzające się przez kalendarz

Lekcje powtarzające się są przechowywane inaczej na każdym dostawcy, ale doświadczenie jest takie samo:

• Google: seria to jedno główne powtarzające się wydarzenie. Odrzucenie jednej instancji z kalendarza pomija tylko to powtórzenie w Voilà; odrzucenie głównego anuluje każde przyszłe powtórzenie.
• Outlook: każde powtórzenie jest połączone indywidualnie, dzięki czemu aktualizacje dla poszczególnych instancji z Microsoft Graph przepływają czyszczej. Odrzucenie jednego powtórzenia pomija je w Voilà; odrzucenie serii kończy przyszłe powtórzenia.
• Pominięcie powtórzenia z poziomu Voilà automatycznie anuluje pasujące wystąpienie w kalendarzu z czystym powiadomieniem o anulowaniu dla uczestników.
• Zmiana polityki anulowania korepetytora nie jest stosowana wstecz do powtórzeń, które już istnieją — każde powtórzenie blokuje politykę, która była aktywna, gdy została utworzona.

Jak synchronizacja jest dostarczana

Voilà używa powiadomień push (webhooks) jako głównego wyzwalacza:

• Google Calendar — Voilà subskrybuje Twój kalendarz za pośrednictwem kanału events.watch Google; aktualizacje przychodzą w ciągu sekund od zapisania w Google Calendar.
• Microsoft Outlook / Teams — Voilà subskrybuje za pośrednictwem webhooków Microsoft Graph; to samo zachowanie.

Mały zestaw sieci bezpieczeństwa utrzymuje kanał w dobrej kondycji:

• Godzinna praca konserwacyjna odnawia subskrypcje przed ich wygaśnięciem i inicjuje wszelkie brakujące obserwacje.
• Wsteczne wypełnianie przy połączeniu wysyła istniejące przyszłe lekcje Voilà do nowego kalendarza (i wstecz importuje Twoje istniejące zajęte czasy w kalendarzu).
• Ręczne odświeżenie jest dostępne ze strony Planowania — przydatne, jeśli testujesz lub jeśli webhook krótko przegapił dostawę.

Wcześniejsze wersje tej strony wspominały o "cyklu sondowania co 5 minut". To już nie jest dokładne — synchronizacja jest oparta na push i zwykle przychodzi w znacznie mniej niż 30 sekund.

Polityka anulowania i zwroty przez kalendarz

Anulowania po stronie kalendarza podlegają dokładnie tej samej polityce anulowania, którą skonfigurowałeś dla rezerwacji opłaconych przez Stripe (zobacz Płatności Stripe Connect):

• Anulujesz (usuwasz/anulujesz z kalendarza): uczeń otrzymuje pełny zwrot, niezależnie od czasu.
• Uczeń odrzuca z kalendarza przed terminem: pełny zwrot lub zwrot kredytu dla ucznia.
• Uczeń odrzuca z kalendarza po terminie: płatność jest przepadana (zachowujesz ją) lub kredyt sesji jest zużywany.
• Lekcje grupowe: zwroty na miejsce za indywidualne odrzucenia; pełny zwrot każdego opłaconego miejsca, jeśli anulowanie przez korepetytora lub spadek poniżej min_seats przed terminem anuluje lekcję.

Prywatność i zakres

• Voilà tylko odczytuje i zapisuje wydarzenia w kalendarzu, który połączysz — nigdy żaden inny kalendarz na Twoim koncie.
• Wydarzenia, które Voilà odczytuje, są używane wyłącznie do obliczeń planowania i dostępności.
• Możesz odwołać dostęp w dowolnym momencie w Ustawienia → Integracje (lub bezpośrednio z ustawień konta Google / Microsoft).

Rozwiązywanie problemów

Token wygasł

Jeśli synchronizacja się zatrzyma, token OAuth prawdopodobnie wygasł. Otwórz Ustawienia → Integracje i kliknij Ponownie połącz.

Opóźnienia synchronizacji

Webhooks zwykle dostarczają w ciągu ~30 sekund. Godzinna praca konserwacyjna jest siecią bezpieczeństwa, która odnawia subskrypcje i ponownie synchronizuje wszelkie dostawy, które krótko się nie powiodły. Możesz również wyzwolić ręczne odświeżenie ze strony Planowania.

Konflikty z wydarzeniami spoza Voilà

Jeśli spróbujesz potwierdzić rezerwację Voilà na slocie, który jest pokryty wydarzeniem spoza Voilà w Twoim kalendarzu, Voilà Cię ostrzeże i pozwoli Ci przesłonić konflikt — przydatne, gdy wydarzenie w kalendarzu to "miękka" rezerwacja, którą chętnie zwolnisz.

Przełączanie dostawców

Tylko jeden kalendarz może być połączony na raz. Rozłącz Google przed połączeniem Outlook (lub odwrotnie) w Ustawienia → Integracje.

Synchronizacja dwukierunkowa, od końca do końca

sequenceDiagram
    participant Student
    participant StudentCal as "Kalendarz ucznia"
    participant Voila
    participant TutorCal as "Kalendarz korepetytora (Google lub Outlook)"
    participant Tutor

    Note over Voila,TutorCal: Lekcja potwierdzona w Voilà
    Voila->>TutorCal: Utwórz wydarzenie z linkiem Meet lub Teams
    TutorCal-->>Student: Zaproszenie dostarczone
    TutorCal-->>StudentCal: Zaproszenie dostarczone

    Note over Student,StudentCal: Uczeń odrzuca ze skrzynki odbiorczej
    StudentCal->>TutorCal: RSVP odrzucone
    TutorCal->>Voila: Webhook uruchamia się
    Voila->>Voila: Uruchom politykę anulowania
    Voila-->>Tutor: Powiadomienie w aplikacji i e-mail
    Voila-->>Student: Potwierdzenie zwrotu lub przepadku

    Note over Tutor,TutorCal: Korepetytora anuluje wydarzenie
    TutorCal->>Voila: Webhook uruchamia się
    Voila->>Voila: Anuluj i zwróć
    Voila->>StudentCal: Wydarzenie w kalendarzu usunięte

Powiązane

• Planowanie — dostępność tygodniowa, polityki rezerwacji, tryb wakacji
• Lekcje grupowe — minimalne miejsca, zarządzanie członkami, zachowanie anulowania grupy
• Płatności Stripe Connect — polityki anulowania i sposób stosowania zwrotów