> ## Documentation Index > Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt > Use this file to discover all available pages before exploring further. # اتصالات API > حوّل أي واجهة API عبر HTTP إلى دالة يمكن لوكيلك استدعاؤها أثناء المحادثة — الصق أمر cURL ودع المعالج يتولى الباقي. اتصالات API هي دوال HTTP مخصصة يمكن لوكلائك استدعاؤها أثناء محادثة — للبحث عن طلب، أو إنشاء تذكرة، أو جلب حالة الحساب من الواجهة الخلفية الخاصة بك. يمكنك تعريف نقطة النهاية مرة واحدة ضمن **الاتصالات ← واجهات API** (`/dashboard/api-connections`)؛ ويمكن للوكلاء الذين أُرفق بهم الاتصال استدعاؤه بعد ذلك متى اقتضت المحادثة ذلك. هناك طريقتان لإنشاء اتصال: لصق شيء يستطيع المعالج تحليله، أو إعداد الاتصال يدويًا. ## المسار السريع: الصق وحلّل تُفتح النافذة على المعالج. الصق نموذجًا من **أمر cURL**، أو **مواصفات OpenAPI/Swagger**، أو **تصدير Postman**، أو **واجهة TypeScript**، أو **مخطط Zod** في المربع. يستنتج ThunderPhone الاتصال بالكامل من المحتوى الذي لصقته — عنوان URL، والطريقة، والرؤوس، ومخطط المعلمات المستمد من معلمات الاستعلام ومتن الطلب اللذين عثر عليهما. تُنقل الرؤوس التي لصقتها (بما في ذلك رؤوس المصادقة) إلى إعدادات نقطة النهاية. يُفتح الإعداد المستنتج مع تمييز الحقول التي تم تخمينها لمراجعتها. عدّل الأسماء والأوصاف وأنواع المعلمات لكي يفهم الوكيل متى وكيف يستدعي الدالة — فالوصف هو ما يقرؤه النموذج. يؤدي الحفظ أولًا إلى تشغيل طلب اختبار مباشر على نقطة النهاية الخاصة بك. إذا فشل الطلب، فلن يُحفظ الاتصال — أصلح عنوان URL أو رؤوس المصادقة أو المتن ثم حاول مجددًا. عند النجاح، يُخزَّن الاتصال بشارة **تم التحقق**. إذا لم يتمكن المعالج من العثور على عنوان URL للطلب في المحتوى الذي لصقته، فسيُبلغك بذلك — أدرج نقطة نهاية كاملة بصيغة `http(s)` ثم حاول مجددًا. ## الإعداد اليدوي انقر على **إعداد يدويًا →** في المعالج (أو **هل تريد أن يستنتج الذكاء الاصطناعي ذلك؟ جرّب المعالج →** للعودة). يتضمن منشئ الإعداد اليدوي محررين: * **مرئي** — حقول نموذج للاسم المعروض واسم الدالة وطلب **URL** و**الطريقة** (`POST`، `GET`، `PUT`، `PATCH`، `DELETE`) و**الرؤوس** المخصصة ومخطط المعلمات (**إضافة خاصية** لكل وسيطة يمكن للوكيل توفيرها). * **JSON** — التعريف نفسه بصيغة JSON خام، للصق مواصفات أداة أو ضبطها بدقة مباشرةً. تتيح لك لوحة **اختبار الطلب** (اختيارية) إرسال الطلب المُعدّ قبل الحفظ، وتعرض الحالة ووقت الاستجابة ومعاينة للرد. يُشغّل **التحقق والحفظ** هذا الاختبار دائمًا ولا يحفظ إلا عند النجاح. امنح المعلمات أوصافًا بلغة واضحة ("عنوان البريد الإلكتروني للعميل، مثلًا [jane@example.com](mailto:jane@example.com)"). يختار الوكيل الوسائط من هذه الأوصاف في الوقت الفعلي، أثناء المكالمة. ## إدارة اتصالاتك يعرض كل صف اتصال حالة التحقق الخاصة به — **تم التحقق**، **غير مختبَر**، أو **خطأ** — واسم دالته، والوكلاء الذين يستخدمونه. من قائمة إجراءات الصف، يمكنك: * **تعديل** — إعادة فتح الإعدادات. * **استنساخ** — تكراره كنقطة بداية (تبدأ النسخة غير مختبَرة). * **سجل المراجعات** — عرض الإصدارات السابقة واستعادة أحدها إلى المحرر. * **نقل** — نسخ الاتصال أو نقله إلى مؤسسة أخرى تنتمي إليها. تؤدي نقله إلى إزالته من هنا؛ وقد تحتاج الوكلاء التي استخدمته إلى إعادة الإعداد. * **حذف** — دائم؛ ستحتاج الوكلاء التي تستخدم الاتصال إلى إعادة الإعداد. ## إرفاقه بوكيل أضف الاتصال إلى وكيل في قسم اتصالات API في المنشئ ([إنشاء وكيل](/ar/guides/build-an-agent)). تعرض القائمة الوكلاء الذين يستخدمون كل اتصال، لكي تعرف بنظرة سريعة ما الذي سيؤثر فيه أي تغيير. ## الخطوات التالية أنشئ الاتصالات نفسها وأدرها برمجيًا. اتصالات مُعدة مسبقًا مع Google وSlack وHubSpot وSalesforce وCal.com. أتح خادم أدوات كاملًا لوكلائك. كل حقل في مورد التكامل.