कैलेंडर इंटीग्रेशन

एक बार कनेक्ट करें, हर जगह मैनेज करें। एक बार जब आप 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à इवेंट	कैलेंडर पर आपको क्या दिखता है
एक 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à प्राथमिक ट्रिगर के रूप में पुश नोटिफिकेशन (वेबहुक) का उपयोग करता है:

Google Calendar — Voilà Google के events.watch चैनल के ज़रिए आपके कैलेंडर को सब्सक्राइब करता है; Google Calendar में सेव करने के सेकंडों के भीतर अपडेट आ जाते हैं।
Microsoft Outlook / Teams — Voilà Microsoft Graph वेबहुक के ज़रिए सब्सक्राइब करता है; वही व्यवहार।

कुछ सेफ्टी नेट चैनल को स्वस्थ रखते हैं:

प्रति घंटा मेंटेनेंस जॉब सब्सक्रिप्शन को एक्सपायर होने से पहले रिन्यू करता है और किसी भी मिसिंग वॉच को बूटस्ट्रैप करता है।
कनेक्ट पर बैकफिल मौजूदा भविष्य के Voilà लेसन को आपके नए कैलेंडर पर पुश करता है (और आपके मौजूदा कैलेंडर की बिज़ी टाइम्स को वापस इम्पोर्ट करता है)।
मैनुअल रिफ्रेश Scheduling पेज से उपलब्ध है — उपयोगी अगर आप टेस्ट कर रहे हैं या अगर कोई वेबहुक संक्षेप में डिलीवरी चूक गया।

इस पेज के पुराने संस्करणों में "5-मिनट पोलिंग साइकल" का उल्लेख था। यह अब सटीक नहीं है — सिंक पुश-आधारित है और आमतौर पर 30 सेकंड से काफी कम समय में आ जाता है।

कैलेंडर के ज़रिए कैंसलेशन पॉलिसी और रिफंड

कैलेंडर-साइड कैंसलेशन बिल्कुल उसी कैंसलेशन पॉलिसी का पालन करते हैं जो आपने Stripe-पेड बुकिंग के लिए कॉन्फ़िगर की है (देखें Stripe Connect Payments):

आप रद्द करते हैं (अपने कैलेंडर से डिलीट/कैंसल करते हैं): स्टूडेंट को समय की परवाह किए बिना पूरा रिफंड मिलता है।
स्टूडेंट कटऑफ से पहले अपने कैलेंडर से अस्वीकार करता है: स्टूडेंट को पूरा रिफंड या क्रेडिट वापस।
स्टूडेंट कटऑफ के बाद अपने कैलेंडर से अस्वीकार करता है: भुगतान जब्त हो जाता है (आप रखते हैं) या सेशन क्रेडिट खर्च हो जाता है।
ग्रुप लेसन: व्यक्तिगत अस्वीकृति के लिए प्रति-सीट रिफंड; अगर ट्यूटर कैंसल या कटऑफ से पहले min_seats से नीचे आने पर लेसन रद्द होता है तो हर पेड सीट का पूरा रिफंड।

प्राइवेसी और स्कोप

Voilà केवल उस कैलेंडर पर इवेंट पढ़ता और लिखता है जिसे आप कनेक्ट करते हैं — आपके अकाउंट के किसी अन्य कैलेंडर पर नहीं।
Voilà जो इवेंट पढ़ता है वे केवल शेड्यूलिंग और उपलब्धता गणनाओं के लिए उपयोग किए जाते हैं।
आप Settings → Integrations में (या सीधे अपने Google / Microsoft अकाउंट सेटिंग्स से) किसी भी समय एक्सेस रद्द कर सकते हैं।

समस्या निवारण

टोकन एक्सपायर हो गया

अगर सिंक रुक जाता है, तो OAuth टोकन संभवतः एक्सपायर हो गया है। Settings → Integrations खोलें और Reconnect पर क्लिक करें।

सिंक में देरी

वेबहुक आमतौर पर ~30 सेकंड के भीतर डिलीवर होते हैं। प्रति घंटा मेंटेनेंस जॉब एक सेफ्टी नेट है जो सब्सक्रिप्शन रिन्यू करता है और किसी भी डिलीवरी को फिर से सिंक करता है जो संक्षेप में विफल हुई। आप Scheduling पेज से मैनुअल रिफ्रेश भी ट्रिगर कर सकते हैं।

गैर-Voilà इवेंट के साथ कॉन्फ्लिक्ट

अगर आप किसी ऐसे स्लॉट पर Voilà बुकिंग कन्फर्म करने की कोशिश करते हैं जो आपके कैलेंडर पर किसी गैर-Voilà इवेंट से कवर है, तो Voilà आपको चेतावनी देगा और कॉन्फ्लिक्ट को ओवरराइड करने देगा — उपयोगी जब कैलेंडर इवेंट एक "सॉफ्ट" होल्ड हो जिसे आप छोड़ने के लिए तैयार हैं।

प्रोवाइडर बदलना

एक समय में केवल एक कैलेंडर कनेक्ट किया जा सकता है। Settings → Integrations में Outlook कनेक्ट करने से पहले Google डिसकनेक्ट करें (या इसके विपरीत)।

द्विदिशात्मक सिंक, शुरू से अंत तक

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

समर्थित प्रोवाइडर​

Google Calendar से कनेक्ट करना​

Microsoft Outlook / Teams से कनेक्ट करना​

आपके कैलेंडर पर क्या दिखता है (Voilà → कैलेंडर)​

Voilà में वापस क्या सिंक होता है (कैलेंडर → Voilà)​

आप इवेंट का समय बदलते हैं​

आप इवेंट डिलीट या रद्द करते हैं​

आप अपने किसी स्टूडेंट को अटेंडी के रूप में एक नया इवेंट बनाते हैं​

आप अपने कैलेंडर में कोई अन्य इवेंट जोड़ते हैं​

आपके स्टूडेंट्स का अनुभव​

कैलेंडर के ज़रिए ग्रुप लेसन​

कैलेंडर के ज़रिए रिकरिंग लेसन​

सिंक कैसे डिलीवर होता है​

कैलेंडर के ज़रिए कैंसलेशन पॉलिसी और रिफंड​

प्राइवेसी और स्कोप​

समस्या निवारण​

टोकन एक्सपायर हो गया​

सिंक में देरी​

गैर-Voilà इवेंट के साथ कॉन्फ्लिक्ट​

प्रोवाइडर बदलना​

द्विदिशात्मक सिंक, शुरू से अंत तक​

संबंधित​