إنتقل إلى المحتوى الرئيسي

Webhooks الصادرة

Webhooks الصادرة تدفع بيانات العملاء المحتملين من LeadHub إلى رابط URL خارجي كلما وقع حدث متعلق بعميل محتمل. استخدمها لمزامنة العملاء المحتملين مع CRM، أو تشغيل سير عمل Zapier، أو إشعار الأنظمة الخارجية.

كيف تعمل Webhooks الصادرة​

  1. تنشئ webhook صادرًا برابط URL مستهدف والأحداث التي تريد الاستماع إليها.
  2. عند وقوع الحدث المحدد (مثل: إنشاء عميل محتمل جديد)، يُرسل LeadHub طلب HTTP POST إلى رابطك.
  3. الحمولة عبارة عن كائن JSON يحتوي على بيانات العميل المحتمل الكاملة.

إنشاء Webhook صادر​

  1. انتقل إلى التكاملات ← Webhooks الصادرة.
  2. انقر Webhook صادر جديد.
  3. اضبط الإعدادات:
الحقلالوصف
الاسماسم داخلي (مثل: "مزامنة مع HubSpot")
الرابطنقطة النهاية الخارجية التي تستقبل POST
الأحداثالأحداث التي تُشغّل هذا الـ webhook
السرسر HMAC اختياري للتحقق من توقيع الطلب
نشطزر تبديل للتفعيل أو التعطيل
  1. انقر حفظ.

الأحداث المتاحة​

الحدثمتى يُشغَّل
lead.createdإنشاء سجل عميل محتمل جديد
lead.updatedتعديل عميل محتمل
lead.deletedحذف عميل محتمل
lead.stage_changedانتقال عميل محتمل إلى مرحلة جديدة في خط الأنابيب
lead.assignedتعيين عميل محتمل لمستخدم
form.submittedاستلام إرسال نموذج

تنسيق الحمولة​

تُرسل جميع Webhooks الصادرة جسم JSON:

{
  "event": "lead.created",
  "occurred_at": "2026-04-29T10:30:00Z",
  "lead": {
    "id": 123,
    "first_name": "Jane",
    "last_name": "Smith",
    "email": "[email protected]",
    "phone": "+1-555-000-0000",
    "source": "web_form",
    "status": "new",
    "lead_score": 45,
    "pipeline": "Sales Pipeline",
    "stage": "New Lead",
    "assigned_to": "[email protected]",
    "tags": ["vip", "from-webinar"],
    "created_at": "2026-04-29T10:30:00Z"
  }
}

التحقق من توقيع HMAC​

إذا عيّنت سرًّا، يُوقّع LeadHub كل طلب بتوقيع HMAC-SHA256. يُرسَل التوقيع في رأس X-LeadHub-Signature.

للتحقق (مثال بـ PHP):

$computed = 'sha256=' . hash_hmac('sha256', $rawBody, $secret);
if (!hash_equals($computed, $_SERVER['HTTP_X_LEADHUB_SIGNATURE'])) {
    http_response_code(401);
    exit;
}

تسليم الـ Webhook وإعادة المحاولة​

يُسلّم LeadHub الـ webhooks بشكل غير متزامن عبر الطابور. إذا أعادت نقطة النهاية الخارجية استجابةً غير 2xx، تُعاد محاولة التسليم حتى 3 مرات مع تراجع أسي.

راجع سجل الـ Webhook لمراجعة تاريخ التسليم.

التعطيل مقابل الحذف​

  • التعطيل: أوقف تبديل "نشط" — لا تُرسَل أحداث، لكن يُحفظ الـ webhook.
  • الحذف: يزيل إعدادات الـ webhook نهائيًا.