Интеграция с календар

Свържете веднъж, управлявайте навсякъде. След като свържете Google Calendar или Microsoft Outlook (Teams), уроците ви в Voilà се появяват в календара ви точно като всяка друга среща — и всичко, което направите със събитието от календара си, се синхронизира обратно в Voilà автоматично. Преместване, отмяна, приемане, отклоняване — и двете страни остават синхронизирани в рамките на секунди.

Тази страница е написана за преподаватели. Разделът "Какво виждат вашите ученици" обяснява точно какво виждат вашите ученици от тяхната страна, така че да можете уверено да управлявате целия си график от календара си.

Поддържани доставчици

Доставчик	Видео връзка автоматично прикачена	Какво се създава
Google Calendar	Google Meet	Едно събитие на урок, главно събитие на повтаряща се серия
Microsoft Outlook / Teams	Microsoft Teams	Едно събитие на урок, едно събитие на повтаряща се поява

Можете да свържете един доставчик на календар наведнъж. За да преминете, първо отключете текущия под Settings → Integrations.

Свързване на Google Calendar

1. Отидете на Settings → Integrations или Scheduling → Connect Google Calendar.
2. Кликнете на Connect Google Calendar.
3. Влезте с вашия Google акаунт и разрешете на Voilà да чете и пише събития.
4. Календарът ви започва да се синхронизира веднага.

Какво се случва в момента на свързване: всеки потвърден бъдещ урок в Voilà се изпраща на Google Calendar — всеки с Google Meet връзка, предварително попълнени участници и тяло "Резервирано чрез Voilà". Няма нищо друго за правене.

Свързване на Microsoft Outlook / Teams

1. Отидете на Settings → Integrations или Scheduling → Connect Outlook Calendar.
2. Кликнете на Connect Outlook Calendar.
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à се абонира чрез Microsoft Graph webhooks; същото поведение.

Малък набор от предпазни мрежи поддържа канала здрав:

• Часова работа по поддръжка подновява абонаментите преди да изтекат и зареждане на всички липсващи часовници.
• Попълване при свързване изпраща съществуващи бъдещи уроци в Voilà на новия календар (и обратно импортира съществуващите заети времена на календара).
• Ръчно опресняване е налично от страницата Scheduling — полезно, ако тествате или ако webhook кратко пропусна доставка.

По-ранни версии на тази страница споменаха "5-минутен цикъл на анкетиране". Това вече не е точно — синхронизацията е базирана на push и обикновено пристига в много по-малко от 30 секунди.

Политика за отмяна и възвращания чрез календар

Отмяни от страната на календара следват точно същата политика за отмяна, която сте конфигурирали за резервирания, платени чрез Stripe (вижте Stripe Connect Payments):

• Вие отменяте (изтриване/отмяна от календара): ученикът е напълно възвърнат, независимо от времето.
• Ученик отклонява от календара си преди крайния срок: пълно възвращане или кредит върнат на ученика.
• Ученик отклонява от календара си след крайния срок: плащането е загубено (вие го запазвате) или кредитът за сесия е консумиран.
• Групови уроци: възвращане на място за отделни отклонения; пълно възвращане на всяко платено място, ако отмяна на преподавател или пред-крайния срок пада под min_seats отменя урока.

Поверителност и обхват

• Voilà само чете и пише събития на календара, който свързвате — никога на други календари на вашия акаунт.
• Събитията, които Voilà чете, се използват единствено за планиране и изчисления на наличност.
• Можете да отмените достъпа по всяко време под Settings → Integrations (или директно от настройките на вашия Google / Microsoft акаунт).

Отстраняване на неизправности

Токенът е изтекъл

Ако синхронизацията спре, OAuth токенът вероятно е изтекъл. Отворете Settings → Integrations и кликнете на Reconnect.

Забавяния при синхронизация

Webhooks обикновено се доставят в рамките на ~30 секунди. Часовата работа по поддръжка е предпазна мрежа, която подновява абонаментите и преси-синхронизира всяка доставка, която кратко е пропусната. Можете също да активирате ръчно опресняване от страницата Scheduling.

Конфликти с събития, които не са на Voilà

Ако се опитате да потвърдите резервиране в Voilà на слот, който е покрит от събитие, което не е на Voilà, в календара си, Voilà ще ви предупреди и ще ви позволи да отмените конфликта — полезно, когато събитието в календара е "мек" задържане, което сте щастливи да отпуснете.

Преминаване на доставчици

Само един календар може да бъде свързан наведнъж. Отключете Google преди да свържете Outlook (или обратно) под Settings → Integrations.

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

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

Свързано

• Scheduling — седмична наличност, политики за резервиране, режим на отпуск
• Group Lessons — минимални места, управление на членове, поведение при отмяна на група
• Stripe Connect Payments — политики за отмяна и как се прилагат възвращанията