مرجع واجهة API وروابط Webhook وخوادم الأدوات المخصصة (MCP)
واجهة REST API، وروابط Webhook الموقّعة، وإجراءات OpenAPI المخصصة، وخوادم الأدوات المخصصة عبر بروتوكول MCP (حتى 128 أداة) لزملاء الذكاء الاصطناعي.
نظرة عامة
يوفّر Teammates.ai واجهة REST API، وروابط Webhook موقّعة، وإجراءات OpenAPI مخصصة، وخوادم أدوات مخصصة عبر بروتوكول MCP (حتى 128 أداة لكل خادم) للتحكم البرمجي وتوسيع قدرات زملاء الذكاء الاصطناعي عبر المحادثات وجهات الاتصال وأدوات الربط. تعتمد جميع نقاط النهاية على مصادقة رموز Bearer وتُعيد استجابات بصيغة JSON.
المصادقة
تتطلب جميع طلبات API تمرير رمز Bearer في ترويسة Authorization. احصل على الرموز عبر مسار المصادقة المعتمد في المنصة أو من «إعدادات المؤسسة» > «API». ويتكوّن الرابط الأساسي من رابط لوحة التحكم لمؤسستك متبوعًا بالمسار /api/v1/.
- 1
احصل على رمز الوصول
سجّل الدخول عبر مسار المصادقة في لوحة التحكم، أو أنشئ رمز API من «إعدادات المؤسسة» > «API».
- 2
أضف ترويسة Authorization
أضف الترويسة إلى كل طلب API بالصيغة: Authorization: Bearer {your_access_token}
- 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 لرفع حدود المعدل ضمن الخطة المؤسسية.
الأسئلة الشائعة
هل يمكنني بناء أدوات ربط مخصصة؟
هل تتوفر مجموعة جاهزة على Postman؟
هل تستهلك طلبات API رصيدًا؟
أدلة ذات صلة
جاهز لتجربة أدوات الربط؟
إطلاق مجاني لنشاطك التجاري الأول أو إعداد مجاني لنشاطك القائم مع 5 أرصدة للبدء، دون بطاقة ائتمان.
هل كان هذا المقال مفيدًا؟

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