Integrazzjoni tal-Kalendarju

Qabbad darba, immaniġġja kullimkien. Ladarba tqabbad Google Calendar jew Microsoft Outlook (Teams), il-lezzjonijiet Voilà tiegħek jgħixu fuq il-kalendarju tiegħek eżatt bħal kwalunkwe laqgħa oħra — u kull ħaġa li tagħmel lill-avveniment mill-kalendarju tiegħek tirritorna f'Voilà awtomatikament. Ibdel l-ħin, ikkanċella, aċċetta, rifjuta — iż-żewġ naħat jibqgħu sinkronizzati fi ftit sekondi.

Din il-paġna hija miktuba għall-għalliema. Is-sezzjoni "Dak li jesperjenzaw l-istudenti tiegħek" tispjega eżatt dak li jaraw l-istudenti tiegħek min-naħa tagħhom sabiex tkun tista' b'kunfidenza tmexxu l-iskeda kollha tiegħek mill-kalendarju tiegħek.

Fornituri appoġġati

Fornitur	Link tal-video mehmuż awtomatikament	Dak li jinħoloq
Google Calendar	Google Meet	Avveniment wieħed għal kull lezzjoni, avveniment prinċipali għal kull serje rikorrenti
Microsoft Outlook / Teams	Microsoft Teams	Avveniment wieħed għal kull lezzjoni, avveniment wieħed għal kull okkorrenza rikorrenti

Tista' tqabbad fornitur kalendarju wieħed fil-ħin. Biex tibdel, aqta' l-ewwel dak attwali taħt Settings → Integrations.

Qabbad Google Calendar

1. Mur Settings → Integrations, jew Scheduling → Connect Google Calendar.
2. Ikklikkja Connect Google Calendar.
3. Idħol bil-kont Google tiegħek u awtorizza lil Voilà biex taqra u tikteb avvenimenti.
4. Il-kalendarju tiegħek jibda jsinkronizza immedjatament.

Dak li jseħħ fil-mument li tqabbad: kull lezzjoni Voilà futura konfermata titħabbat fuq Google Calendar tiegħek — kull waħda b'link Google Meet, attendees mimlija minn qabel, u korp "Booked via Voilà". M'hemm xejn ieħor x'tagħmel.

Qabbad Microsoft Outlook / Teams

1. Mur Settings → Integrations, jew Scheduling → Connect Outlook Calendar.
2. Ikklikkja Connect Outlook Calendar.
3. Idħol bil-kont Microsoft tiegħek u awtorizza lil Voilà biex taqra u tikteb avvenimenti.
4. Il-kalendarju tiegħek jibda jsinkronizza immedjatament.

Kull lezzjoni tasal fuq il-kalendarju Outlook tiegħek bħala laqgħa Teams (il-link biex tingħaqad jitwaħħal awtomatikament), bl-istudent imniżżel bħala attendee. L-istess imġiba ta' backfill tapplika: lezzjonijiet Voilà futuri jidhru fuq il-kalendarju Outlook tiegħek immedjatament.

Dak li jidher fuq il-kalendarju tiegħek (Voilà → kalendarju)

Avveniment Voilà	Dak li tara fuq il-kalendarju
Booking 1:1 jiġi kkonfermat	Stedina fil-ħin tal-lezzjoni, bil-link Meet/Teams, l-istudent bħala attendee, u korp iktub minn Voilà.
Lezzjoni tal-grupp titkonfirma	L-istess avveniment, b'kull membru aċċettat fuq il-lista tal-attendees. Hekk kif aktar membri jaċċettaw, jiżdiedu; jekk membru jinqata', jitneħħa.
Lezzjoni rikorrenti tinħoloq	Google: avveniment rikorrenti prinċipali wieħed li jkopri s-serje kollha. Outlook: avveniment wieħed għal kull okkorrenza (sabiex aġġornamenti għal kull istanza jgħaddu b'mod nadif permezz ta' Microsoft Graph).
Tibdil fil-ħin jiġi aċċettat f'Voilà	Il-ħin tal-bidu/tmiem tal-istedina jiġi aġġornat fil-post u l-attendees jirċievu avviż ta' aġġornament. Jaħdem kemm fuq Google kif ukoll fuq Outlook.
Lezzjoni tiġi kkanċellata f'Voilà	L-avveniment tal-kalendarju jitneħħa u l-attendees jiġu avżati b'avviż ta' kanċellazzjoni. Jaħdem kemm fuq Google kif ukoll fuq Outlook.
Okkorrenza rikorrenti tiġi maqbuża f'Voilà	Dik l-okkorrenza waħda biss tiġi kkanċellata — il-bqija tas-serje tibqa' intatta.

