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

ويب هوكس لربط متجرك مع n8n و Make و Zapier

الفئة: الأدوات  ·  أدنى خطة: غير محدود  ·  المعرّف: webhooks

إضافة الويب هوكس ترسل أحداث طلبات متجرك إلى أي أداة أتمتة تستقبل POST بصيغة JSON عبر HTTPS — سواء n8n أو Make أو Zapier أو خادمك الخاص. أضف رابط الويب هوك مرة واحدة، ويرسل DZBuild إشعارًا موقّعًا فور إنشاء طلب جديد أو تغيّر حالته، لتبني سيناريوهاتك الخاصة: مزامنة CRM، رسائل واتساب، Google Sheets، تأكيدات مخصصة، وأي شيء آخر.

شرح بالفيديو​

المميزات​

  • يعمل مع n8n و Make و Zapier أو أي خادم يستقبل POST بصيغة JSON
  • أحداث للطلبات الجديدة ولكل تغيير حالة (مؤكد، قيد المعالجة، مشحون، مُسلَّم، ملغى، مرتجع)
  • حمولات موقّعة (HMAC-SHA256) ليتحقق خادمك من مصدرها
  • إعادة محاولات تلقائية مع تباعد زمني عند تعطل خادمك
  • سجل تسليم بالحالة وعدد المحاولات والأخطاء لكل حدث
  • لكل رابط سرّه الخاص، ويمكنك تجديده في أي وقت
  • بدون أي تأثير على سرعة متجرك — الأحداث تُرسل في الخلفية

ماذا تفعل​

عند تفعيل الإضافة يظهر إدخال ويب هوكس في القائمة الجانبية، وصفحة إدارة على /dashboard/webhooks. من هناك تسجّل روابط استقبال — أي الروابط التي تعطيك إياها أداة الأتمتة.

كل رابط يستقبل الأحداث التي تختارها. والأحداث المتاحة هي:

الحدثمتى يُرسل
order.createdوصول طلب جديد إلى متجرك
order.confirmedعند ضبط الطلب على "مؤكد"
order.processingانتقال الطلب إلى قيد المعالجة
order.shippedشحن الطلب
order.deliveredتسليم الطلب
order.cancelledإلغاء الطلب
order.returnedإرجاع الطلب

كل تسليم هو POST بصيغة JSON داخل مغلّف يحمل معرّف الحدث id واسمه event وتاريخه created_at ومعرّف متجرك store_id وكائن data. وفي أحداث الطلبات يحتوي data على الطلب (رقم الطلب، الحالة، الدفع ونوع التوصيل، اسم الزبون وهاتفه، الولاية والبلدية، المجموع الفرعي والشحن والتخفيض والإجمالي، كود الخصم، رقم التتبع وشركة التوصيل) إضافة إلى قائمة عناصره.

{
  "id": "evt_...",
  "event": "order.created",
  "created_at": "2026-08-12T10:20:30+00:00",
  "store_id": 123,
  "data": { "order": { }, "items": [ ] }
}

التحقق من الرابط​

الرابط الجديد لا يستقبل أي حدث حقيقي قبل أن يثبت أنه يعمل. فور إضافته يُرسل DZBuild حدث webhook.verify، وبمجرد أن يرد رابطك بنجاح (HTTP 200) تتحوّل حالته من بانتظار التحقق إلى رابط موثّق ويبدأ استقبال أحداث طلباتك. في الغالب يحدث ذلك في النقرة نفسها، وإلا فالمحاولة تتكرر تلقائيًا خلال دقيقة عادةً.

التوقيع والترويسات​

كل حدث يحمل ترويسات يمكن لأداتك التحقق منها:

X-DZ-Token: <your endpoint secret>
X-DZ-Timestamp: 1754200000
X-DZ-Signature: t=1754200000,v1=hex( HMAC_SHA256( secret, timestamp + "." + rawBody ) )
  • تحقق بدون كود — قارن X-DZ-Token بسرّك. في n8n هذا هو خيار Header Auth الجاهز.
  • تحقق متقدم — احسب HMAC-SHA256 بسرّك على timestamp + "." + rawBody وقارنه بقيمة v1، وارفض أي طلب أقدم من 5 دقائق.

إعادة المحاولة والإيقاف التلقائي​

إذا كان خادمك متوقفًا أو ردّ بخطأ، يُعاد إرسال الحدث حتى 5 مرات بفواصل متزايدة — نحو دقيقة، ثم 5 دقائق، 30 دقيقة، ساعتين، و12 ساعة. بعدها يُسجَّل التسليم كفشل نهائي في السجل. والرابط الذي يستمر في الفشل (10 محاولات تسليم فاشلة متتالية) يُوقَف تلقائيًا، ويظهر في صفّه تنبيه يطلب منك إصلاح خادمك ثم إعادة تفعيله. وإعادة التفعيل تصفّر عدّاد الأخطاء.

الفوائد​

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

