يشرح هذا الدليل كيفية ربط Cal.com مع NewAge Ai، وربط تقاويمك ومزودي الاجتماعات، واستخدام Cal.com الإجراءات داخل أتمتة روبوتات الدردشة الخاصة بك.

سجل الدخول إلى حسابك Cal.com. اذهب إلى الإعدادات. في قسم المطورين، اضغط على مفاتيح API. هناك، يمكنك إنشاء مفتاح API. أنشئ المفتاح وانسخه فورا.
يمكنك الذهاب مباشرة إلى قسم مفاتيح API باستخدام هذا الرابط:

app.cal.com

ستستخدم هذا المفتاح داخل NewAge Ai لربط حسابك.

سجل الدخول إلى لوحة تحكم NewAge Ai الخاصة بك. اذهب إلى التكاملات. ابحث عن Cal.com في قائمة التكاملات. الصق مفتاح واجهة برمجة التطبيقات الخاصة بك. انقر على الاتصال

بمجرد الاتصال، سيظهر رمز تم التحقق منه بنجاح. سيتم عرض بريدك الإلكتروني Cal.com واسم المستخدم الخاص بك. هذا يؤكد أن الاتصال نشط.

بعد التكامل، يمكنك استخدام الإجراءات التالية داخل تدفقات الأتمتة.

يسترجع تفاصيل ملف المستخدم Cal.com المتصل بهم.

البيانات المرتجعة: الاسم، البريد الإلكتروني، المنطقة الزمنية، يوم بدء الأسبوع، إلخ.

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

ينشئ رابط حجز لنوع الحدث والحضور المحدد.

الحقول المطلوبة: معرف نوع الحدث، اسم الحضور، بريد الحضور الإلكتروني

البيانات المرتجعة: رابط الحجز

متى تستخدم: استخدم هذا عندما تريد من المستخدمين اختيار فترة زمنية يدويا عبر رابط مشترك.

الحقول المطلوبة: معرف نوع الحدث

الحقول الاختيارية: وقت البدء (تنسيق ISO 8601)، وقت النهاية (تنسيق ISO 8601)، بريد الحضور الإلكتروني، اسم الحضور، إلخ.

البيانات المرتجعة: معرف الحجز، رقم التعريف الخاص، المسمى، الوصف، الحالة، إلخ.

متى تستخدم: استخدم هذا للتحقق من الحجوزات الحالية أو تصفية الحجوزات ضمن نطاق زمني معين.

الحقول المطلوبة: معرف نوع الحدث، وقت البدء (تنسيق ISO 8601)، بريد الحضور الإلكتروني، اسم الحضور

الحقول الاختيارية: هاتف الحضور، المنطقة الزمنية للحضور، لغة الحضور، وغيرها.

البيانات المرتجعة: معرف الحجز، UID، العنوان، عنوان الاجتماع، تفاصيل الحدث، وقت البدء، إلخ.

متى تستخدم: هذا هو الوقت الذي يتولى فيه روبوت الدردشة الجدولة الكاملة تلقائيا.

الحقل المطلوب: رقم الحجز

البيانات المرتجعة: تفاصيل الحجز الكاملة، بما في ذلك معلومات الحدث، الحضور، والاجتماع.

متى تستخدم: استخدم هذا عندما تحتاج إلى معلومات كاملة لحجز معين.

الحقول المطلوبة: معرف الحجز UID، وقت بدء جديد (تنسيق ISO 8601)، إعادة جدولة حسب (البريد الإلكتروني)

حقل اختياري: سبب إعادة الجدولة

متى يجب استخدامه: استخدم هذا عندما يرغب المستخدم في تغيير موعده.

إلغاء حجز قائم.

الحقل المطلوب: رقم الحجز

الحقول الاختيارية: سبب الإلغاء، إلغاء الحجوزات التالية

متى تستخدم: استخدم هذا عندما يحتاج الحجز إلى الإلغاء.

ضع علامة على الحضور كغائب ("غياب الحضور") لاجتماع محدد مجدول. يمكنك أيضا تمييز غياب المضيف.

الحقل المطلوب: رقم الحجز

متى تستخدمه: تتبع حالات عدم الحضور. يتيح للأنظمة الآلية تسجيل متى يفشل المدعو في حضور فعالية مجدولة.

يؤكد حجزا يتطلب موافقة.

الحقل المطلوب: رقم الحجز

متى تستخدم: استخدم عندما تتطلب الحجوزون تأكيدا يدويا.

يرفض طلب الحجز.

الحقل المطلوب: رقم الحجز

حقل اختياري: سبب الانخفاض

متى تستخدم: تستخدم عندما لا يمكن قبول طلب الحجز.

يسترجع التقويم وروابط الاجتماعات للحجز.

الحقل المطلوب: رقم الحجز

البيانات المرتجعة: رابط Google Met، رابط Microsoft Office، رابط Outlook، ملف ICS

متى تستخدم: استخدم هذا لإرسال روابط الاجتماعات أو التقويم للمستخدمين.

يسترجع بيانات المراجع المرتبطة بالحجز.

الحقل المطلوب: رقم الحجز

البيانات المرتجعة: معرفات المرجع، البيانات الوصفية

متى تستخدم: تستخدم للتكاملات أو التتبع أو الأنظمة الخارجية.

يسترجع جميع أنواع الأحداث المتاحة.

متى تستخدم: استخدم لعرض أو اختيار أنواع الحجز المتاحة.

يسترجع تفاصيل نوع حدث معين.

الحقل المطلوب: معرف نوع الحدث

متى تستخدم: استخدمها للحصول على تفاصيل التكوين لحدث معين.

يحذف نوع حدث.

الحقل المطلوب: معرف نوع الحدث

متى تستخدم: استخدم عند إزالة أنواع الأحداث غير المستخدمة أو القديمة.

يسترجع جميع الجداول.

متى تستخدم: استخدم لعرض جميع جداول التوفر المكونة.

يسترجع الجدول الافتراضي.

متى تستخدم: تستخدم عند تطبيق قواعد التوفر الافتراضية.

يسترجع تفاصيل جدول محدد.

الحقل المطلوب: معرف الجدول

متى تستخدم: استخدمها لفحص جدول معين.

يحذف جدولا.

الحقل المطلوب: معرف الجدول

متى تستخدم: استخدمها عند إزالة الجداول التي لم تعد مطلوبة.

يجد أوقات زمنية متاحة للحجز.

الحقل المطلوب: مطلوب معرف نوع الحدث أو Event Slug، وقت البدء (تنسيق ISO 8601)، وقت النهاية (تنسيق ISO 8601)

متى تستخدم: استخدم عرض الأوقات المتاحة للمستخدمين قبل الحجز.

يحجز مؤقتا فترة زمنية معينة.

الحقل المطلوب: تفاصيل الفتحة

متى تستخدم: استخدم الاحتفاظ بفتحة قبل تأكيد الحجز.

يسترجع تفاصيل الفتحة المحجوزة.

الحقل المطلوب: معرف التعريف الوظيفي للخانات

متى تستخدم: تستخدم للتحقق من تفاصيل الحجز.

يصدر موعد مخصص.

الحقل المطلوب: معرف التعريف الوظيفي للخانات

متى تستخدم: استخدمها لتوفير فتحة إذا لم تكن محجوزة.

تحديث تفاصيل الفتحة المحجوزة.

الحقل المطلوب: معرف الفتحة UID، معرف الحدث، وقت البدء (تنسيق ISO 8601)

متى تستخدم: استخدم عند تعديل تفاصيل الحجز.