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 ze zdarzeniem w kalendarzu, automatycznie wraca do Voilà. Przesuwanie, anulowanie, akceptowanie, odrzucanie — 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 widzą uczniowie 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 zostaje utworzone
Google Calendar	Google Meet	Jedno zdarzenie na lekcję, zdarzenie główne na serię powtarzającą się
Microsoft Outlook / Teams	Microsoft Teams	Jedno zdarzenie na lekcję, jedno zdarzenie na każde powtórzenie

Możesz połączyć jednego dostawcę kalendarza naraz. Aby przełączyć się, najpierw rozłącz obecnego w Ustawienia → Integracje.

Łączenie Google Calendar

1. Przejdź do Ustawienia → Integracje lub Harmonogram → Połącz Google Calendar.
2. Kliknij Połącz Google Calendar.
3. Zaloguj się na swoje konto Google i autoryzuj Voilà do odczytywania i pisania zdarzeń.
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 Harmonogram → Połącz Outlook Calendar.
2. Kliknij Połącz Outlook Calendar.
3. Zaloguj się na swoje konto Microsoft i autoryzuj Voilà do odczytywania i pisania zdarzeń.
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)

Zdarzenie Voilà	Co widzisz w kalendarzu
Rezerwacja 1:1 jest potwierdzona	Zaproszenie o godzinie lekcji, z linkiem Meet/Teams, uczniem na liście uczestników i treścią napisaną przez Voilà.
Lekcja grupowa się potwierdza	To samo zdarzenie, 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 zdarzenie powtarzające się obejmujące całą serię. Outlook: jedno zdarzenie na każde powtórzenie (dzięki czemu aktualizacje dla poszczególnych instancji płynnie przechodzą 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à	Zdarzenie kalendarza 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à)

To jest sekcja, która pozwala ci „żyć w swoim kalendarzu". Wszystko poniżej automatycznie zmienia stan Voilà.

Przesuwasz czas zdarzenia

Przeciągnięcie zdarzenia 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 zdarzenia jest zablokowany w obu systemach. Do tego czasu zdarzenie pozostaje jako oczekująca propozycja — uczeń może ją nadal widzieć i zaakceptować/odrzucić z poziomu Voilà.

Usuwasz lub anulujesz zdarzenie

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ą uczniowi.
• W przypadku lekcji grupowych każde opłacone miejsce jest zwracane.
• Uczeń otrzymuje e-mail anulowania i aktualizację karty czatu.

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

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

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

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

Dodajesz jakiekolwiek inne zdarzenie do kalendarza

Każde zdarzenie, które dodasz — spotkania biznesowe, 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 zdarzenie — 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:

Czynność 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 odrzucana 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 zwrócony kredyt; 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 pomijane (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 wydaje 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ą czynność 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 ze zdarzenia kalendarza, lekcja trwa.
• Odrzucenie spada poniżej min_seats PRZED terminem anulowania → cała lekcja jest anulowana, każde opłacone miejsce jest zwracane, zdarzenie kalendarza 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ługiwać.

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 zdarzenie powtarzające się. 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 przechodzą czyszczenie. 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 zdarzenie kalendarza 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:

• Godzinne zadanie konserwacyjne odnawia subskrypcje przed ich wygaśnięciem i uruchamia 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 kalendarza).
• Ręczne odświeżenie jest dostępne ze strony Harmonogram — 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 Stripe Connect Payments):

• Ty anulujesz (usuwasz/anulujesz z kalendarza): uczeń otrzymuje pełny zwrot, niezależnie od czasu.
• Uczeń odrzuca z kalendarza przed terminem: pełny zwrot lub zwrócony kredyt 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 pisze zdarzenia w kalendarzu, który połączysz — nigdy żaden inny kalendarz na twoim koncie.
• Zdarzenia, które Voilà odczytuje, są używane wyłącznie do obliczeń harmonogramu 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. Godzinne zadanie konserwacyjne 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 Harmonogram.

Konflikty ze zdarzeniami spoza Voilà

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

Przełączanie dostawców

Tylko jeden kalendarz może być połączony naraz. 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 zdarzenie 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 zdarzenie
    TutorCal->>Voila: Webhook uruchamia się
    Voila->>Voila: Anuluj i zwróć
    Voila->>StudentCal: Zdarzenie kalendarza usunięte

Powiązane

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