> ## 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.

# أدوات مخصصة لوسط المكالمة

> تعلم كيفية إنشاء وتكوين تكاملات API مخصصة يمكن لمساعدك الذكي استخدامها أثناء المكالمات

<Note>
  أدوات وسط المكالمة المخصصة تسمح لمساعدك الذكي بالتفاعل مع الأنظمة الخارجية أثناء المكالمات. سواء كان ذلك لتحقق المخزون، أو التحقق من بيانات العميل، أو جلب معلومات في الوقت الفعلي، فإن هذه الأدوات تجعل مساعدك الذكي أكثر قوة واتصالًا.
</Note>

## **نظرة عامة**

أدوات وسط المكالمة المخصصة تمكن مساعدك الذكي من:

* إجراء مكالمات API في الوقت الفعلي أثناء المحادثات
* جلب أو إرسال البيانات إلى أنظمةك
* اتخاذ قرارات مستنيرة بناءً على البيانات الحية
* تقديم معلومات دقيقة، محدثة لصالح المتصلين

<Card title="الفوائد الرئيسية" icon="star" color="#00f60e">
  لا يلزم أي كود - فقط قم بتكوين نقطة النهاية والparameters - يعرف مساعدك الذكي تلقائيًا متى وكيف استخدام الأدوات - الوصول إلى البيانات في الوقت الفعلي أثناء المكالمات - التكامل السلس مع أنظمةك الحالية
</Card>

## **إعداد أداتك**

### 1. التكوين الأساسي

![تكوين الأداة الرئيسي](https://mintlify.s3.us-west-1.amazonaws.com/robocallz/resources/mid-call.png)

### الوصول إلى إنشاء الأداة

توجه إلى **أدوات وسط المكالمة** وانقر على **إنشاء أداة وسط المكالمة**

### تكوين الإعدادات الرئيسية

املأ التفاصيل الأساسية:

* **الاسم**: استخدم الأحرف الصغيرة والشرطات (مثل `check_order_status`)
* **الوصف**: شرح متى وكيف يجب أن يستخدم مساعدك الذكي هذه الأداة
* **نقطة النهاية**: عنوان URL API الخاص بك (مثل `https://api.yourcompany.com/orders`)
* **الtimeout**: مدة الانتظار للاستجابات (بالثواني)
* **الطريقة**: اختر GET، POST، PUT، PATCH، أو DELETE

### إضافة رؤوس

رؤوس شائعة قد تحتاجها:

```yaml theme={null}
Content-Type: application/json
Authorization: Bearer your_token
```

### **2. تكوين المتغيرات**

![تكوين المتغيرات](https://mintlify.s3.us-west-1.amazonaws.com/robocallz/resources/mid-call-param.png)

**تعريف المعلمات**

هذه هي قطع المعلومات التي سيجمعها مساعدك الذكي أثناء المكالمة:

```yaml theme={null}
Name: order_number
Type: string
Description: "رقم الطلب البالغ 10 أرقام من العميل"
```

### إعداد قواعد التحقق

أضف متطلبات الشكل في الوصف:

```yaml theme={null}
"تاريخ في صيغة dd/mm/yyyy"
"رقم هاتف بدون مسافات"
"عنوان بريد إلكتروني للتأكيد"
```

### فهم أنواع المتغيرات

<Warning>
  عندما تستخدم متغيرات في عنوان URL الخاص بك، تأكد من إحاطتها بالعوامل المزدوجة واستخدام اسم المتغير الدقيق.
</Warning>

يمكنك جعل نهاياتك ديناميكية باستخدام متغيرات:

```yaml theme={null}
URL الأساسي:
https://api.example.com/orders/status

مع المتغيرات:
https://api.example.com/orders/{order_id}/status
```

سيستبدل مساعدك الذكي تلقائيًا `{order_id}` بقيمة حقيقية جمعت أثناء المحادثة.

## **تجربة سهلة**

<Card title="التجربة التلقائية" icon="vial">
  انقر على “تجربة الأداة” لتشغيل تجربة مع بيانات وهمية:

  * معلمات السلسلة: “تجربة”
  * معلمات الرقم: 1
  * معلمات البوليان: صحيح

  سترى رمز الاستجابة والجسم، مما يساعدك على التحقق من أن كل شيء يعمل.
</Card>

## **ميزة المستخدم القوي: تكامل منصة الأتمتة**

<Note>
  تحتاج إلى منطق أكثر تعقيدًا؟ قم بتكامل أداتك مع منصة الأتمتة لWORKFLOWS متقدمة.
</Note>

هنا كيفية إنشاء تكاملات قوية:

1. في منصة الأتمتة:
   * أنشئ تدفقًا جديدًا
   * أضف مُحفز webhook
   * بني منطقك (مثل مكالمات API، تحويل البيانات، إلخ)
   * انتهي بـ “إرجاع الاستجابة”
2. في أداتك المخصصة:
   * استخدم عنوان URL webhook كنقطة نهاية
   * أضف `/sync` في النهاية
   * مثال: `https://automation.robocallz.ai/webhook/abc123/sync`

هذا يسمح لك:

* تحويل البيانات قبل/بعد مكالمات API
* إجراء مكالمات API متعددة في تسلسل
* تطبيق منطق أعمال معقد
* التعامل مع الأخطاء بسهولة

## **أمثلة من العالم الحقيقي**

<Accordion title="نظام البحث عن الطلبات" icon="magnifying-glass">
  ```yaml theme={null}
  Name: check_order
  Endpoint: https://api.yourshop.com/orders/{order_number}
  Parameters:
    - Name: order_number
      Type: string
      Description: "مرجع الطلب (صيغة: ORD-XXXXX)"

  ```

  سيفعل مساعدك الذكي:

  1. يسأل عن رقم الطلب
  2. يجلب الحالة
  3. يشرح التواريخ والحالة لصالح العميل
</Accordion>

<Accordion title="توفر المواعيد" icon="calendar">
  ```yaml theme={null}
  Name: check_slots
  Endpoint: https://api.calendar.com/availability
  Parameters:
    - Name: service
      Type: string
      Description: "نوع الخدمة (قص الشعر، التدليك، الاستشارة)"
    - Name: date
      Type: string
      Description: "التاريخ المفضل (dd/mm/yyyy)"

  ```

  سيفعل مساعدك الذكي:

  1. يسأل عن النوع المطلوب من الخدمة
  2. يحصل على التاريخ المفضل
  3. يظهر المواعيد المتاحة
</Accordion>

<Accordion title="Customer Verification" icon="calendar">
  ```yaml theme={null}
  Name: verify_customer
  Endpoint: https://api.crm.com/verify
  Parameters:
    - Name: phone
      Type: string
      Description: "10-digit phone number"
    - Name: email
      Type: string
      Description: "Email address for verification"

  ```

  The AI will:

  1. Collect contact details
  2. Verify against your CRM
  3. Proceed based on verification status
</Accordion>

## **Configuring Your AI**

<Info>
  The AI needs clear instructions in its system prompt to effectively use your custom tools.
</Info>

Example prompt section:

```yaml theme={null}
When to use check_order tool:
1. Customer asks about order status
2. Mentions tracking or delivery
3. Wants to know where their package is

How to use it:
1. Ask for order number if not provided
2. Verify format (ORD-XXXXX)
3. Use tool to fetch status
4. Explain results in simple terms
```

<Tip>
  Test your tools with various conversation flows to ensure the AI handles all scenarios smoothly. Start with simple test calls before going live.
</Tip>