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

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

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

نظرة عامة

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

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

الفوائد الرئيسية

لا يلزم أي كود - فقط قم بتكوين نقطة النهاية والparameters - يعرف مساعدك الذكي تلقائيًا متى وكيف استخدام الأدوات - الوصول إلى البيانات في الوقت الفعلي أثناء المكالمات - التكامل السلس مع أنظمةك الحالية

إعداد أداتك

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

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

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

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

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

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

إضافة رؤوس

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

Content-Type: application/json
Authorization: Bearer your_token

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

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

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

Name: order_number
Type: string
Description: "رقم الطلب البالغ 10 أرقام من العميل"

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

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

"تاريخ في صيغة dd/mm/yyyy"
"رقم هاتف بدون مسافات"
"عنوان بريد إلكتروني للتأكيد"

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

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

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

URL الأساسي:
https://api.example.com/orders/status

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

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

تجربة سهلة

التجربة التلقائية

انقر على “تجربة الأداة” لتشغيل تجربة مع بيانات وهمية:

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

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

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

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

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

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

هذا يسمح لك:

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

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

نظام البحث عن الطلبات

Name: check_order
Endpoint: https://api.yourshop.com/orders/{order_number}
Parameters:
  - Name: order_number
    Type: string
    Description: "مرجع الطلب (صيغة: ORD-XXXXX)"

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

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

توفر المواعيد

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. يظهر المواعيد المتاحة

Customer Verification

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

Configuring Your AI

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

Example prompt section:

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

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