Інтеграція календаря

Підключись один раз, керуй звідусіль. Як тільки ти підключиш Google Calendar або Microsoft Outlook (Teams), твої уроки Voilà з'являтимуться на твоєму календарі точно як будь-яка інша зустріч — і все, що ти робиш з подією на своєму календарі, автоматично синхронізується назад у Voilà. Перенесення, скасування, прийняття, відхилення — обидві сторони залишаються синхронізованими протягом кількох секунд.

Ця сторінка написана для репетиторів. Розділ "Що бачать твої студенти" пояснює точно, що бачать твої студенти з їхнього боку, щоб ти міг впевнено керувати всім своїм розкладом зі свого календаря.

Підтримувані провайдери

Провайдер	Відеолінк автоматично додається	Що створюється
Google Calendar	Google Meet	Одна подія на урок, головна подія на серію повторюваних уроків
Microsoft Outlook / Teams	Microsoft Teams	Одна подія на урок, одна подія на кожне повторення

Ти можеш підключити один провайдер календаря одночасно. Щоб перейти на інший, спочатку відключи поточний у Параметри → Інтеграції.

Підключення Google Calendar

1. Перейди до Параметри → Інтеграції або Планування → Підключити Google Calendar.
2. Натисни Підключити Google Calendar.
3. Увійди зі своїм обліковим записом Google і авторизуй Voilà для читання та запису подій.
4. Твій календар почне синхронізуватися негайно.

Що відбувається в момент підключення: кожен підтверджений майбутній урок Voilà буде додано на твій Google Calendar — кожен з посиланням Google Meet, попередньо заповненими учасниками та текстом "Забронировано через Voilà". Більше нічого робити не потрібно.

Підключення Microsoft Outlook / Teams

1. Перейди до Параметри → Інтеграції або Планування → Підключити календар Outlook.
2. Натисни Підключити календар Outlook.
3. Увійди зі своїм обліковим записом Microsoft і авторизуй Voilà для читання та запису подій.
4. Твій календар почне синхронізуватися негайно.

Кожен урок з'явиться на твоєму календарі Outlook як зустріч Teams (посилання для приєднання додається автоматично), зі студентом у списку учасників. Застосовується та сама поведінка заповнення: майбутні уроки Voilà з'являтимуться на твоєму календарі Outlook одразу.

Що з'являється на твоєму календарі (Voilà → календар)

Подія Voilà	Що ти бачиш на календарі
Бронювання 1:1 підтверджено	Запрошення на час уроку з посиланням Meet/Teams, студентом у списку учасників та текстом, написаним Voilà.
Груповий урок підтверджено	Та сама подія зі всіма прийнятими членами у списку учасників. Коли приймають більше членів, вони додаються; якщо член відмовляється, він видаляється.
Повторюваний урок створено	Google: одна головна повторювана подія, що охоплює всю серію. Outlook: одна подія на кожне повторення (щоб оновлення для окремих екземплярів чисто проходили через Microsoft Graph).
Перенесення прийнято у Voilà	Час початку/закінчення запрошення оновлюється на місці, і учасники отримують повідомлення про оновлення. Працює як на Google, так і на Outlook.
Урок скасовано у Voilà	Подія календаря видаляється, і учасники отримують повідомлення про скасування. Працює як на Google, так і на Outlook.
Повторення пропущено у Voilà	Скасовується лише це одне повторення — решта серії залишається незмінною.

Що синхронізується назад у Voilà (календар → Voilà)

Цей розділ дозволяє тобі "жити у своєму календарі". Все, що наведено нижче, автоматично змінює стан Voilà.

Ти переносиш час подій

Перетягування подієї Voilà на інший час або редагування її початку/закінчення відкриває пропозицію перенесення у Voilà. Як тільки студент підтвердить (у додатку або відповівши на електронний лист), час подієї блокується в обох системах. До того часу подія залишається як очікувана пропозиція — студент все ще може бачити її та приймати/відхиляти з Voilà.

Ти видаляєш або скасовуєш подію

Voilà позначає урок як скасований і запускає гілку скасування репетитором політики скасування:

• Студент отримує повне повернення платежу (якщо Stripe) або йому повертається кредит сеансу (якщо пакет сеансів), незалежно від того, чи скасування сталося до чи після граничного часу. Скасування, приписане репетитору, завжди повертає студенту всі кошти.
• Для групових уроків повертаються всі оплачені місця.
• Студент отримує електронний лист про скасування та оновлення в чаті.

