إنشاء قائمة عملاء محتملين

curl --request POST \
  --url 'https://management.scanova.io/lead/' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Trade Show Signup",
    "data": "{\"fields\":[{\"type\":\"email\",\"label\":\"Email\",\"required\":true}]}"
  }'

{
  "id": 205,
  "lead_id": "L9c2f4a1e",
  "name": "Trade Show Signup",
  "created": "2026-08-16T20:44:51.008000+05:30",
  "is_active": true,
  "usage_count": 0,
  "entries_count": 0,
  "linked_qrs": [],
  "modified": "2026-08-16T20:44:51.008000+05:30",
  "data": "{\"fields\":[{\"type\":\"email\",\"label\":\"Email\",\"required\":true}]}",
  "webhooks": []
}

POST

lead

curl --request POST \
  --url 'https://management.scanova.io/lead/' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Trade Show Signup",
    "data": "{\"fields\":[{\"type\":\"email\",\"label\":\"Email\",\"required\":true}]}"
  }'

{
  "id": 205,
  "lead_id": "L9c2f4a1e",
  "name": "Trade Show Signup",
  "created": "2026-08-16T20:44:51.008000+05:30",
  "is_active": true,
  "usage_count": 0,
  "entries_count": 0,
  "linked_qrs": [],
  "modified": "2026-08-16T20:44:51.008000+05:30",
  "data": "{\"fields\":[{\"type\":\"email\",\"label\":\"Email\",\"required\":true}]}",
  "webhooks": []
}

قوائم العملاء المحتملين (Lead Lists) هي ميزة التقاط العملاء المحتملين الأصلية في Scanova — تعريف نموذج (data) مُرفق بصفحة هبوط رمز QR. اسردها أو أنشئها هنا.

قوائم العملاء المحتملين ميزة قديمة. لوحة تحكم Scanova توجّه الآن حالات استخدام التقاط العملاء المحتملين الجديدة نحو النماذج بدلًا منها، والتي تغطي حالة الاستخدام نفسها “جمع بيانات الزوار من مسح رمز QR” بأداة بناء أكثر قدرة. قوائم العملاء المحتملين الحالية تستمر في العمل، ونقطة النهاية هذه غير متأثرة، لكن ابنِ عمليات تكامل جديدة على أساس النماذج ما لم تكن بحاجة تحديدًا إلى إدارة قائمة عملاء محتملين موجودة مسبقًا.

يتطلب مفتاح Management API بحصة MANAGEMENT_API (أو MANAGEMENT_API_SANDBOX)، يُرسل كقيمة خام لترويسة Authorization — راجع نظرة عامة على Management API.

curl --request POST \
  --url 'https://management.scanova.io/lead/' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Trade Show Signup",
    "data": "{\"fields\":[{\"type\":\"email\",\"label\":\"Email\",\"required\":true}]}"
  }'

{
  "id": 205,
  "lead_id": "L9c2f4a1e",
  "name": "Trade Show Signup",
  "created": "2026-08-16T20:44:51.008000+05:30",
  "is_active": true,
  "usage_count": 0,
  "entries_count": 0,
  "linked_qrs": [],
  "modified": "2026-08-16T20:44:51.008000+05:30",
  "data": "{\"fields\":[{\"type\":\"email\",\"label\":\"Email\",\"required\":true}]}",
  "webhooks": []
}

string

مطلوب

اسم قائمة العملاء المحتملين، حتى 128 حرفًا.

string

مطلوب

سلسلة نصية مُرمَّزة بصيغة JSON (وليست كائنًا خامًا) تصف حقول نموذج العملاء المحتملين. تُتحقق من صحتها مقابل مخطط نموذج العملاء المحتملين نفسه الذي تستخدمه أداة بناء قوائم العملاء المحتملين في لوحة التحكم — JSON غير صالح أو مخالفة للمخطط تعيد 400 تحت data.

boolean

افتراضي:"true"

ما إذا كان النموذج يُعرض على صفحة الهبوط.

تتضمن الاستجابة data وwebhooks (قائمة من إشعارات webhook بصيغة {id, url, created, modified}) — حقول موجودة فقط في شكل التفاصيل الذي يعيده الإنشاء/الاسترجاع، وليس في نقطة نهاية السرد أعلاه.

البدء

واجهة الإدارة — الرموز والاستخدام

واجهة الإدارة — رموز QR

واجهة الإدارة — المجلدات والوسوم

واجهة الإدارة — المستخدمون المشتركون والأدوار

واجهة الإدارة — العملاء المحتملون والنماذج

واجهة الإدارة — التحليلات والخطط

إنشاء قائمة عملاء محتملين

ذات صلة

التفويضات

الاستجابة

​ذات صلة

التفويضات

الاستجابة

ذات صلة