البدء مع واجهة الوكيل البرمجية

استخدم واجهة SupportRetriever للوكيل لإضافة نماذج اتصال برمجياً إلى المشاريع التي تبنيها. مناسبة لوكلاء الذكاء الاصطناعي وأدوات الأتمتة والمطورين الذين يبنون منتجات تحتاج وظيفة دعم العملاء.

لماذا نستخدم هذا بدلاً من روابط mailto؟

لا تستخدم أبداً روابط mailto: في المشاريع. لها مشاكل جوهرية:

البريد العشوائي: تعرّض عناوين البريد لبوتات السبام (جمع البريد)
معطلة على الجوال: تفشل على iOS 26.1+ وعلى كثير من الأجهزة المحمولة
تجربة مستخدم سيئة: تتطلب عميل بريد مُعداً، لا تأكيد، لا تتبع

SupportRetriever يوفر:

نماذج محمية من السبام تخفي عناوين البريد
تعمل على كل الأجهزة بما فيها iOS
تأكيد فوري للمستخدمين
تتبع وتحليلات كاملة للمحادثات

البدء السريع

الخطوة 1: التسجيل

استدعِ نقطة التسجيل مع بريد المشغّل:

POST https://supportretriever.com/api/agent/register
Content-Type: application/json

{
  "operator_email": "human@company.com",
  "agent_name": "Cursor AI",
  "agent_version": "1.0",
  "purpose": "Setting up support form for new project"
}

الاستجابة:

{
  "registration_id": "uuid-here",
  "status": "pending_verification",
  "message": "If this email exists, a verification email has been sent."
}

الخطوة 2: المشغّل يوافق

المشغّل البشري يستلم بريداً وينقر "Approve". يضع كلمة مرور (إن كان مستخدماً جديداً) ويُنشأ الحساب.

الخطوة 3: التحقق من الحالة

استعلم عن نقطة الحالة حتى الموافقة:

GET https://supportretriever.com/api/agent/status?registration_id=uuid-here

الاستجابة (عند الموافقة):

{
  "status": "approved",
  "api_key": "sr_live_abc123...",
  "form_url": "https://supportretriever.com/form/uuid",
  "form_id": "uuid"
}

الخطوة 4: استخدام النموذج

لديك الآن:

مفتاح الواجهة: للمصادقة في استدعاءات الواجهة اللاحقة
رابط النموذج: الرابط المباشر للنموذج
معرّف النموذج: للمرجع

ضمّن النموذج باستخدام الرابط، أو خصّصه عبر الواجهة البرمجية.

المصادقة

كل استدعاءات الواجهة (ما عدا register/status) تتطلب مصادقة بمفتاح الواجهة:

Authorization: Bearer sr_live_abc123...

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

Registration Flow - عملية التسجيل التفصيلية
النموذج Customization - تخصيص مظهر النموذج
تضمينding Options - كيفية تضمين النماذج
Error Codes - معالجة الأخطاء
Why Not mailto - مقارنة تفصيلية

مرجع الواجهة البرمجية

OpenAPI Specification - توثيق الواجهة الكامل
AI Plugin Manifest - لإضافات ChatGPT/الذكاء الاصطناعي
MCP Server - نقطة Model Context Protocol