curl --request POST \
--url 'https://api.scanova.io/lead/L9c2f4a1e/convert/' \
--header 'Authorization: YOUR_API_KEY'
{
"id": 512,
"form_id": "F3b9c1a2",
"lead_id": "L9c2f4a1e"
}
العملاء المحتملون والنماذج
تحويل قائمة عملاء محتملين إلى نموذج
POST /lead//convert/
POST
/
lead
/
{lead_id}
/
convert
/
curl --request POST \
--url 'https://api.scanova.io/lead/L9c2f4a1e/convert/' \
--header 'Authorization: YOUR_API_KEY'
{
"id": 512,
"form_id": "F3b9c1a2",
"lead_id": "L9c2f4a1e"
}
ينقل قائمة عملاء محتملين قديمة إلى نموذج — أداة بناء التقاط العملاء المحتملين الحالية والموصى بها من Scanova.
عند تحويل قائمة عملاء محتملين:
يُعاد
يتطلب مفتاح واجهة برمجة تطبيقات إدارة بحصة
MANAGEMENT_API (أو MANAGEMENT_API_SANDBOX)، يُرسَل كقيمة خام لترويسة Authorization — راجع نظرة عامة على واجهة برمجة التطبيقات للإدارة.string
مطلوب
معرّف
lead_id لقائمة العملاء المحتملين. لا يوجد نص طلب.curl --request POST \
--url 'https://api.scanova.io/lead/L9c2f4a1e/convert/' \
--header 'Authorization: YOUR_API_KEY'
{
"id": 512,
"form_id": "F3b9c1a2",
"lead_id": "L9c2f4a1e"
}
- يُنشأ نموذج جديد من تعريفات حقول قائمة العملاء المحتملين.
- تُعاد ربط كل رمز QR المرفق حاليًا بقائمة العملاء المحتملين بالنموذج الجديد بدلاً من ذلك.
- تُنقل وظائف webhook النشطة إلى آلية webhook الخاصة بالنموذج (تُوسم وظائف webhook الخاصة بقائمة العملاء المحتملين نفسها كغير نشطة).
- تُنقل أي إشعارات عملاء محتملين مُهيَّأة لهذه القائمة إلى إشعارات النموذج.
- تُوسم قائمة العملاء المحتملين بـ
is_converted: true— من هذه اللحظة فصاعدًا لا تظهر بعد الآن في سرد قوائم العملاء المحتملين أو سرد قوائم العملاء المحتملين النشطة، وتمر التعديلات/الإدخالات/التصديرات الإضافية عبر أطراف النماذج بدلاً من ذلك.
هذه العملية ليست غير قابلة للتكرار بشكل ودّي: استدعاء التحويل مرة ثانية على قائمة عملاء محتملين تم تحويلها بالفعل يُعيد
404، لأن البحث يُصفّي القوائم غير المحوَّلة. لا يوجد “تراجع” — تحقق من is_converted (عبر جلب قائمة عملاء محتملين، والذي سيُعيد 404 بمجرد التحويل) قبل إعادة المحاولة.400 تحت data إذا فشلت بيانات النموذج المحوَّلة بشكل غير متوقع في التحقق من مخطط النموذج (حالة حدّية نادرة ناتجة عن انحراف الشكل، لا ينبغي أن تُثيرها عادةً قائمة عملاء محتملين جيدة التكوين).
ذو صلة
- سرد قوائم العملاء المحتملين — قوائم العملاء المحتملين المؤهلة للتحويل.
- إدارة النماذج — أين يقيم المورد المحوَّل بعد ذلك.
- نظرة عامة على واجهة برمجة التطبيقات للإدارة — مخطط المصادقة وبنية الحصص التي ينتمي إليها هذا الطرف.
التفويضات
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.
هل كانت هذه الصفحة مفيدة؟