Dak li jsinkronizza lura f'Voilà (kalendarju → Voilà)

Din hija s-sezzjoni li tħallik "tgħix fil-kalendarju tiegħek". Kull ħaġa hawn taħt tibdel l-istat Voilà awtomatikament.

Tmexxi l-avveniment għal ħin ieħor

Meta tgħaddi avveniment Voilà għal slot ieħor, jew teditja l-bidu/tmiem tiegħu, tiftaħ proposta għal tibdil fil-ħin ġewwa Voilà. Ladarba l-istudent jikkonferma (fl-app jew billi jwieġeb lill-email), il-ħin tal-avveniment jiġi msakkar fiż-żewġ sistemi. Sa dakinhar, l-avveniment joqgħod bħala proposta pendenti — l-istudent xorta jista' jara u jaċċetta/jirrifjuta minn ġewwa Voilà.

Tħassar jew tikkanċella l-avveniment

Voilà timmarka l-lezzjoni kkanċellata u tmexxi l-fergħa ta' kanċellazzjoni tal-għalliem tal-politika ta' kanċellazzjoni:

• L-istudent jiġi rifużat il-ħlas kollu (jekk Stripe) jew jiġi rritornati l-krediti tas-sessjoni tiegħu (jekk pakkett ta' sessjonijiet), irrispettivament minn jekk il-kanċellazzjoni seħħitx qabel jew wara l-qata'. Kanċellazzjonijiet attribwiti lill-għalliem dejjem jagħmlu lill-istudent sħiħ.
• Għal lezzjonijiet tal-grupp, kull post imħallas jiġi rifużat.
• L-istudent jirċievi email ta' kanċellazzjoni u aġġornament ta' chat-card.

Toħloq avveniment ġdid b'wieħed mill-istudenti tiegħek bħala attendee

Jekk hemm relazzjoni attiva student–għalliem bejnietkom, Voilà se:

• Toħloq awtomatikament proposta ta' booking għal dik il-lezzjoni.
• Tibgħat email lill-istudent sabiex ikun jista' jikkonferma l-ħin.
• Żżomm is-slot fuq id-disponibbiltà tiegħek waqt li l-proposta tkun pendenti.

Jekk l-attendee m'huwiex student magħruf tiegħek, Voilà tirrekorja l-avveniment bħala blokk regolari ta' ħin okkupat fuq id-disponibbiltà tiegħek — iżda ma toħloqx booking.

Iżżid kwalunkwe avveniment ieħor mal-kalendarju tiegħek

Kwalunkwe avveniment li żżid — laqgħat tax-xogħol, appuntamenti mad-dentist, ikel ma' ħabib — jiġi ttrattati bħala ħin okkupat u jimblokka bookings ġodda tal-istudenti matul dak il-ħin. M'għandekx tagħmel xejn; dan huwa awtomatiku.

Dak li jesperjenzaw l-istudenti tiegħek

Kull meta lezzjoni tiġi konfermata, l-istudent tiegħek jirċievi stedina tal-kalendarju għall-istess avveniment — bil-link Meet jew Teams ġewwa. Allura jistgħu jimmaniġġjaw il-lezzjoni mill-kalendarju tagħhom ukoll. Hawn eżatt kif Voilà tirreaġixxi għal kull ħaġa li jista' jagħmel student mill-inbox jew app tal-kalendarju tiegħu:

Azzjoni tal-istudent	Dak li tagħmel Voilà
Jaċċetta l-istedina	Xejn żejjed — diġà huma fuq il-lezzjoni. L-RSVP tagħhom tiġi rrekorjata għal viżibbiltà.
Jirrifjuta proposta pendenti mill-kalendarju tagħhom	Il-proposta tiġi rrifjutata f'Voilà. Tiġi avżat bl-email u chat.
Jirrifjuta lezzjoni 1:1 konfermata mill-kalendarju tagħhom	Voilà tmexxi l-fergħa ta' kanċellazzjoni tal-istudent tal-politika ta' kanċellazzjoni. Qabel il-qata' = rifuż sħiħ jew kreditu rritornati; wara l-qata' = forfeit (inti żżomm il-ħlas).
Jirrifjuta minn lezzjoni tal-grupp konfermata	Dak is-sit tal-istudent biss jiġi rifużat; il-lezzjoni tkompli għal kulħadd ieħor (soġġett għar-regola tal-minimum-sits tiegħek).
Jirrifjuta okkorrenza rikorrenti	Dik l-okkorrenza waħda tiġi maqbuża (rifuż jew forfeit skont il-politika ta' kanċellazzjoni). Il-bqija tas-serje ma tinmessx.
Jgħaddi l-istedina għal inbox ieħor	Ebda effett fuq il-lezzjoni — Voilà hija s-sors tal-verità, u li tgħaddi l-istedina ma tmexxi l-lezzjoni u lanqas terġa' toħroġ rifużi.

Fil-qosor: l-istudenti jistgħu jimmaniġġjaw il-parteċipazzjoni tagħhom kompletament mill-istedina tal-kalendarju tagħhom, u int tara kull azzjoni riflessa fuq in-naħa Voilà fi ftit sekondi.

Lezzjonijiet tal-grupp permezz tal-kalendarju

Lezzjonijiet tal-grupp iżidu ħaġa żejda — ir-regola tal-minimum sits:

• Membru wieħed jirrifjuta → dak is-sit jiġi rifużat, l-attendee jitneħħa mill-avveniment tal-kalendarju, il-lezzjoni tkompli.
• Rifjut iwaqqgħa l-lezzjoni taħt min_seats QABEL il-qata' tal-kanċellazzjoni → il-lezzjoni kollha tiġi kkanċellata, kull sit imħallas jiġi rifużat, l-avveniment tal-kalendarju jitneħħa.
• Rifjut iwaqqgħa l-lezzjoni taħt min_seats WARA l-qata' tal-kanċellazzjoni → il-lezzjoni tibqa' (nies li żammew is-sit tagħhom diġà ħallsu għas-slot), u tirċievi email ta' heads-up sabiex tkun tista' tiddeċiedi kif timmaniġġjaha.

Lezzjonijiet rikorrenti permezz tal-kalendarju

Lezzjonijiet rikorrenti jinħażnu b'mod differenti fuq kull fornitur, iżda l-esperjenza hija l-istess:

• Google: is-serje hija avveniment rikorrenti prinċipali wieħed. Li tirrifjuta istanza waħda mill-kalendarju taqbeż dik l-okkorrenza biss f'Voilà; li tirrifjuta l-prinċipali tikkanċella kull okkorrenza futura.
• Outlook: kull okkorrenza hija marbuta individwalment sabiex aġġornamenti għal kull istanza minn Microsoft Graph jgħaddu b'mod nadif. Li tirrifjuta okkorrenza waħda taqbżaha f'Voilà; li tirrifjuta s-serje ttemm okkorrenza futuri.
• Li taqbeż okkorrenza minn ġewwa Voilà awtomatikament tikkanċella l-istanza tal-kalendarju korrispondenti b'avviż nadif ta' kanċellazzjoni lill-attendees.
• Bidla fil-politika ta' kanċellazzjoni tal-għalliem mhix applikata retroattivament għal okkorrenza li diġà jeżistu — kull okkorrenza tissakkar fil-politika li kienet attiva meta nħolqot.

Kif tiġi mogħtija s-sinkronizzazzjoni

Voilà tuża notifiki push (webhooks) bħala t-trigger primarju:

• Google Calendar — Voilà tissottoskriva għall-kalendarju tiegħek permezz tal-kanal events.watch ta' Google; aġġornamenti jaslu fi ftit sekondi minn meta ssalva f'Google Calendar.
• Microsoft Outlook / Teams — Voilà tissottoskriva permezz ta' webhooks Microsoft Graph; l-istess imġiba.

Sett żgħir ta' safety nets iżomm il-kanal b'saħħtu:

• Xogħol ta' manutenzjoni kull siegħa iġedded sottoskrizzjonijiet qabel ma jiskadu u jibda kwalunkwe watches nieqsa.
• Backfill fuq il-konnessjoni timbotta lezzjonijiet Voilà futuri eżistenti għall-kalendarju ġdid tiegħek (u timporta lura l-ħinijiet okkupati tal-kalendarju eżistenti tiegħek).
• Refresh manwali disponibbli mill-paġna Scheduling — utli jekk qed tittestja jew jekk webhook għal ftit ħin ma wasalx.

Verżjonijiet preċedenti ta' din il-paġna semmejna "ċiklu ta' polling ta' 5 minuti". Dan m'għadux preċiż — is-sinkronizzazzjoni hija bbażata fuq push u tipikament tasal f'inqas minn 30 sekonda.

Politika ta' kanċellazzjoni u rifużi permezz tal-kalendarju

Kanċellazzjonijiet min-naħa tal-kalendarju jsegwu eżatt l-istess politika ta' kanċellazzjoni li kkonfigurajt għal bookings imħallsa Stripe (ara Stripe Connect Payments):

• Int tikkanċella (tħassar/tikkanċella mill-kalendarju tiegħek): l-istudent jiġi rifużat kompletament, irrispettivament mill-ħin.
• L-istudent jirrifjuta mill-kalendarju tiegħu qabel il-qata': rifuż sħiħ jew kreditu rritornati lill-istudent.
• L-istudent jirrifjuta mill-kalendarju tiegħu wara l-qata': il-ħlas jiġi forfeit (int iżżommu) jew il-kreditu tas-sessjoni jiġi kkunsmat.
• Lezzjonijiet tal-grupp: rifużi għal kull sit għal rifjuti individwali; rifuż sħiħ ta' kull sit imħallas jekk kanċellazzjoni tal-għalliem jew waqgħa qabel il-qata' taħt min_seats tikkanċella l-lezzjoni.

Privatezza u ambitu

• Voilà taqra u tikteb biss avvenimenti fuq il-kalendarju li tqabbad — qatt ebda kalendarji oħra fuq il-kont tiegħek.
• Avvenimenti li Voilà taqra jintużaw biss għal kalkoli ta' skedulazzjoni u disponibbiltà.
• Tista' tirrevoka l-aċċess fi kwalunkwe ħin taħt Settings → Integrations (jew direttament mis-settings tal-kont Google / Microsoft tiegħek).

Troubleshooting

Token skadut

Jekk is-sinkronizzazzjoni tieqaf, x'aktarx li t-token OAuth skada. Iftaħ Settings → Integrations u ikklikkja Reconnect.

Dewmien fis-sinkronizzazzjoni

Webhooks normalment iwasslu fi ~30 sekonda. Ix-xogħol ta' manutenzjoni kull siegħa huwa safety net li jġedded sottoskrizzjonijiet u jerġa' jsinkronizza kwalunkwe twasil li għal ftit ħin ma rnexxielux. Tista' wkoll tħarrek refresh manwali mill-paġna Scheduling.

Konflitti ma' avvenimenti mhux Voilà

Jekk tipprova tikkonferma booking Voilà fuq slot li huwa kopert minn avveniment mhux Voilà fuq il-kalendarju tiegħek, Voilà se twissik u tħallik taqbeż il-konflitt — utli meta l-avveniment tal-kalendarju huwa "soft" hold li int kuntent li tħalli.

Tibdil fornituri

Kalendarju wieħed biss jista' jiġi mqabbad fil-ħin. Aqta' Google qabel ma tqabbad Outlook (jew vice-versa) taħt Settings → Integrations.

Sinkronizzazzjoni bidirezzjonali, minn tmiem għal ieħor

sequenceDiagram
    participant Student
    participant StudentCal as "Kalendarju tal-Istudent"
    participant Voila
    participant TutorCal as "Kalendarju tal-Għalliem (Google jew Outlook)"
    participant Tutor

    Note over Voila,TutorCal: Lezzjoni konfermata f'Voilà
    Voila->>TutorCal: Oħloq avveniment b'link Meet jew Teams
    TutorCal-->>Student: Stedina mogħtija
    TutorCal-->>StudentCal: Stedina mogħtija

    Note over Student,StudentCal: L-istudent jirrifjuta mill-inbox
    StudentCal->>TutorCal: RSVP rifjutat
    TutorCal->>Voila: Webhook jitlaq
    Voila->>Voila: Mexxi politika ta' kanċellazzjoni
    Voila-->>Tutor: Avviż fl-app u bl-email
    Voila-->>Student: Konferma ta' rifuż jew forfeit

    Note over Tutor,TutorCal: Għalliem jikkanċella l-avveniment
    TutorCal->>Voila: Webhook jitlaq
    Voila->>Voila: Ikkanċella u rifuża
    Voila->>StudentCal: Avveniment tal-kalendarju mneħħi

Relatat

• Scheduling — disponibbiltà ta' kull ġimgħa, politiki ta' booking, modalità ta' vakanzi
• Group Lessons — minimum sits, ġestjoni tal-membri, imġiba ta' kanċellazzjoni tal-grupp
• Stripe Connect Payments — politiki ta' kanċellazzjoni u kif jiġu applikati r-rifużi