الانتقال إلى المحتوى الرئيسي
الانتقال إلى المحتوى الرئيسي

مرجع واجهة API وروابط Webhook وخوادم الأدوات المخصصة (MCP)

واجهة REST API، وروابط Webhook الموقّعة، وإجراءات OpenAPI المخصصة، وخوادم الأدوات المخصصة عبر بروتوكول MCP (حتى 128 أداة) لزملاء الذكاء الاصطناعي.

5 دقائقمحدّث 2026-11-08

نظرة عامة

يوفّر Teammates.ai واجهة REST API، وروابط Webhook موقّعة، وإجراءات OpenAPI مخصصة، وخوادم أدوات مخصصة عبر بروتوكول MCP (حتى 128 أداة لكل خادم) للتحكم البرمجي وتوسيع قدرات زملاء الذكاء الاصطناعي عبر المحادثات وجهات الاتصال وأدوات الربط. تعتمد جميع نقاط النهاية على مصادقة رموز Bearer وتُعيد استجابات بصيغة JSON.

المصادقة

تتطلب جميع طلبات API تمرير رمز Bearer في ترويسة Authorization. احصل على الرموز عبر مسار المصادقة المعتمد في المنصة أو من «إعدادات المؤسسة» > «API». ويتكوّن الرابط الأساسي من رابط لوحة التحكم لمؤسستك متبوعًا بالمسار /api/v1/.

  1. 1

    احصل على رمز الوصول

    سجّل الدخول عبر مسار المصادقة في لوحة التحكم، أو أنشئ رمز API من «إعدادات المؤسسة» > «API».

  2. 2

    أضف ترويسة Authorization

    أضف الترويسة إلى كل طلب API بالصيغة: Authorization: Bearer {your_access_token}

  3. 3

    إدارة تجديد الرمز

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

روابط Webhook

يرسل Teammates.ai روابط Webhook ويستقبلها لمزامنة البيانات لحظيًا. تستقبل الروابط الواردة الأحداث من Freshdesk وZendesk وIntercom (أحداث التذاكر) ومن HubSpot (أحداث CRM)، بينما ترسل الروابط الصادرة الإشعارات إلى Slack وMicrosoft Teams. وتتحقق المنصة من توقيع كل طلب وارد لمنع أي وصول غير مصرّح به، مع آلية مدمجة لمنع تكرار معالجة الحدث مرتين.

مهم

تحقق دائمًا من توقيعات Webhook الواردة قبل معالجتها، وارفض أي طلب يفشل في فحص HMAC. ستجد المفتاح السري لمؤسستك في «إعدادات المؤسسة» > «API».

نقاط نهاية API الرئيسية

توضح القائمة التالية أبرز فئات واجهة API المتاحة. وللاطلاع على التوثيق الكامل لنقاط النهاية ومخططات الطلبات والاستجابات، راسلنا على support@teammates.ai.

الفئةنقاط النهايةالوصف
الزملاء/api/v1/agents/عمليات الإنشاء والقراءة والتحديث والحذف (CRUD) لزملاء الذكاء الاصطناعي
المحادثات/api/v1/chat/جلسات الدردشة وسجل الرسائل
المقابلات/api/v1/interviews/جدولة المقابلات ونتائج التقييم
الحملات/api/v1/campaigns/إدارة حملات المبيعات
CRM/api/v1/crm/بوابة ربط أنظمة CRM وحالة المزامنة
أدوات الربط/api/v1/integrations/مسارات عودة OAuth وحالة الاتصال
روابط Webhook/api/v1/webhooks/معالجة طلبات Webhook الواردة

حدود معدل الطلبات

تطبّق المنصة حدًا لمعدل طلبات API لكل مؤسسة حفاظًا على استقرار الخدمة، وتسري الحدود القياسية على جميع الخطط. وإذا احتجت إلى سعة أعلى لعمليات الربط كثيفة الاستخدام، تواصل معنا عبر support@teammates.ai لرفع حدود المعدل ضمن الخطة المؤسسية.

الأسئلة الشائعة

هل يمكنني بناء أدوات ربط مخصصة؟
نعم. يمكنك استخدام واجهة REST API، أو روابط Webhook الموقّعة، أو إجراءات OpenAPI المخصصة، أو ربط خادم أدوات مخصص عن بُعد عبر بروتوكول MCP (يدعم حتى 128 أداة لكل خادم) لتوسيع قدرات زملائك بمرونة كاملة.
هل تتوفر مجموعة جاهزة على Postman؟
تواصل معنا عبر support@teammates.ai للحصول على توثيق واجهة API ومجموعات Postman الجاهزة.
هل تستهلك طلبات API رصيدًا؟
تستهلك طلبات API رصيدًا فقط عندما تُشغّل إجراءً فعليًا لدى أحد الزملاء (مثل إرسال رسائل عبر راية، أو إجراء مكالمات عبر آدم، أو بدء مقابلات عبر سارة)، أما عمليات القراءة والاستعلام فلا تستهلك أي رصيد.

أدلة ذات صلة

جاهز لتجربة أدوات الربط؟

إطلاق مجاني لنشاطك التجاري الأول أو إعداد مجاني لنشاطك القائم مع 5 أرصدة للبدء، دون بطاقة ائتمان.

استكشف أدوات الربط

هل كان هذا المقال مفيدًا؟

Raya
Adam

تحتاج مساعدة إضافية؟

اسألنا أي شيء بأي لغة. راية (الدعم) وآدم (المبيعات) يجيبانك على مدار الساعة بأكثر من 54 لغة و19 لهجة عربية.