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

Повежите једном, управљајте свуда. Када повежете 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 Calendar.
2. Кликните Повежи 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à.

Померате време događаја

Превлачење 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à часове на Ваш нови календар (и увози уназад Ваша постојећа заузета времена календара).
• Ручно освежавање је доступно са странице Заказивање — корисно ако тестирате или ако 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 Плаћања — политике отказивања и како се примењују повраћаји