Skip to main content
POST
ينقل قائمة عملاء محتملين قديمة إلى نموذج — أداة بناء التقاط العملاء المحتملين الحالية والموصى بها من Scanova.
يتطلب مفتاح واجهة برمجة تطبيقات إدارة بحصة MANAGEMENT_API (أو MANAGEMENT_API_SANDBOX)، يُرسَل كقيمة خام لترويسة Authorization — راجع نظرة عامة على واجهة برمجة التطبيقات للإدارة.
string
مطلوب
معرّف lead_id لقائمة العملاء المحتملين. لا يوجد نص طلب.
عند تحويل قائمة عملاء محتملين:
  • يُنشأ نموذج جديد من تعريفات حقول قائمة العملاء المحتملين.
  • تُعاد ربط كل رمز QR المرفق حاليًا بقائمة العملاء المحتملين بالنموذج الجديد بدلاً من ذلك.
  • تُنقل وظائف webhook النشطة إلى آلية webhook الخاصة بالنموذج (تُوسم وظائف webhook الخاصة بقائمة العملاء المحتملين نفسها كغير نشطة).
  • تُنقل أي إشعارات عملاء محتملين مُهيَّأة لهذه القائمة إلى إشعارات النموذج.
  • تُوسم قائمة العملاء المحتملين بـ is_converted: true — من هذه اللحظة فصاعدًا لا تظهر بعد الآن في سرد قوائم العملاء المحتملين أو سرد قوائم العملاء المحتملين النشطة، وتمر التعديلات/الإدخالات/التصديرات الإضافية عبر أطراف النماذج بدلاً من ذلك.
هذه العملية ليست غير قابلة للتكرار بشكل ودّي: استدعاء التحويل مرة ثانية على قائمة عملاء محتملين تم تحويلها بالفعل يُعيد 404، لأن البحث يُصفّي القوائم غير المحوَّلة. لا يوجد “تراجع” — تحقق من is_converted (عبر جلب قائمة عملاء محتملين، والذي سيُعيد 404 بمجرد التحويل) قبل إعادة المحاولة.
يُعاد 400 تحت data إذا فشلت بيانات النموذج المحوَّلة بشكل غير متوقع في التحقق من مخطط النموذج (حالة حدّية نادرة ناتجة عن انحراف الشكل، لا ينبغي أن تُثيرها عادةً قائمة عملاء محتملين جيدة التكوين).

ذو صلة

التفويضات

Authorization
string
header
مطلوب

Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. api.scanova.io) — the same key sent to the regular API host will not authenticate.

الاستجابة

201

Converted.