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

Підключіться один раз, керуйте звідусіль. Після підключення 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à підписується на ваш календар через канал Google events.watch; оновлення надходять протягом кількох секунд після збереження в 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 "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

Пов'язане

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