Lorixen.
AR

إرسال طلبات WooCommerce تلقائياً إلى أنظمتك عبر Webhooks

باختصار: إذا كنت تريد أن يصل كل طلب جديد في متجرك على WooCommerce تلقائياً إلى أداة أتمتة، أو إلى نظام المستودع، أو إلى لوحة فريق التوصيل، دون أن ينسخه موظف يدوياً، فالأداة المدمجة لذلك هي webhooks. يذهب المسؤول إلى WooCommerce ثم الإعدادات ثم «متقدم» ثم Webhooks، ويختار حدثاً مثل إنشاء طلب، ويضع رابط الاستلام ومفتاحاً سرياً. توثيق WooCommerce ينبه إلى نقطتين مهمتين: كل طلب يُرسل ومعه توقيع يمكن التحقق منه بالمفتاح السري، والـ webhook يُعطَّل تلقائياً بعد سلسلة من الإخفاقات المتتالية، فيجب مراقبته.

ما المشكلة التي يحلها؟

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

الفكرة أن يبلغ المتجر نفسه الأنظمة الأخرى لحظة حدوث الشيء: «طلب جديد أُنشئ، هذه تفاصيله». توثيق WooCommerce يعرّف الـ webhook بأنه إشعار بحدث يُرسل إلى رابط تختاره، ويُضبط بحيث يطلقه حدث في موقع ليستدعي سلوكاً في موقع آخر، ويذكر أنه مفيد لربط المتجر بخدمات خارجية. هذا مثال توضيحي لحالة شائعة.

خطوات الإنشاء كما يشرحها التوثيق

  1. اذهب إلى WooCommerce ثم Settings ثم Advanced ثم Webhooks.
  2. اختر Add webhook.
  3. الاسم: وصف يساعد فريقك، مثل «طلبات جديدة إلى نظام التوصيل». إذا تُرك فارغاً يُستخدم اسم افتراضي فيه تاريخ الإنشاء.
  4. الحالة: Active لإرسال الإشعارات، أو Paused للإيقاف المؤقت، أو Disabled الذي يعني إيقاف الإرسال بسبب الإخفاقات.
  5. الموضوع (Topic): الحدث الذي يطلق الإشعار. الخيارات تشمل أحداثاً للقسائم والزبائن والطلبات والمنتجات، وخيار Action لربطه بإجراء محدد في ووردبريس. وثائق واجهة WooCommerce البرمجية تذكر من المواضيع الأساسية order.created وorder.updated وorder.deleted.
  6. رابط الاستلام (Delivery URL): الرابط الذي سيستقبل البيانات، وتعطيك إياه أداة الأتمتة أو المطور.
  7. المفتاح السري (Secret): يُستخدم لإنشاء بصمة للبيانات المرسلة تُضاف إلى ترويسات الطلب. إذا تُرك فارغاً، يُستخدم افتراضياً المفتاح السري لمستخدم الواجهة البرمجية الحالي.
  8. اضغط Save webhook.

ويذكر التوثيق أن WooCommerce يرسل طلب اختبار إلى رابط الاستلام في أول مرة تحفظ فيها webhook بحالة Active. إذا لم يكن الطرف الآخر جاهزاً، فقد يُحتسب ذلك كإخفاق.

اختر الحدث المناسب

«طلب أُنشئ» ليس دائماً اللحظة التي تريدها. الطلب قد يُنشأ قبل اكتمال الدفع، ثم يتغير وضعه لاحقاً. فكّر بما يحتاجه كل طرف:

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

اتفق مع المطور على قاعدة واضحة: أي حدث، وأي حالات طلب تُعالج، وماذا يحدث إذا وصل تحديث للطلب نفسه مرتين.

ماذا يحتوي الإشعار؟

بحسب وثائق الواجهة البرمجية، البيانات المرسلة بصيغة JSON، وبالنسبة لموارد مثل الطلبات والزبائن والمنتجات والقسائم، يكون المحتوى مطابقاً تماماً لما ستحصل عليه لو طلبت المورد نفسه عبر الواجهة البرمجية. هذا يعني أن الإشعار يحمل تفاصيل كثيرة: اسم الزبون، ورقم هاتفه، وعنوانه، والمنتجات، والملاحظات.

لذلك اسأل سؤالين قبل التشغيل:

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

جرّب على طلب تجريبي أولاً

قبل ربط الـ webhook بنظام التوصيل الحقيقي، وجّهه إلى رابط اختبار تملكه، وأنشئ طلباً تجريبياً واضح الاسم، مثل «طلب اختبار - لا تشحن». تأكد أن البيانات وصلت كاملة، وأن العنوان العربي ظهر بشكل صحيح، ثم انقل الرابط إلى النظام الحقيقي.

