خطافات الويب

تتيح خطافات الويب (Webhooks) لمتجرك في وووكامرس إرسال إشعارات تلقائية بالأحداث إلى رابط URL من اختيارك. تشرح هذه المقالة ما هي خطافات الويب، وكيفية إنشائها وإدارتها في وووكامرس، وكيفية مراجعة سجلات خطافات الويب لاستكشاف الأخطاء وإصلاحها.

ما هي خطافات الويب (What are webhooks)

خطاف الويب هو إشعار حدث يتم إرساله إلى رابط URL من اختيارك. يمكنك أنت (أو المطور الخاص بك) تكوين خطاف ويب يتم تشغيله بواسطة الأحداث على موقع واحد لاستدعاء سلوك على موقع آخر.

تكون خطافات الويب مفيدة لتintegration متجرك مع خدمات الطرف الثالث أو واجهات برمجة التطبيقات (APIs) الخارجية الأخرى التي تدعمها.

خطافات الويب في وووكامرس (Webhooks in WooCommerce)

يمكن لوووكامرس تشغيل إشعارات خطاف الويب في كل مرة تقوم فيها بإضافة أو تعديل أو حذف الطلبات، أو المنتجات، أو القسائم، أو العملاء، وعند إجراء عمليات الشراء، والمزيد.

يمكنك أيضًا استخدام خطافات الويب مع إجراءات وووكامرس (WooCommerce actions). على سبيل المثال، يمكنك إنشاء خطاف ويب يتم تفعيله في كل مرة يتم فيها إضافة منتج إلى سلة التسوق باستخدام الإجراء woocommerce_add_to_cart.

كما تمكن خطافات الويب تطبيقات الطرف الثالث من التكامل مع وووكامرس.

إنشاء خطاف ويب (Create a webhook)

لإنشاء خطاف ويب جديد، اتبع الخطوات التالية:

1. انتقل إلى وووكامرس > الإعدادات > متقدم > خطافات الويب (WooCommerce > Settings > Advanced > Webhooks).
2. اختر إضافة خطاف ويب (Add webhook). يظهر نموذج بيانات خطاف الويب (Webhook data).

3. املأ الحقول التالية:
   • الاسم (Name) — أدخل وصفاً لخطاف الويب. إذا تركت هذا فارغاً، فسيكون الاسم افتراضيًا “تم إنشاء خطاف الويب في [التاريخ والوقت] (Webhook created on [date and time]).” يمكنك تحديث الاسم لاحقاً.
   • الحالة (Status) — تعيين إلى نشط (Active) لتسليم الإشعارات، أو متوقف مؤقتاً (Paused) لإيقاف التسليم مؤقتاً، أو معطل (Disabled) لإيقاف التسليم بسبب الإخفاقات.
   • الموضوع (Topic) — اختر الحدث الذي يقوم بتشغيل خطاف الويب. تشمل الخيارات الأحداث المرتبطة بالقسائم، والعملاء، والطلبات، والمنتجات، والإجراء (Action). قد تظهر مواضيع إضافية اعتماداً على الإضافات النشطة على موقعك.
     • موضوع مخصص (Custom Topic) — هذا الخيار للمستخدمين المتقدمين فقط. يمكنك إدخال مواضيع مخصصة باستخدام مرشح (filter) woocommerce_webhook_topic_hooks.
   • حدث الإجراء (Action Event) — عندما تحدد الإجراء (Action) كـوضوع، يظهر هذا الحقل. أدخل الإجراء الذي يقوم بتتشغيل خطاف الويب (على سبيل المثال، woocommerce_add_to_cart يتم تفعيله عندما يقوم العميل بإضافة منتج إلى سلة التسوق).
   • رابط التسليم (Delivery URL) — أدخل عنوان URL الذي يتم تسليم حمولة خطاف الويب (payload) إليه.
   • السر (Secret) — أدخل مفتاحاً سرياً يُستخدم لتوليد تجزئة (hash) لخطاف الويب الذي تم تسليمه. يتم تضمين التجزئة في رؤوس الطلب (request headers). إذا تركت هذا فارغاً، فسيكون افتراضيًا هو السر الخاص بمستهلك مستخدم واجهة برمجة التطبيقات الحالي (current API user's consumer secret).
4. انقر فوق حفظ خطاف الويب (Save webhook).

التعطيل التلقائي (Automatic disabling)

يقوم وووكامرس تلقائياً بتعطيل خطاف الويب بعد أكثر من خمسة إخفاقات متتالية في التسليم. يعتبر الإخفاق أي استجابة ليست رمز حالة HTTP من فئة 2xx أو 301 أو 302. على سبيل المثال، تعتبر استجابات 4xx أو 5xx بمثابة إخفاقات.

لزيادة أو تقليل حد الإخفاق، يمكنك استخدام مرشح (filter) woocommerce_max_webhook_delivery_failures.

تعديل وحذف خطافات الويب (Edit and delete webhooks)

يمكنك تعديل أو حذف خطافات الويب الموجودة من قائمة خطافات الويب على مسار وووكامرس > الإعدادات > متقدم > خطافات الويب (WooCommerce > Settings > Advanced > Webhooks).

1. ابحث عن خطاف الويب الذي تريد تعديله.
2. مرر مؤشر الفارة فوق اسم خطاف الويب لإظهار خيارات المعرف (ID)، تعديل (Edit)، وحذف بشكل دائم (Delete permanently).
3. انقر فوق حذف بشكل دائم (Delete permanently) لإزالة خطاف الويب، أو انقر فوق تعديل (Edit) لتحديث إعدادات خطاف الويب ثم انقر فوق حفظ خطاف الويب (Save webhook).

حذف عدة خطافات ويب دفعة واحدة، حددها باستخدام خانات الاختيار واختر حذف بشكل دائم (Delete permanently) من قائمة الإجراءات الجماعية المنسدلة الإجراءات الجماعية (Bulk actions).

سجلات خطاف الويب (Webhook logs)

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

لعرض سجلات خطاف الويب:

1. انتقل إلى وووكامرس > الحالة > السجلات (WooCommerce > Status > Logs).
2. إذا كانت لدى موقعك العديد من ملفات السجل، فاختر webhooks-delivery من قائمة جميع المصادر (All sources) المنسدلة لتصفية القائمة.
3. استخدم مربع البحث في أعلى اليسار/اليمين للبحث في محتوى ملفات السجل.

الأسئلة والدعم (Questions and support)

هل لا تزال لديك أسئلة وتحتاج إلى مساعدة؟

• إذا كنت تبحث عن توسيع (extend) الوظائف الأساسية الموضحة هنا، فنحن نوصي بمراجعة الإضافات المتاحة في سوق وووكامرس (WooCommerce Marketplace).
• هل تحتاج إلى دعم متقدم مستمر أو تخصيص (customization) مبني لوووكامرس؟ قم بتوظيف شريك وكالة Woo.
• هل أنت مطور (developer) تبني تكاملك أو امتدادك الخاص لوووكامرس؟ تحقق من موارد المطورين (Developer Resources).