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

Повежи једном, управљај свуда. Када повежеш Google Calendar или Microsoft Outlook (Teams), твоји Voilà часови живе у твом календару баш као и сваки други састанак — и све што урадиш са догађајем у свом календару аутоматски се преноси назад у Voilà. Помери, откажи, прихвати, одбиј — обе стране остају синхронизоване у року од неколико секунди.

Ова страница је написана за тјутере. Одељак „Шта твоји ученици виде" тачно објашњава шта ученици виде са своје стране, тако да можеш самоуверено да управљаш целим распоредом из свог календара.

Подржани провајдери

Провајдер	Видео линк аутоматски приложен	Шта се креира
Google Calendar	Google Meet	Један догађај по часу, главни догађај по серији понављања
Microsoft Outlook / Teams	Microsoft Teams	Један догађај по часу, један догађај по свакој понављајућој инстанци

Можеш повезати једног провајдера календара у исто време. Да би прешао на другог, прво искључи тренутног под Settings → Integrations.

Повезивање Google Calendar-а

Иди на Settings → Integrations, или Scheduling → Connect Google Calendar.
Кликни на Connect Google Calendar.
Пријави се са својим Google налогом и овласти Voilà да чита и пише догађаје.
Твој календар почиње да се синхронизује одмах.

Шта се дешава у тренутку повезивања: сваки потврђени будући Voilà час се гура на твој Google Calendar — сваки са Google Meet линком, унапред попуњеним учесницима и телом „Booked via Voilà". Нема ничег другог да радиш.

Повезивање Microsoft Outlook / Teams-а

Иди на Settings → Integrations, или Scheduling → Connect Outlook Calendar.
Кликни на Connect Outlook Calendar.
Пријави се са својим Microsoft налогом и овласти Voilà да чита и пише догађаје.
Твој календар почиње да се синхронизује одмах.

Сваки час се појављује у твом Outlook календару као Teams састанак (линк за придруживање се аутоматски прилаже), са учеником наведеним као учесником. Исто понашање при почетном пуњењу се примењује: будући Voilà часови се одмах појављују у твом Outlook календару.

Шта се појављује у твом календару (Voilà → календар)

Voilà догађај	Шта видиш у календару
Потврђена је индивидуална резервација	Позивница у времену часа, са 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à. Добијаш обавештење имејлом и у чету.
*Одбија потврђени индивидуални час* из свог календара**	Voilà покреће грану отказивања од стране ученика у оквиру политике отказивања. Пре рока = пун повраћај или враћање кредита; после рока = губитак (ти задржаваш уплату).
Одбија са потврђеног групног часа	Само место тог ученика се рефундира; час се наставља за све остале (у складу са твојим правилом о минималном броју места).
*Одбија инстанцу понављајућег* часа**	Та појединачна инстанца се прескаче (повраћај или губитак у складу са политиком отказивања). Остатак серије остаје нетакнут.
Прослеђује позивницу на другу адресу	Нема ефекта на час — Voilà је извор истине, а прослеђивање позивнице не помера час нити поново издаје повраћаје.

Укратко: ученици могу да управљају својим учешћем у потпуности из позивнице у календару, а ти ћеш видети сваку радњу одражену на Voilà страни у року од неколико секунди.

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

Групни часови додају један додатни нијанс — правило о минималном броју места:

Један члан одбија → то место се рефундира, учесник се уклања из догађаја у календару, час се наставља.
Одбијање спушта час испод min_seats ПРЕ рока отказивања → цео час се отказује, свако плаћено место се рефундира, догађај у календару се уклања.
Одбијање спушта час испод min_seats ПОСЛЕ рока отказивања → час остаје (људи који су задржали своје место су већ платили за термин), а ти добијаш обавештење имејлом да можеш да одлучиш како да поступиш.

Понављајући часови преко календара

Понављајући часови се чувају различито код сваког провајдера, али искуство је исто:

Google: серија је јединствени главни понављајући догађај. Одбијање једне инстанце из календара прескаче само ту инстанцу у Voilà; одбијање главног догађаја отказује све будуће инстанце.
Outlook: свака инстанца је повезана појединачно тако да ажурирања по инстанци из Microsoft Graph-а пролазе чисто. Одбијање једне инстанце је прескаче у Voilà; одбијање серије завршава будуће инстанце.
Прескакање инстанце унутар Voilà аутоматски отказује одговарајућу инстанцу у календару са чистим обавештењем о отказивању учесницима.
Промена политике отказивања тјутера се не примењује ретроактивно на инстанце које већ постоје — свака инстанца закључава политику која је важила у тренутку када је креирана.

Како се синхронизација испоручује

Voilà користи push обавештења (webhook-ове) као примарни окидач:

Google Calendar — Voilà се претплаћује на твој календар преко Google-овог events.watch канала; ажурирања стижу у року од неколико секунди од чувања у Google Calendar-у.
Microsoft Outlook / Teams — Voilà се претплаћује преко Microsoft Graph webhook-ова; исто понашање.

Мали скуп сигурносних мрежа одржава канал здравим:

Сатни одржавачки посао обнавља претплате пре него што истекну и покреће све недостајуће претплате.
Почетно пуњење при повезивању гура постојеће будуће Voilà часове на твој нови календар (и увози постојећа заузета времена из твог календара).
Ручно освежавање је доступно са странице Scheduling — корисно ако тестираш или ако је webhook на кратко пропустио испоруку.

Старије верзије ове странице помињале су „5-минутни циклус провере". То више није тачно — синхронизација је заснована на push-у и обично стиже за мање од 30 секунди.

Политика отказивања и повраћаји преко календара

Отказивања са стране календара прате потпуно исту политику отказивања коју си конфигурисао за резервације плаћене преко Stripe-а (погледај Stripe Connect Payments):

Ти отказујеш (бришеш/отказујеш из свог календара): ученику се у потпуности враћа новац, без обзира на временски оквир.
Ученик одбија из свог календара пре рока: пун повраћај или враћање кредита ученику.
Ученик одбија из свог календара после рока: уплата се губи (ти је задржаваш) или се кредит сесије троши.
Групни часови: повраћај по месту за индивидуална одбијања; пун повраћај свих плаћених места ако тјутер откаже или ако пад испод min_seats пре рока откаже час.

Приватност и обим

Voilà чита и пише само догађаје у календару који повежеш — никада у другим календарима на твом налогу.
Догађаји које Voilà чита користе се искључиво за израчунавање распореда и доступности.
Можеш да опозовеш приступ у било ком тренутку под Settings → Integrations (или директно из подешавања твог Google / Microsoft налога).

Решавање проблема

Токен је истекао

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

Кашњења у синхронизацији

Webhook-ови обично испоручују у року од ~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 — политике отказивања и начин примене повраћаја

Подржани провајдери​

Повезивање Google Calendar-а​

Повезивање Microsoft Outlook / Teams-а​

Шта се појављује у твом календару (Voilà → календар)​

Шта се синхронизује назад у Voilà (календар → Voilà)​

Помераш време догађаја​

Бришеш или отказујеш догађај​

Креираш нови догађај са једним од твојих ученика као учесником​

Додаш неки други догађај у свој календар​

Шта твоји ученици виде​

Групни часови преко календара​

Понављајући часови преко календара​

Како се синхронизација испоручује​

Политика отказивања и повраћаји преко календара​

Приватност и обим​

Решавање проблема​

Токен је истекао​

Кашњења у синхронизацији​

Конфликти са догађајима који нису Voilà​

Прелазак на другог провајдера​

Двосмерна синхронизација, од почетка до краја​

Повезано​