كيف تفعّلها​

  1. افتح لوحة التحكم → الإضافات على /dashboard/addons.
  2. ابحث عن ويب هوكس ضمن الأدوات.
  3. انقر تفعيل. الإضافة تتطلب خطة غير محدود (وخطة Enterprise تشملها) — وفي الخطط الأدنى تظهر البطاقة مقفلة. راجع الخطط ← غير محدود.
  4. التفعيل ينقلك مباشرة إلى صفحة الإدارة، ويظهر إدخال ويب هوكس في القائمة الجانبية.
warning

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

طريقة الاستعمال​

1. أضف رابط استقبال​

  1. في أداتك، أنشئ Webhook Trigger (في n8n: عقدة Webhook) وانسخ رابط الاستقبال.
  2. ألصقه في خانة رابط الويب هوك على /dashboard/webhooks.
  3. اختر الأحداث التي تريدها — طلب جديد مُختار مسبقًا، ويجب اختيار حدث واحد على الأقل.
  4. اضغط إضافة.

شروط الرابط التي يفرضها النموذج: أن يبدأ بـ https://، وأن يستعمل منفذ HTTPS القياسي، وأن يشير إلى اسم نطاق (لا إلى عنوان IP مباشر)، وأن لا يحتوي اسم مستخدم أو كلمة سر، وأن لا يكون نطاقًا تابعًا لـ DZBuild. ولا يمكن تسجيل الرابط نفسه مرتين في المتجر ذاته.

العدّاد بجانب روابطك يبيّن عدد الروابط المستعملة من الحد المسموح في خطتك — خطة غير محدود تسمح برابط واحد، وخطة Enterprise حتى ثلاثة.

2. احفظ السر​

فور إنشاء الرابط تظهر نافذة تعرض سر التوقيع الخاص به مع زر نسخ.

warning

السر يُعرض مرة واحدة فقط. انسخه واحفظه في مكان آمن — لن يظهر مجددًا. وإذا فقدته استعمل تجديد السر في صف الرابط وحدّث القيمة في أداتك؛ السر القديم يتوقف عن العمل فورًا.

النافذة نفسها تعرض زر نسخ كود التحقق (متقدم) الذي ينسخ عقدة Code جاهزة لـ n8n تتحقق من التوقيع نيابة عنك، وسرّك مضمّن فيها.

تلميح

لإعداد بدون كود في n8n: افتح عقدة Webhook، اضبط Authentication على Header Auth، وأنشئ Credential باسم X-DZ-Token وألصق سرّك في خانة القيمة. عندها يُرفض تلقائيًا أي طلب لا يحمل هذا السر.

3. تحقّق ثم جرّب​

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

4. راقب سجل التسليم​

زر القائمة في كل صف يفتح سجل التسليم — آخر 50 حدثًا لذلك الرابط، بأعمدة الحدث والحالة وعدد المحاولات وكود HTTP والخطأ والتاريخ. والحالات هي: بالانتظار، يُرسل، تم التسليم، فشل نهائيًا.

5. إدارة الروابط​

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

إيقاف الإضافة من /dashboard/addons يوقف رصد الأحداث الجديدة، مع الاحتفاظ بروابطك وإعداداتها، فإعادة التفعيل لاحقًا تكمل من حيث توقفت.

أسئلة شائعة​

ما الخطة المطلوبة؟ خطة غير محدود فما فوق. في الخطتين المجانية و Pro تظهر بطاقة الإضافة مقفلة، والترقية تفتح التفعيل — راجع الخطط ← الترقيات.

لماذا يبقى رابطي "بانتظار التحقق"؟ لأن رابطك لم يرد بعد على حدث التحقق برد ناجح. تأكد أن السيناريو في n8n أو Make أو Zapier مفعّل (وليس في وضع الاختبار فقط) وأنه يرد بـ HTTP 200، ثم اضغط زر الإرسال في الصف لإعادة المحاولة.

لماذا أُوقف رابطي تلقائيًا؟ لأنه فشل في التسليم مرات متتالية كثيرة — غالبًا بسبب سيناريو مطفأ أو خادم توقف عن الرد. أصلح جهة الاستقبال ثم اضغط زر التفعيل في الصف، ويُصفَّر عدّاد الأخطاء.

هل أحتاج كتابة كود لتأمين الويب هوك؟ لا. مقارنة ترويسة X-DZ-Token بسرّك تكفي لأغلب السيناريوهات، وn8n يقوم بذلك عنك عبر Header Auth. أما توقيع HMAC في ترويسة X-DZ-Signature فهو للتحقق الأكثر صرامة إن أردته.

هل يؤثر ذلك على سرعة متجري؟ لا. الأحداث تُرسل في الخلفية، فلا يبطئ الويب هوك واجهة متجرك ولا صفحة الشراء — راجع البيع ← الطلبات لمسار الطلب نفسه، والإضافات ← نظرة عامة لقائمة الإضافات كاملة.