Google Calendar

حالة التوفر#

Google Calendar غير متاح للجميع بعد. إلى أن يتم تفعيله، يعرض الوكيل ← الإجراءات ← Google Calendar عبارة «قريبًا»، ويظل الربط غير متاح؛ ولا يمكن لإعداد في الوكيل تفعيله. يبقى Cal.com خيارًا منفصلًا.

ربط تقويم#

عند التفعيل، افتح لوحة Google Calendar واختر ربط. سجّل الدخول إلى Google وراجع الأذونات المطلوبة لأحداث التقويم ولتوفر الأوقات (مشغول/متاح). هذا الربط منفصل عن تسجيل الدخول إلى Make Agent Fast. يخزّن الخادم رمز التحديث (refresh token) مشفّرًا، ولا تتلقاه لوحة التحكم ولا الوكيل.

النطاقات المطلوبة هي calendar.events وcalendar.freebusy إضافةً إلى النطاقين غير الحساسين openid وemail. تتطلب دالة الاستدعاء (callback) بريدًا إلكترونيًا موثّقًا وتخزّنه مشفّرًا لكي تُطابق primary معرّف التقويم نفسه المكتوب بالبريد الإلكتروني الصريح. لا يُطلب أي نطاق للملف الشخصي. يجب على أصحاب الاتصالات الأقدم التي لا تحتوي على بريد إلكتروني موثّق قطع الاتصال ثم إعادة الربط قبل الحجز.

يستخدم الوكيل مزوّد تقويم واحدًا في كل مرة. اقطع اتصال المزوّد الحالي قبل التبديل. اختر معرّف التقويم (primary للتقويم الأساسي للحساب المتصل) ومنطقته الزمنية بصيغة IANA، مثل Asia/Seoul. يجب أن يكون التقويم المشترك متاحًا بأذونات الحساب المتصل. يؤدي قطع الاتصال إلى إلغاء منح Google وإزالة الربط، ولا يلغي الأحداث الموجودة.

تحديد ساعات العمل#

لا تحتوي الاتصالات الجديدة على ساعات عمل، لذلك لا تُعرض أي مواعيد إلى أن تضيفها. أضف نوافذ الفتح والإغلاق لكل يوم عمل من أيام الأسبوع. اليوم الذي لا يحتوي على نوافذ يُعدّ يوم إغلاق؛ ويمكن استخدام عدة نوافذ غير متداخلة لتمثيل استراحة الغداء. تُفسَّر الساعات وفق المنطقة الزمنية المحددة. تُحفظ الإعدادات تلقائيًا.

التوفر هو ساعات العمل مطروحًا منها الفترات المشغولة في التقويم المحدد، والفاصل، والحد الأدنى للإشعار المسبق، ونطاق الحجز المستقبلي. اضبط الساعات وفق المنطقة الزمنية المقصودة للتقويم، وتحقق من فترات التحول إلى التوقيت الصيفي عند الاقتضاء. قد يعني غياب المواعيد أن الساعات مغلقة أو أن الوقت مشغول، وليس بالضرورة وجود خطأ في الاتصال.

من التوفر إلى الحجز#

يستخدم الوكيل مسار find_slots وbook_slot نفسه المستخدم مع Cal.com: يعرض حتى ثمانية أوقات متاحة، ويجمع الاسم والبريد الإلكتروني وملاحظة اختيارية، ثم يعيد التحقق من الموعد المختار، ثم يعرض بطاقة تأكيد. تنتهي صلاحية العروض والمقترحات بعد 15 دقيقة، ولا يحجز أيٌّ منهما الموعد. ولا يخوّل الحجز إلا نقر العميل على الزر. أما قول «نعم» شفهيًا أثناء مكالمة مباشرة فلا يمكنه إتمام الحجز.

بعد التأكيد، يتلقى Google حدثًا بمعرّف حتمي مرتبط بتشغيل الإجراء، ويرسل دعوات إلى الحاضرين. ينتج عن الحدث المؤكد الذي جرى التحقق منه إيصال مكتمل، بينما تبقى الأحداث المبدئية قيد الانتظار. إذا كان الموعد قد حُجز، فاطلب أوقاتًا جديدة وأكّد مرة أخرى. وإذا كانت نتيجة الشبكة غير مؤكدة، يجري التحقق منها باستخدام معرّف الحدث نفسه؛ لا تعدّ انتهاء المهلة نجاحًا، ولا تُنشئ حجزًا آخر دون تحقق. تؤدي تغييرات الإعدادات إلى إبطال العروض والمقترحات الأقدم.

لتلقي إشعار عند توفر وقت جديد، استخدم المراقبة بموافقة العميل. قبل الاستخدام الفعلي مع العملاء، تحقق من حجز حقيقي ودعوة في Google، وجرّب موعدًا محجوزًا، وتحقق من قطع الاتصال وإعادة الربط ومن قناة المراسلة المقصودة.