إعداد Webhooks

أرسِلوا الأحداث مثل العملاء المحتملين الجدد أو المواعيد تلقائيًا وبتوقيع إلى أنظمتكم الخاصة.

آخر تحقق: 2026-10-20

باستخدام Webhooks الصادرة، تُعلم Zentor App أنظمتكم فورًا عند حدوث أمر ما — مثلًا: باستخدام وحدة الأتمتة، تُرسلون عملاء محتملين جددًا عبر webhook إلى نظام CRM لديكم. تُنشئون الـ Webhooks بأنفسكم في قسم «الأتمتة» ضمن علامة التبويب «Webhooks». ويُوقَّع كل تسليم بـ HMAC-SHA256 بمفتاحكم السري، وتُعاد محاولة التسليمات الفاشلة تلقائيًا. وتنتمي Webhooks إلى الوحدة الإضافية «الأتمتة/n8n».

خطوة بخطوة

  1. فتح علامة التبويب «Webhooks»افتحوا «الأتمتة» في الشريط الجانبي واختاروا علامة التبويب «Webhooks».
  2. إنشاء Webhookأدخلوا ضمن «Webhooks الخاصة بي» اسمًا وعنوان HTTPS لنظامكم، واختاروا الأحداث، مثل «إنشاء عميل محتمل»، أو «إنشاء موعد»، أو «إلغاء موعد»، أو «إرسال نموذج»، أو «إنشاء تذكرة»، أو «تغيير حالة التذكرة»، أو «استقبال رسالة». اضغطوا على «إنشاء Webhook».
  3. حفظ مفتاح التوقيعبعد الإنشاء يُعرض مفتاح التوقيع لمرة واحدة. احفظوه بأمان — فنظامكم يتحقق به من توقيع HMAC لكل تسليم. وباستخدام «تجديد المفتاح» تنشئون مفتاحًا جديدًا عند الحاجة.
  4. تنفيذ إرسال تجريبيباستخدام «إرسال اختبار» ترسلون تسليمًا تجريبيًا إلى عنوانكم وتتحققون من قبول نظامكم له.
  5. فحص التسليماتضمن «التسليمات» ترون كل تسليم مع الحدث والحالة وعدد المحاولات والمحاولة التالية المقررة.
  6. إعادة محاولة تشغيلات سير العمل الفاشلةتُعيد Zentor App تلقائيًا محاولة تسليمات Webhook. أما إرسال البيانات عبر سير عمل باستخدام إجراء «إرسال طلب HTTP»، فتُعيدون تشغيل التشغيلات الفاشلة بأنفسكم عبر «إعادة المحاولة» في علامة التبويب «عمليات التنفيذ».

النتيجة المتوقعة

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

حالات الأخطاء الشائعة

علامة التبويب «Webhooks» غير موجودة.

السبب: الوحدة الإضافية «الأتمتة/n8n» غير محجوزة لحسابكم.

الحل: توجّهوا إلى Zentor؛ وستحصلون على عرض سعر للوحدة.

تفشل التسليمة التجريبية.

السبب: عنوانكم غير متاح، أو لا يستخدم HTTPS صالحًا، أو أن نظامكم يستجيب بخطأ.

الحل: تحققوا من عنوان نظامكم وشهادته، وتأكدوا من أنه يقبل الطلبات القادمة من الخارج. أعيدوا إرسال الاختبار بعد ذلك.

يرفض نظامي التسليمات بسبب توقيع غير صحيح.

السبب: يستخدم نظامكم مفتاح توقيع خاطئًا أو قديمًا.

الحل: أنشئوا مفتاحًا جديدًا باستخدام «تجديد المفتاح» وأدخلوه في نظامكم.

مقالات ذات صلة

← العودة إلى الفئة