Skip to main content
اتصالات API هي دوال HTTP مخصصة يمكن لوكلائك استدعاؤها أثناء محادثة — للبحث عن طلب، أو إنشاء تذكرة، أو جلب حالة الحساب من الواجهة الخلفية الخاصة بك. يمكنك تعريف نقطة النهاية مرة واحدة ضمن الاتصالات ← واجهات API (/dashboard/api-connections)؛ ويمكن للوكلاء الذين أُرفق بهم الاتصال استدعاؤه بعد ذلك متى اقتضت المحادثة ذلك. هناك طريقتان لإنشاء اتصال: لصق شيء يستطيع المعالج تحليله، أو إعداد الاتصال يدويًا.

​
المسار السريع: الصق وحلّل

1

انقر على اتصال API جديد

تُفتح النافذة على المعالج. الصق نموذجًا من أمر cURL، أو مواصفات OpenAPI/Swagger، أو تصدير Postman، أو واجهة TypeScript، أو مخطط Zod في المربع.
2

انقر على تحليل

يستنتج ThunderPhone الاتصال بالكامل من المحتوى الذي لصقته — عنوان URL، والطريقة، والرؤوس، ومخطط المعلمات المستمد من معلمات الاستعلام ومتن الطلب اللذين عثر عليهما. تُنقل الرؤوس التي لصقتها (بما في ذلك رؤوس المصادقة) إلى إعدادات نقطة النهاية.
3

أكّد الحقول المميزة

يُفتح الإعداد المستنتج مع تمييز الحقول التي تم تخمينها لمراجعتها. عدّل الأسماء والأوصاف وأنواع المعلمات لكي يفهم الوكيل متى وكيف يستدعي الدالة — فالوصف هو ما يقرؤه النموذج.
4

التحقق والحفظ

يؤدي الحفظ أولًا إلى تشغيل طلب اختبار مباشر على نقطة النهاية الخاصة بك. إذا فشل الطلب، فلن يُحفظ الاتصال — أصلح عنوان URL أو رؤوس المصادقة أو المتن ثم حاول مجددًا. عند النجاح، يُخزَّن الاتصال بشارة تم التحقق.
إذا لم يتمكن المعالج من العثور على عنوان URL للطلب في المحتوى الذي لصقته، فسيُبلغك بذلك — أدرج نقطة نهاية كاملة بصيغة http(s) ثم حاول مجددًا.

​
الإعداد اليدوي

انقر على إعداد يدويًا → في المعالج (أو هل تريد أن يستنتج الذكاء الاصطناعي ذلك؟ جرّب المعالج → للعودة). يتضمن منشئ الإعداد اليدوي محررين:
  • مرئي — حقول نموذج للاسم المعروض واسم الدالة وطلب URL والطريقة (POST، GET، PUT، PATCH، DELETE) والرؤوس المخصصة ومخطط المعلمات (إضافة خاصية لكل وسيطة يمكن للوكيل توفيرها).
  • JSON — التعريف نفسه بصيغة JSON خام، للصق مواصفات أداة أو ضبطها بدقة مباشرةً.
تتيح لك لوحة اختبار الطلب (اختيارية) إرسال الطلب المُعدّ قبل الحفظ، وتعرض الحالة ووقت الاستجابة ومعاينة للرد. يُشغّل التحقق والحفظ هذا الاختبار دائمًا ولا يحفظ إلا عند النجاح.
امنح المعلمات أوصافًا بلغة واضحة (“عنوان البريد الإلكتروني للعميل، مثلًا jane@example.com”). يختار الوكيل الوسائط من هذه الأوصاف في الوقت الفعلي، أثناء المكالمة.

​
إدارة اتصالاتك

يعرض كل صف اتصال حالة التحقق الخاصة به — تم التحقق، غير مختبَر، أو خطأ — واسم دالته، والوكلاء الذين يستخدمونه. من قائمة إجراءات الصف، يمكنك:
  • تعديل — إعادة فتح الإعدادات.
  • استنساخ — تكراره كنقطة بداية (تبدأ النسخة غير مختبَرة).
  • سجل المراجعات — عرض الإصدارات السابقة واستعادة أحدها إلى المحرر.
  • نقل — نسخ الاتصال أو نقله إلى مؤسسة أخرى تنتمي إليها. تؤدي نقله إلى إزالته من هنا؛ وقد تحتاج الوكلاء التي استخدمته إلى إعادة الإعداد.
  • حذف — دائم؛ ستحتاج الوكلاء التي تستخدم الاتصال إلى إعادة الإعداد.

​
إرفاقه بوكيل

أضف الاتصال إلى وكيل في قسم اتصالات API في المنشئ (إنشاء وكيل). تعرض القائمة الوكلاء الذين يستخدمون كل اتصال، لكي تعرف بنظرة سريعة ما الذي سيؤثر فيه أي تغيير.

​
الخطوات التالية

تكاملات الأدوات عبر API

أنشئ الاتصالات نفسها وأدرها برمجيًا.

ربط التطبيقات

اتصالات مُعدة مسبقًا مع Google وSlack وHubSpot وSalesforce وCal.com.

إضافة خادم MCP

أتح خادم أدوات كاملًا لوكلائك.

مرجع API للتكاملات

كل حقل في مورد التكامل.