Ти створюєш нову подію з одним зі своїх студентів як учасником

Якщо між тобою та студентом існує активний зв'язок, Voilà:

• Автоматично створить пропозицію бронювання для цього уроку.
• Надішле електронний лист студенту, щоб він міг підтвердити час.
• Зарезервує місце у твоїй доступності, поки пропозиція очікує.

Якщо учасник не є відомим студентом, Voilà записує подію як звичайний зайнятий час у твоїй доступності — але не створює бронювання.

Ти додаєш будь-яку іншу подію на свій календар

Будь-яка подія, яку ти додаєш — робочі зустрічі, прийом у лікаря, обід з другом — розглядається як зайнятий час і блокує нові бронювання студентів протягом цього періоду. Тобі не потрібно нічого робити; це відбувається автоматично.

Що бачать твої студенти

Кожного разу, коли урок підтверджується, твій студент отримує запрошення календаря на ту саму подію — з посиланням для приєднання Meet або Teams всередині. Тому він також може керувати уроком зі свого календаря. Ось точно, як Voilà реагує на кожне дію, яку студент може виконати зі своєї папки вхідних повідомлень або додатка календаря:

Дія студента	Що робить Voilà
Приймає запрошення	Нічого додаткового — він уже на уроці. Його RSVP записується для видимості.
Відхиляє очікувану пропозицію зі свого календаря	Пропозиція відхиляється у Voilà. Ти отримуєш повідомлення електронною поштою та в чаті.
Відхиляє підтверджений 1:1 урок зі свого календаря	Voilà запускає гілку скасування студентом політики скасування. До граничного часу = повне повернення або повернення кредиту; після граничного часу = втрата (ти зберігаєш платіж).
Відхиляє з підтвердженого групового уроку	Повертається лише місце цього студента; урок продовжується для всіх інших (залежно від твого правила мінімальної кількості місць).
Відхиляє повторюване повторення	Це одне повторення пропускається (повернення або втрата відповідно до політики скасування). Решта серії залишається незмінною.
Перенаправляє запрошення на іншу папку вхідних	Ніякого впливу на урок — Voilà є джерелом істини, і перенаправлення запрошення не переносить урок і не повертає кошти.

Коротко кажучи: студенти можуть керувати своєю участю повністю зі свого запрошення календаря, і ти побачиш кожну дію, відображену на стороні Voilà протягом кількох секунд.

Групові уроки через календар

Групові уроки додають одну додаткову складність — правило мінімальної кількості місць:

• Один член відхиляє → це місце повертається, учасник видаляється з подієї календаря, урок продовжується.
• Відхилення знижує урок нижче min_seats ДО граничного часу скасування → весь урок скасовується, повертаються всі оплачені місця, подія календаря видаляється.
• Відхилення знижує урок нижче min_seats ПІСЛЯ граничного часу скасування → урок залишається (люди, які зберегли своє місце, вже заплатили за цей час), і ти отримуєш інформаційний електронний лист, щоб ти міг вирішити, як це обробити.

Повторювані уроки через календар

Повторювані уроки зберігаються по-різному на кожному провайдері, але досвід однаковий:

• Google: серія є однією головною повторюваною подією. Відхилення одного екземпляра з календаря пропускає лише це повторення у Voilà; відхилення головної подієї скасовує кожне майбутнє повторення.
• Outlook: кожне повторення пов'язане окремо, тому оновлення для окремих екземплярів від Microsoft Graph чисто проходять. Відхилення одного повторення пропускає його у Voilà; відхилення серії завершує майбутні повторення.
• Пропуск повторення з Voilà автоматично скасовує відповідний екземпляр календаря з чистим повідомленням про скасування для учасників.
• Зміна політики скасування репетитором не застосовується ретроактивно до повторень, які вже існують — кожне повторення блокує політику, яка була активна, коли воно було створено.

Як доставляється синхронізація

Voilà використовує push-повідомлення (webhooks) як основний тригер:

• Google Calendar — Voilà підписується на твій календар через канал events.watch Google; оновлення надходять протягом кількох секунд після того, як ти зберігаєш у Google Calendar.
• Microsoft Outlook / Teams — Voilà підписується через webhooks Microsoft Graph; така сама поведінка.

