कैलेंडर एकीकरण

एक बार कनेक्ट करें, हर जगह प्रबंधित करें। एक बार जब आप Google Calendar या Microsoft Outlook (Teams) को कनेक्ट कर देते हैं, तो आपके Voilà पाठ आपके कैलेंडर पर बिल्कुल किसी अन्य मीटिंग की तरह दिखाई देते हैं — और आप अपने कैलेंडर से इवेंट के साथ जो भी करते हैं वह स्वचालित रूप से Voilà में वापस प्रवाहित होता है। पुनर्निर्धारित करें, रद्द करें, स्वीकार करें, अस्वीकार करें — दोनों पक्ष सेकंडों के भीतर सिंक में रहते हैं।

यह पृष्ठ शिक्षकों के लिए लिखा गया है। "आपके छात्र क्या अनुभव करते हैं" अनुभाग बताता है कि आपके छात्र अपनी तरफ से क्या देखते हैं ताकि आप आत्मविश्वास से अपने पूरे शेड्यूल को अपने कैलेंडर से संचालित कर सकें।

समर्थित प्रदाता

प्रदाता	वीडियो लिंक स्वचालित रूप से संलग्न	क्या बनाया जाता है
Google Calendar	Google Meet	प्रति पाठ एक इवेंट, आवर्ती श्रृंखला के लिए मास्टर इवेंट
Microsoft Outlook / Teams	Microsoft Teams	प्रति पाठ एक इवेंट, प्रति आवर्ती घटना एक इवेंट

आप एक समय में एक कैलेंडर प्रदाता कनेक्ट कर सकते हैं। स्विच करने के लिए, पहले सेटिंग्स → एकीकरण के तहत वर्तमान को डिस्कनेक्ट करें।

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

सेटिंग्स → एकीकरण, या शेड्यूलिंग → Google Calendar कनेक्ट करें पर जाएं।
Google Calendar कनेक्ट करें पर क्लिक करें।
अपने Google खाते से साइन इन करें और Voilà को इवेंट पढ़ने और लिखने के लिए अधिकृत करें।
आपका कैलेंडर तुरंत सिंक करना शुरू कर देता है।

जिस क्षण आप कनेक्ट करते हैं क्या होता है: हर पुष्ट भविष्य का Voilà पाठ आपके Google Calendar पर पुश हो जाता है — प्रत्येक Google Meet लिंक, पूर्व-भरे गए उपस्थित लोगों, और "Voilà के माध्यम से बुक किया गया" बॉडी के साथ। करने के लिए कुछ और नहीं है।

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

सेटिंग्स → एकीकरण, या शेड्यूलिंग → Outlook Calendar कनेक्ट करें पर जाएं।
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à पाठों को आपके नए कैलेंडर पर पुश करता है (और आपके मौजूदा कैलेंडर व्यस्त समय को वापस आयात करता है)।
मैन्युअल रिफ्रेश शेड्यूलिंग पृष्ठ से उपलब्ध है — परीक्षण के लिए या यदि वेबहुक ने संक्षेप में डिलीवरी मिस की हो तो उपयोगी।

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

कैलेंडर के माध्यम से रद्दीकरण नीति और रिफंड

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

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

गोपनीयता और स्कोप

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

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

टोकन समाप्त हो गया

यदि सिंक रुक जाता है, तो OAuth टोकन संभवतः समाप्त हो गया है। सेटिंग्स → एकीकरण खोलें और पुनः कनेक्ट करें पर क्लिक करें।

सिंक देरी

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

गैर-Voilà इवेंट के साथ संघर्ष

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

प्रदाता स्विच करना

एक समय में केवल एक कैलेंडर कनेक्ट किया जा सकता है। सेटिंग्स → एकीकरण के तहत 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à इवेंट के साथ संघर्ष​

प्रदाता स्विच करना​

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

संबंधित​