Lead Connector Logo
كل التكاملات
بنية ربط مخصصة

أنشئ تكاملات ويب هوك موثوقة مع ليد كونكتور

استخدم الويب هوك لبدء سير عمل من نظام خارجي أو إرسال حدث CRM إلى نظام آخر، مع عقد بيانات وأمان ومنع تكرار ومراقبة.

الإجابة المختصرة

الويب هوك الوارد يبدأ سير العمل، والصادر يرسل البيانات. احمِ الرابط وتحقق من الحمولة واستخدم معرف حدث فريداً واجعل إعادة الإرسال آمنة.

ما الذي يمكنك بناؤه

  • استقبال أحداث خارجية
  • إرسال أحداث CRM
  • تحويل الحمولة عبر خادم موثوق
  • منع التكرار
  • مراقبة وإعادة الفشل
  • حفظ الأسرار خارج المتصفح

قبل أن تبدأ

  • تحديد المصدر والوجهة
  • رابط HTTPS موثوق
  • مصادقة أو توقيع
  • مخطط JSON
  • معرف حدث وسياسة إعادة
  • سجلات دون أسرار

خطة التنفيذ خطوة بخطوة

1

اختر الاتجاه

الوارد يبدأ سير العمل والصادر يرسل الحدث.

2

اكتب عقد الحدث

وثق النوع والإصدار والمعرفات والوقت والحقول والاستجابات.

3

أمّن الطلب

استخدم HTTPS ورأس مصادقة وخزّن الأسرار في الخادم.

4

تحقق ووحّد

ارفض الطلب الخاطئ وعيّن الحقول المسموح بها.

5

امنع التكرار

احفظ معرف الحدث وأعد النتيجة السابقة عند تكراره.

6

راقب واستعد

سجل الحالة والوقت والأخطاء الآمنة وأعد المحاولة المؤقتة.

وصفات سير عمل عملية

ويب هوك توزيع العملاء

المحفز

إرسال حدث عميل جديد

الإجراءات

  • مصادقة
  • تحقق الحقول
  • تحديث جهة الاتصال
  • تعيين المسؤول
  • إرجاع الحالة

النتيجة

يدخل العميل إلى سير منظم مع حماية التكرار.

حدث مبيعات صادر

المحفز

تأهيل الفرصة أو تغيير المرحلة

الإجراءات

  • حمولة مختصرة
  • توقيع
  • POST
  • حفظ الاستجابة
  • إعادة المؤقت

النتيجة

يستقبل النظام الآخر حدثاً موثوقاً.

الدفع إلى تفعيل الخدمة

المحفز

دفعة ناجحة

الإجراءات

  • تأكيد المعرف
  • إرسال الحدث
  • مهمة تهيئة
  • حفظ المعالجة

النتيجة

يبدأ التفعيل بعد الدفع دون تكرار.

خريطة البيانات المقترحة

event_idمنع التكرارقيمة فريدة لكل حدث
event_typeالتوجيهlead.created
occurred_atالتدقيق والترتيبوقت ISO 8601
record_idمرجع السجلمعرف جهة الاتصال أو الدفعة
sourceالملكية والتشخيصfacebook أو billing
dataالبيانات المطلوبةالحقول اللازمة فقط

ضوابط الموثوقية والأمان

  • استخدم معرفاً ثابتاً للعميل، وغالباً البريد أو الهاتف، لتحديث السجل الحالي بدلاً من إنشاء سجلات مكررة.
  • اربط الحقول التي يحتاجها سير العمل فقط وحدد النظام المسؤول عن كل حقل.
  • أضف المرشحات وشروط الإيقاف وقواعد إعادة الدخول قبل النشر لتجنب تكرار الإجراءات.
  • اختبر بسجل واضح ثم تحقق من جهة الاتصال والفرصة والمهمة والرسالة وسجل التنفيذ.
  • قيّد صلاحيات الحسابات والرموز وأسرار الويب هوك إلى الحد الأدنى ولا تضع الأسرار في صفحة أو حمولة عامة.

استكشاف الأخطاء

Unauthorized

قارن اسم الرأس وقيمته ونطاق السر والسياق ثم دوّر السر إذا انكشف.

المعرف مفقود

استخدم معرف حدث أو معاملة حقيقياً لا قيمة ثابتة.

إعادة الأحداث الناجحة

أعد 2xx سريعاً واستخدم معالجة غير متزامنة للأعمال البطيئة.

أحداث بترتيب خاطئ

قارن الأوقات أو التسلسل ولا تحدّث الحالة ببيانات أقدم.

ملاحظة الإتاحة

قد تختلف الموصلات والأحداث والإجراءات والرسوم حسب الخطة والحساب والمنطقة. تحقق من الخيارات الظاهرة في حسابك واختبرها قبل النشر.

أسئلة شائعة

ما الفرق بين الوارد والصادر؟

الوارد يستقبل حدثاً ويبدأ سير العمل، والصادر يرسل بيانات السير إلى نقطة أخرى.

كيف أمنع التكرار؟

استخدم معرف حدث فريداً واحفظ النتيجة ولا تكرر الآثار.

أين أخزن الأسرار؟

في متغيرات خادم أو مدير أسرار فقط، وليس في الصفحة أو الرابط أو المستودع.

هل أعيد النجاح قبل اكتمال العمل؟

للعمل البطيء اقبل الحدث سريعاً وأكمل بشكل غير متزامن مع السجلات وإعادة المحاولة.

أدلة ذات صلة

حوّل الربط إلى عملية قابلة للقياس

اربط الحدث بالمسؤول والخطوة التالية والنتيجة، ثم اختبره قبل النشر.

ناقش الربط مع فريقنا