lead_created
يُرسل بعد حفظ العميل المحتمل عندما تكون الشركة على خطة مدفوعة وقد فعّلت وجهة HTTPS صالحة وسر توقيع. ولا يؤدي فشل الإرسال إلى التراجع عن إنشاء العميل.
وثائق المطور وAPI
Webhooks العملاء المحتملين الموقعة
يدعم CardIQ مسارًا صادرًا واحدًا ومهيأً للعملاء المحتملين. ولا يوفر قائمة webhooks عامة أو API لـ webhook وارد.
التوفر والأحداث
webhook_test
يُرسل بطلب المسؤول ببيانات اختبار خاصة بالشركة فقط ودون بيانات شخصية لعميل أو موظف.
الطلب والتوقيع
يرسل CardIQ طلب POST مع Content-Type: application/json وX-CardIQ-Event وX-CardIQ-Signature. التوقيع هو ناتج HMAC-SHA256 سداسي عشري بالأحرف الصغيرة لجسم الطلب الخام نفسه باستخدام سر webhook للشركة. تحقّق من البايتات دون تعديل وبمقارنة ثابتة الزمن قبل التحليل أو المعالجة.
حقول lead_created
تحتوي الحمولة الفعلية على event_type وcompany_id وemployee_id وemployee_name وlead_name وlead_email وlead_phone وlead_message وsource وemployee_profile_url وcreated_at. تعامل مع القيم كمدخلات غير موثوقة وبيانات شخصية. أما حمولة الاختبار فتحتوي على event_type وcompany_id وcompany_name وtest وmessage وsent_at.
الإرسال وإعادة المحاولة والتشغيل
تُعد استجابة 2xx نجاحًا. عند تثبيت ترحيل إعادة المحاولة، توضع عمليات lead_created الفاشلة في قائمة لما يصل إلى ثلاث محاولات بتأخيرات فعلية 5 دقائق و30 دقيقة وساعتين. لا توضع أحداث الاختبار في القائمة. يمكن للمسؤول مراجعة بيانات الإرسال وإعادة محاولة الفشل المدرج يدويًا. لا يوجد وعد بمخطط إقرار أو ترتيب أو منع التكرار أو حد إنتاجية عام؛ لذا اجعل المعالجة قابلة للتكرار بأمان.
تابع القراءة
تحكّم في كيفية تمثيل الموظفين لشركتك خارجيًا
استكشف منصة CardIQ أو راجع سير العمل من التحقق إلى إلغاء الهوية.
كيف يعمل CardIQ عرض الأسعار