تحقق من أن الإشعار من متجرك فعلاً

رابط الاستلام رابط على الإنترنت، وأي شخص يعرفه يستطيع إرسال بيانات مزيفة إليه، مثل «طلب جديد» لم يحدث. هنا يأتي دور المفتاح السري.

وثائق الواجهة البرمجية تذكر أن كل إشعار يحمل ترويسات تساعد المستقبل على معالجته، منها مصدر الإشعار وموضوعه، وترويسة X-WC-Webhook-Signature التي تحمل بصمة HMAC-SHA256 للبيانات مشفرة بصيغة base64. المستقبل يحسب البصمة نفسها بالمفتاح السري ويقارنها، فإذا لم تتطابق يرفض الإشعار.

اطلب من المطور أو من أداة الأتمتة التحقق من هذه البصمة، ولا تترك المفتاح السري فارغاً كي لا يُستخدم مفتاح آخر قد يُشارك مع جهات أخرى.

انتبه للتعطيل التلقائي

هذه أكثر نقطة تفاجئ أصحاب المتاجر. صفحة توثيق WooCommerce تقول إن المتجر يعطّل الـ webhook تلقائياً بعد أكثر من خمسة إخفاقات متتالية في التسليم، وتعرّف الإخفاق بأنه أي استجابة غير رموز 2xx أو 301 أو 302، فاستجابات 4xx و5xx تُحتسب إخفاقاً. وتذكر أنه يمكن تغيير هذا الحد بفلتر woocommerce_max_webhook_delivery_failures.

ماذا يعني ذلك عملياً؟ إذا توقفت أداة الأتمتة يوماً لصيانة، أو تغير رابطها، فقد تفشل عدة إشعارات، ثم يتعطل الـ webhook بصمت. الطلبات تستمر في الوصول إلى المتجر، لكنها لا تصل إلى المستودع، ولا أحد يلاحظ حتى يشتكي زبون.

راقب السجلات

وثائق الواجهة البرمجية تذكر أن طلبات التسليم واستجاباتها تُسجل في نظام سجلات WooCommerce، وأن كل سجل يتضمن مدة الطلب، والرابط والطريقة والترويسات والمحتوى، ورمز الاستجابة ورسالتها. وتشير إلى أن السجلات متاحة من WooCommerce ثم Status ثم Logs.

اقتراح عملي:

  • راجع حالة الـ webhook أسبوعياً، أو بعد أي تغيير في أداة الأتمتة.
  • إذا وجدت حالته Disabled، افتح السجلات لترى سبب الإخفاق قبل إعادة تفعيله.
  • اجعل الطرف المستقبل يرسل تنبيهاً إذا مرت فترة طويلة دون أي طلب، في يوم يُفترض أن تكون فيه طلبات.

لا تعتمد عليه وحده للطلبات الحرجة

الـ webhook وسيلة ممتازة للسرعة، لكنه ليس سجلاً كاملاً. إذا تعطل لفترة، فلن تُرسل الطلبات التي فاتت تلقائياً بعد إعادة التفعيل. اتفق مع المطور على طريقة لمطابقة دورية: مقارنة طلبات اليوم في المتجر مع ما وصل إلى النظام الآخر، والتقاط أي فرق.

أسئلة شائعة

كيف أبعت الطلبات الجديدة من WooCommerce لنظام ثاني تلقائياً؟

أنشئ webhook من WooCommerce ثم الإعدادات ثم متقدم ثم Webhooks، واختر حدث الطلب ورابط الاستلام ومفتاحاً سرياً.

ليش الـ webhook صار Disabled لحاله؟

لأن WooCommerce يعطّله تلقائياً بعد سلسلة من الإخفاقات المتتالية، أي استجابات غير 2xx أو 301 أو 302.

كيف بعرف إنه الإشعار جاي من متجري مش من حدا ثاني؟

تحقق من ترويسة X-WC-Webhook-Signature، وهي بصمة HMAC-SHA256 للبيانات تُحسب بالمفتاح السري.

وين بشوف سبب الفشل؟

في سجلات WooCommerce من Status ثم Logs، حيث يُسجل الطلب والاستجابة ورمزها.

إذا أردت ربط طلبات متجرك بالمستودع أو التوصيل دون نسخ يدوي، اكتب لنا ونصمم الربط معك.

المصادر

WhatsAppاحجز مكالمة