Невеликий набір запобіжних заходів підтримує канал у здоровому стані:

• Погодинна робота обслуговування поновлює підписки перед їх закінченням і завантажує будь-які відсутні спостереження.
• Заповнення при підключенні надсилає існуючі майбутні уроки Voilà на твій новий календар (і повертає імпорт твоїх існуючих зайнятих часів календаря).
• Ручне оновлення доступне зі сторінки Планування — корисно, якщо ти тестуєш або якщо webhook коротко пропустив доставку.

Попередні версії цієї сторінки згадували "цикл опитування кожні 5 хвилин". Це більше не точно — синхронізація базується на push-повідомленнях і зазвичай надходить менш ніж за 30 секунд.

Політика скасування та повернення коштів через календар

Скасування з боку календаря точно дотримуються тієї ж політики скасування, яку ти налаштував для платежів через Stripe (див. Платежі Stripe Connect):

• Ти скасовуєш (видаляєш/скасовуєш зі свого календаря): студент повністю повертається, незалежно від часу.
• Студент відхиляє зі свого календаря до граничного часу: повне повернення або повернення кредиту студенту.
• Студент відхиляє зі свого календаря після граничного часу: платіж втрачається (ти його зберігаєш) або кредит сеансу споживається.
• Групові уроки: повернення за місцем для окремих відхилень; повне повернення всіх оплачених місць, якщо скасування репетитором або падіння нижче min_seats до граничного часу скасовує урок.

Приватність та область дії

• Voilà читає та записує лише подієї на календарі, який ти підключив — ніколи на жодні інші календарі на твоєму обліковому записі.
• Подієї, які читає Voilà, використовуються виключно для планування та розрахунків доступності.
• Ти можеш відозвати доступ у будь-який час у Параметри → Інтеграції (або безпосередньо з параметрів облікового запису Google / Microsoft).

Усунення неполадок

Токен закінчився

Якщо синхронізація зупиняється, OAuth-токен, ймовірно, закінчився. Відкрий Параметри → Інтеграції і натисни Повторно підключити.

Затримки синхронізації

Webhooks зазвичай доставляються протягом ~30 секунд. Погодинна робота обслуговування є запобіжним заходом, який поновлює підписки та повторно синхронізує будь-яку доставку, яка коротко не вдалася. Ти також можеш запустити ручне оновлення зі сторінки Планування.

Конфлікти з подіями, що не належать Voilà

Якщо ти спробуєш підтвердити бронювання Voilà на місці, яке охоплено подією, що не належить Voilà, на твоєму календарі, Voilà попередить тебе і дозволить переважити конфлікт — корисно, коли подія календаря є "м'яким" утриманням, яке ти готовий відпустити.

Перехід на іншого провайдера

Одночасно можна підключити лише один календар. Відключи Google перед підключенням Outlook (або навпаки) у Параметри → Інтеграції.

Двостороння синхронізація від початку до кінця

sequenceDiagram
    participant Student
    participant StudentCal as "Календар студента"
    participant Voila
    participant TutorCal as "Календар репетитора (Google або Outlook)"
    participant Tutor

    Note over Voila,TutorCal: Урок підтверджено у Voilà
    Voila->>TutorCal: Створити подію з посиланням Meet або Teams
    TutorCal-->>Student: Запрошення доставлено
    TutorCal-->>StudentCal: Запрошення доставлено

    Note over Student,StudentCal: Студент відхиляє з папки вхідних
    StudentCal->>TutorCal: RSVP відхилено
    TutorCal->>Voila: Webhook запущено
    Voila->>Voila: Запустити політику скасування
    Voila-->>Tutor: Повідомлення у додатку та електронною поштою
    Voila-->>Student: Підтвердження повернення або втрати

    Note over Tutor,TutorCal: Репетитор скасовує подію
    TutorCal->>Voila: Webhook запущено
    Voila->>Voila: Скасувати та повернути
    Voila->>StudentCal: Подія календаря видалена

Пов'язане

• Планування — тижнева доступність, політики бронювання, режим відпустки
• Групові уроки — мінімальна кількість місць, управління членами, поведінка групового скасування
• Платежі Stripe Connect — політики скасування та як застосовуються повернення коштів