> ## Documentation Index
> Fetch the complete documentation index at: https://new-fb342056.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# تخطيط المواعيد باستخدام Cal.com

> تعلم كيفية تمكين مساعد الذكاء الاصطناعي من جدولة المواعيد باستخدام تكامل Cal.com

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

<تحذير>
  لا تجعل أي حقول جديدة مطلوبة في إعدادات حدث Cal.com. التكامل يدعم فقط الحقول الافتراضية وحقل الهاتف الاختياري. إضافة حقول مخصصة مطلوبة سيسبب فشل التكامل.
</تحذير>

## **المتطلبات الأساسية**

قبل إعداد تكامل Cal.com، ستحتاج:

* حساب Cal.com (سواء كان مستضافاً أو مستضافاً ذاتياً)
* نوع حدثconfigured في Cal.com
* مفتاح API من Cal.com

## **عملية الإعداد**

[******1. إعداد Cal.com******](http://Cal.com)

1. سجل أو سجل دخول إلى حساب Cal.com الخاص بك
2. أنشئ نوع حدث جديد خصيصاً لجدولة مواعيد مساعد الذكاء الاصطناعي
   * أعطه اسم واضح مثل “اجتماع مع مساعد الذكاء الاصطناعي”
   * configure duration, availability, and other settings
3. بمجرد أنشائه، سجل رقم التعريف للحدث من URL
4. أنشئ مفتاح API:
   * انتقل إلى إعدادات Cal.com
   * انتقل إلى إعدادات المطور
   * أنشئ مفتاح API جديد
   * نسخ مفتاح API وتخزينه بأمان

### **2. معلومات الاتصال بالعملاء**

#### **إعداد البريد الإلكتروني**

لإرسال دعوات التقويم للعملاء:

1. حدد `email` في متغيرات مدخلات مساعدك
2. مرر بريد العميل كمتغير `email` عند إنشاء الرصيد
3. النظام سيستخدم هذا البريد تلقائياً لدعوات التقويم

#### **رقم الهاتف في أحداث التقويم**

لإدراج رقم هاتف المتصل في أحداث التقويم:

1. انتقل إلى إعدادات حدثك في Cal.com
2. انقر على “أضف سؤال”

![صورة توضيحية](https://mintlify.s3.us-west-1.amazonaws.com/autocalls/resources/cal-event-settings.jpeg)

أعدل الحقل مع هذه القيم الدقيقة:

* المعرف: `phone` (يجب أن يكون دقيقاً)

![](https://mintlify.s3.us-west-1.amazonaws.com/autocalls/resources/cal-phone-field.jpeg)

4. احفظ التغييرات

![](https://mintlify.s3.us-west-1.amazonaws.com/autocalls/resources/cal-save.jpeg)

### [******3. إضافة Cal.com إلى مساعدك******](http://Cal.com)

1. في إعدادات مساعد الذكاء الاصطناعي الخاصة بك، ابحث عن قسم الأدوات
2. أضف تكامل Cal.com
3. أعدل الأداة مع:
   * مفتاح API Cal.com الخاص بك
   * رقم التعريف لنوع الحدث

![](https://mintlify.s3.us-west-1.amazonaws.com/autocalls/resources/cal-tool.png)

## **أفضل الممارسات**

* أنشئ أنواع أحداث مخصصة لجدولة مواعيد مساعد الذكاء الاصطناعي لمراقبة استخدامها
* أعدل أوقات التباعد بين الاجتماعات
* configure meeting durations appropriatly
* استخدم أسماء أحداث واضحة تفي بالغرض لعملائك
* احتفظ فقط بالحقول الافتراضية وحقل الهاتف الاختياري
* دائمًا أضف بريد العميل في إنشاء الرصيد لتلقى دعوات التقويم

## **الاختبار**

بعد الإعداد، ننصح:

1. بإجراء مكالمة اختبار لمساعد الذكاء الاصطناعي
2. بطلب جدولة اجتماع
3. بالتحقق من ظهور الحجز في لوحة تحكم Cal.com الخاصة بك
4. بالتحقق من ظهور رقم الهاتف في حدث التقويم
5. بالتحقق من أن العميل يتلقى دعوة التقويم بالبريد الإلكتروني
6. بالتحقق من أن رسائل التأكيد تتلقى

## **علاج المشكلات**

إذا واجهت مشكلات:

* تحقق من أن مفتاح API نشط ولديه الصلاحيات الصحيحة
* تأكد من صحة رقم التعريف لنوع الحدث
* تحقق من أن توفر Cal.comconfigured بشكل صحيح
* تأكد من عدم إضافة حقول مخصصة مطلوبة
* تحقق من أن معرّف حقل الهاتف هو بالضبط “phone”
* تأكد من أن متغير `email` محدد بشكل صحيح في إعدادات مساعدك
* تحقق من أن بريد العميل يتم تمريره بشكل صحيح في الرصيد
* تأكد من أن إعدادات المنطقة الزمنية الخاصة بك صحيحة