تكامل التقويم

اربط مرة واحدة، وأدر من كل مكان. بمجرد ربط تقويم Google أو Microsoft Outlook (Teams)، تظهر دروس Voilà على تقويمك تماماً مثل أي اجتماع آخر — وأي شيء تفعله بالحدث من تقويمك ينعكس في Voilà تلقائياً. أعد الجدولة، ألغِ، اقبل، ارفض — كلا الجانبين يبقيان متزامنين خلال ثوانٍ.

هذه الصفحة مكتوبة للمدرسين. قسم "ما يختبره طلابك" يشرح بالضبط ما يراه طلابك من جانبهم حتى تتمكن من إدارة جدولك بالكامل من تقويمك بثقة.

مقدمو الخدمة المدعومون

مقدم الخدمة	رابط الفيديو مرفق تلقائياً	ما يتم إنشاؤه
تقويم Google	Google Meet	حدث واحد لكل درس، حدث رئيسي لكل سلسلة متكررة
Microsoft Outlook / Teams	Microsoft Teams	حدث واحد لكل درس، حدث واحد لكل تكرار

يمكنك ربط مقدم تقويم واحد في كل مرة. للتبديل، افصل الحالي أولاً تحت الإعدادات ← التكاملات.

ربط تقويم Google

اذهب إلى الإعدادات ← التكاملات، أو الجدولة ← ربط تقويم Google.
انقر ربط تقويم Google.
سجل الدخول بحساب Google الخاص بك وامنح Voilà إذناً لقراءة وكتابة الأحداث.
يبدأ تقويمك بالمزامنة فوراً.

ما يحدث لحظة الربط: كل درس Voilà مستقبلي مؤكد يُدفع إلى تقويم Google الخاص بك — كل واحد برابط Google Meet، والحضور محددون مسبقاً، ونص "محجوز عبر Voilà". لا يوجد شيء آخر للقيام به.

ربط Microsoft Outlook / Teams

اذهب إلى الإعدادات ← التكاملات، أو الجدولة ← ربط تقويم Outlook.
انقر ربط تقويم Outlook.
سجل الدخول بحساب 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à
قبول الدعوة	لا شيء إضافي — هم بالفعل في الدرس. ردهم يُسجل للرؤية.
*رفض اقتراح معلق* من تقويمهم**	الاقتراح يُرفض في Voilà. تُشعر بالبريد الإلكتروني والمحادثة.
*رفض درس فردي مؤكد* من تقويمهم**	Voilà يشغل فرع إلغاء الطالب من سياسة الإلغاء. قبل الموعد النهائي = استرداد كامل أو إعادة رصيد؛ بعد الموعد النهائي = مصادرة (تحتفظ بالدفع).
رفض من درس جماعي مؤكد	مقعد ذلك الطالب فقط يُسترد؛ الدرس يستمر للجميع الآخرين (خاضع لقاعدة الحد الأدنى للمقاعد).
رفض تكرار متكرر	ذلك التكرار الواحد يُتخطى (استرداد أو مصادرة حسب سياسة الإلغاء). باقي السلسلة لا تُمس.
إعادة توجيه الدعوة لصندوق بريد آخر	لا تأثير على الدرس — Voilà هو مصدر الحقيقة، وإعادة توجيه الدعوة لا تنقل الدرس أو تعيد إصدار استردادات.

باختصار: الطلاب يمكنهم إدارة مشاركتهم بالكامل من دعوة التقويم، وستشاهد كل إجراء منعكساً على جانب Voilà خلال ثوانٍ.

الدروس الجماعية عبر التقويم

الدروس الجماعية تضيف تعقيداً إضافياً واحداً — قاعدة الحد الأدنى للمقاعد:

عضو واحد يرفض ← ذلك المقعد يُسترد، الحاضر يُزال من حدث التقويم، الدرس يستمر.
الرفض يسقط الدرس تحت min_seats قبل موعد الإلغاء النهائي ← الدرس بالكامل يُلغى، كل مقعد مدفوع يُسترد، حدث التقويم يُزال.
الرفض يسقط الدرس تحت min_seats بعد موعد الإلغاء النهائي ← الدرس يبقى (الأشخاص الذين احتفظوا بمقعدهم دفعوا بالفعل للفترة)، وتتلقى بريد تنبيه حتى تتمكن من تقرير كيفية التعامل معه.

الدروس المتكررة عبر التقويم

الدروس المتكررة تُخزن بشكل مختلف على كل مقدم، لكن التجربة هي نفسها:

Google: السلسلة هي حدث متكرر رئيسي واحد. رفض حالة واحدة من التقويم يتخطى ذلك التكرار فقط في Voilà؛ رفض الرئيسي يلغي كل تكرار مستقبلي.
Outlook: كل تكرار مربوط بشكل فردي حتى تتدفق التحديثات لكل حالة من Microsoft Graph بسلاسة. رفض تكرار واحد يتخطاه في Voilà؛ رفض السلسلة ينهي التكرارات المستقبلية.
تخطي تكرار من داخل Voilà يلغي تلقائياً حالة التقويم المطابقة مع إشعار إلغاء نظيف للحضور.
تغيير سياسة الإلغاء للمدرس لا يُطبق بأثر رجعي على التكرارات الموجودة بالفعل — كل تكرار يثبت السياسة التي كانت نشطة عند إنشائه.

كيف يتم تسليم المزامنة

Voilà يستخدم إشعارات الدفع (webhooks) كمحفز أساسي:

تقويم Google — Voilà يشترك في تقويمك عبر قناة events.watch من Google؛ التحديثات تصل خلال ثوانٍ من حفظك في تقويم Google.
Microsoft Outlook / Teams — Voilà يشترك عبر webhooks من Microsoft Graph؛ نفس السلوك.

مجموعة صغيرة من شبكات الأمان تحافظ على صحة القناة:

مهمة صيانة كل ساعة تجدد الاشتراكات قبل انتهاء صلاحيتها وتبدأ أي مراقبات مفقودة.
الملء الخلفي عند الربط يدفع دروس Voilà المستقبلية الموجودة إلى تقويمك الجديد (ويستورد عكسياً أوقات انشغال تقويمك الموجودة).
التحديث اليدوي متاح من صفحة الجدولة — مفيد إذا كنت تختبر أو إذا فوت webhook التسليم لفترة وجيزة.

الإصدارات السابقة من هذه الصفحة ذكرت "دورة استطلاع 5 دقائق". هذا لم يعد دقيقاً — المزامنة قائمة على الدفع وعادة تصل في أقل من 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: إزالة حدث التقويم

مقدمو الخدمة المدعومون​

ربط تقويم Google​

ربط Microsoft Outlook / Teams​

ما يظهر على تقويمك (Voilà ← التقويم)​

ما يتزامن عكسياً في Voilà (التقويم ← Voilà)​

تحريك وقت الحدث​

حذف أو إلغاء الحدث​

إنشاء حدث جديد مع أحد طلابك كحاضر​

إضافة أي حدث آخر لتقويمك​

ما يختبره طلابك​

الدروس الجماعية عبر التقويم​

الدروس المتكررة عبر التقويم​

كيف يتم تسليم المزامنة​

سياسة الإلغاء والاستردادات عبر التقويم​

الخصوصية والنطاق​

استكشاف الأخطاء وإصلاحها​

انتهاء صلاحية الرمز المميز​

تأخيرات المزامنة​

تعارضات مع أحداث غير Voilà​

تبديل مقدمي الخدمة​

مزامنة ثنائية الاتجاه، من البداية للنهاية​

ذات صلة​