التوثيق

المتطلبات: PHP 8.1 أو أحدث، WooCommerce 7.0 أو أحدث، HTTPS واتصال صادر بمزود الخدمة، وحساب واتساب مهيأ لدى مزود مدعوم.

نزّل ZIP من حساب إيمارجي وارفعه من الإضافات ← أضف إضافة جديدة ← رفع إضافة، ثم فعّله. افتح WooCommerce ← WhatsApp Notify ← الترخيص وفعّل المفتاح على النطاق الحالي.

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

أنشئ طلب WooCommerce تجريبيًا وافحص سجل الإشعارات. بعد نجاحه فقط فعّل أحداث العملاء المتوافقة مع عملية الموافقة والقوالب المعتمدة. نجاح المزود لا يضمن وصول الرسالة إلى الهاتف؛ تحقق من النتيجة في لوحة المزود.

يدعم WhatsApp Cloud API بمعرّف رقم Meta ورمز الوصول ومعرّف حساب الأعمال وإصدار Graph API؛ وWazaTool برابطه الأساسي ورمز API وأسماء القوالب المعتمدة واللغة ورأس وتذييل اختياريين؛ وOpenWA برابط الخادم ومعرّف الجلسة ومفتاح API؛ وwebhook مخصص يستقبل حمولة JSON من الإضافة.

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

تُضبط إشعارات صاحب المتجر والعملاء استقلالًا. قد تشمل الأحداث الطلب الجديد وانتقالات حالات WooCommerce مثل قيد المعالجة والمكتمل والملغى والفاشل والمسترد.

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

تضع خطافات الطلبات مهام التسليم في WooCommerce Action Scheduler. إذا لم يتوفر، يعالج حدث WP-Cron واحد الإشعارات. تُوسم أزواج الحدث والمستلم الناجحة على الطلب كي لا تعيدها الخطافات المتكررة.

تخفي السجلات التشغيلية أجزاء من أرقام الوجهة وتنقح الحقول السرية المعتادة ولا تعرض معاينات الحمولة وتحد نص الرد. يحذف التنظيف اليومي السجلات الأقدم من 30 يومًا.

لانتظام التوقيت، اضبط cron حقيقيًا لـWordPress وراجع إجراءات WooCommerce المجدولة للفشل.

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

إذا لم يظهر التحديث، فتأكد من سريان الترخيص للنطاق الدقيق واطلب من WordPress فحص التحديثات. راسل [email protected] مع إصدار الإضافة والمزود والحدث ونتيجة سجل منقحة.