إرسال تحديثات طلبات WooCommerce عبر WhatsApp

كيف يطلق طلب WooCommerce رسالة WhatsApp فعليًا؟

عبر webhook في WooCommerce ومستقبل. في WooCommerce، افتح الإعدادات، ثم متقدم، ثم Webhooks، وأضف webhook بموضوع متعلق بالطلب، مثل إنشاء الطلب أو تحديثه، مع عنوان URL للتسليم وسر. بعدها يرسل WooCommerce الطلب بصيغة JSON إلى ذلك العنوان في كل مرة يقع فيها الحدث.

الحمولة ثابتة، لذلك لا يمكن توجيهها إلى Cloud API مباشرة. يتوسط بينهما مستقبل: عقدة Webhook في n8n، أو مسار في PHP الخاص بالمتجر، أو أي خدمة صغيرة. يقرأ الطلب، ويختار رقم هاتف العميل والتفاصيل التي تحتاجها الرسالة، ثم يرسل طلب HTTPS واحدًا إلى نقطة النهاية (endpoint) الخاصة بالرسائل في Cloud API للرقم المتصل، مع token الرقم بوصفه bearer token.

الموضوع order.updated غير مرتبط بحالة واحدة، لذا ينبغي أن يقرأ المستقبل حقل status في الطلب ويرسل مرة واحدة لكل انتقال يهمك. يسلّم WooCommerce في الخلفية عبر wp-cron افتراضيًا، فقد تصل الرسالة بعد الطلب بتأخير قصير.

كيف يعرف المستقبل أن الطلب جاء من المتجر؟

من توقيع WooCommerce. يحمل كل تسليم ترويسة X-WC-Webhook-Signature، وهي HMAC-SHA256 للحمولة الخام بترميز base64، محسوبة بالسر الذي حددته في webhook. يحسب المستقبل التجزئة نفسها على المحتوى الذي استلمه ويقارنها، ويرفض كل ما لا يطابق.

هذا هو سر المتجر نفسه، فعلى عكس توقيع Meta على رسائل WhatsApp الواردة، يمكن التحقق منه. قارن بزمن ثابت، واحسب التجزئة على المحتوى الخام قبل أن يحلله أي إطار عمل، لأن JSON المعاد ترميزه ينتج تجزئة مختلفة.

استجب بسرعة برمز 2xx. يعدّ WooCommerce أي استجابة ليست 2xx أو 301 أو 302 فشلًا، وبعد أكثر من خمسة إخفاقات متتالية يعطّل webhook. مستقبل متوقف بسبب نشر جديد، أو بطيء لأنه ينتظر Meta قبل الرد، قد يوقف رسائل المتجر دون أن يلاحظ أحد.

ماذا يمكن للمتجر أن يرسل، ومتى؟

قالبًا معتمدًا، في كل مرة يبدأ فيها المتجر المحادثة. تفتح نافذة خدمة العملاء من Meta ومدتها 24 ساعة فقط عندما يراسل العميل الرقم، لذا فإن تأكيد الطلب أو تحديث الشحن مبادرة من النشاط التجاري، ويُرفض فيها النص الحر. أنشئ قالبًا من فئة utility لكل تحديث، وانتظر الاعتماد، ثم أرسله بالاسم واللغة مع رقم الطلب وبقية التفاصيل كمعاملات.

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

بعد أن يرد العميل تصبح المحادثة Coexistence عادية. يظهر الرد في تطبيق WhatsApp Business على هاتف المتجر، وتكون النافذة مفتوحة للنص الحر، ويرد الفريق من التطبيق كما اعتاد.

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

• تنفيذ استدعاء Cloud API قبل الرد على WooCommerce. الإرسال البطيء أو الفاشل يُحتسب ضد webhook، الذي يُعطَّل بعد أكثر من خمسة إخفاقات.
• حساب التجزئة على JSON المحلَّل بدل المحتوى الخام. لا يتطابق التوقيع أبدًا، فيُرفض كل تسليم سليم.
• الإرسال عند كل تسليم لـ order.updated. الموضوع غير مرتبط بحالة واحدة، فدون تتبع الانتقال الذي أُرسلت عنه رسالة بالفعل يصل التكرار إلى العملاء.

الأسئلة الشائعة

تابع القراءة