إعداد CRM Lead Webhook مع Zapier و Make

• خطة مدفوعة
  إرسال Webhook للعملاء المحتملين غير متاح على الخطة المجانية.
• رابط HTTPS
  استخدم رابط استقبال من Zapier أو Make أو CRM، ويجب أن يبدأ بـ https://.
• سر توقيع
  ينشئ CardIQ سرًا للتوقيع عند الحفظ أو التدوير. لا تضع السر داخل الرابط ولا تشاركه في التذاكر العامة.

1. أنشئ Zap جديدًا واختر Webhooks by Zapier كـ Trigger.
2. اختر Catch Hook وانسخ رابط Webhook الذي يوفره Zapier.
3. في CardIQ، افتح CRM Lead Webhook، الصق الرابط، فعّل lead_created webhook، واحفظ.
4. أرسل اختبارًا من CardIQ، ثم استخدم بيانات الاختبار في Zapier لتعيين الحقول إلى CRM أو البريد أو جدول البيانات.

1. أنشئ Scenario جديدًا في Make واختر Custom Webhook كمشغل.
2. أضف webhook جديدًا، انسخ رابط الاستقبال، ثم الصقه في إعدادات CardIQ.
3. شغّل Run once في Make، ثم أرسل Test Webhook من CardIQ لاكتشاف بنية البيانات.
4. اربط الحقول بوحدة CRM أو Google Sheets أو البريد، ثم فعّل السيناريو.

إذا كان CRM الخاص بك يوفر endpoint لاستقبال POST JSON، استخدم ذلك الرابط في CardIQ. يجب أن يدعم HTTPS وأن يقبل Content-Type: application/json.

• أدخل رابط HTTPS في Webhook URL.
• استخدم سر التوقيع للتحقق من أن الطلب جاء من CardIQ.
• حوّل الحقول مثل lead_name و lead_email و employee_name إلى حقول CRM المناسبة.

يرسل CardIQ أحداث lead_created كطلبات POST موقعة. الرؤوس تتضمن X-CardIQ-Event: lead_created و X-CardIQ-Signature. التوقيع هو HMAC SHA-256 لبيانات الطلب باستخدام السر الخاص بالشركة.

• لا يتم إرسال السر داخل JSON payload.
• دوّر السر إذا تم نسخه إلى مكان غير موثوق أو تغير فريق التكامل.
• لا تعرض روابط webhooks أو الأسرار في صفحات عامة أو لقطات شاشة دعم.

{
    "event_type": "lead_created",
    "company_id": 123,
    "employee_id": 456,
    "employee_name": "Mona Hassan",
    "lead_name": "Omar Ali",
    "lead_email": "omar@example.com",
    "lead_phone": "+1-555-0100",
    "lead_company": "Example Trading LLC",
    "source": "public_profile",
    "profile_url": "https://card-iq.net/card.php?id=456",
    "created_at": "2026-06-13T12:30:00Z"
}

1. احفظ رابط HTTPS وفعّل lead_created webhook في CardIQ.
2. استخدم زر Send Test Webhook في صفحة إعدادات CRM Lead Webhook.
3. تحقق من أن Zapier أو Make أو CRM استقبل الطلب وقرأ JSON.
4. راجع Recent Webhook Deliveries في CardIQ للتأكد من الحالة ورمز HTTP.
5. بعد نجاح الاختبار، أنشئ lead حقيقي من public profile للتأكد من تدفق lead_created.

إن فشل التسليم لا يمنع حفظ العميل المحتمل. يسجل CardIQ بيانات التسليم مثل نوع الحدث، الوجهة، رمز HTTP، الحالة، hash للpayload، وملخص خطأ قصير. لا يتم تخزين الأسرار في سجل التسليم.

تضاف حالات الفشل المؤهلة إلى retry queue للخطط المدفوعة. يمكن إعادة المحاولة بعد إصلاح رابط CRM أو إعدادات Zapier/Make، وتستخدم قائمة الانتظار فترات backoff لتجاوز الانقطاعات المؤقتة.