حل مشكلات الإرسال في إضافة Wawp

فيما يلي سلسلة من الخطوات التشخيصية والإصلاحية التي يقوم بها فريق الدعم لحل مشكلات الإرسال وتوجيه الرسائل في موقعك:

🛠 خطوات الحل والعلاج التدريجي

1. التأكد من إعداد وتعيين تفاصيل المرسل

تأكد من وجود حساب أو معرف إرسال نشط متصل بالإنترنت (Online ID)، وأنه قد تم تعيينه بنجاح لكافة ميزات ومسارات إرسال الرسائل بمتجرك. (بالنسبة للمطورين، يمكنك مراجعة حالة الاتصال والجلسة عبر وثائق واجهة برمجة تطبيقات Wawp).

2. التأكد من تنشيط وتفعيل وضع تخزين الطلبات عالي الأداء (HPOS) في ووكومرس

يقوم وضع الأداء العالي (HPOS) في ووكومرس بتنظيم العمليات والطلبات بكفاءة وسرعة تفوق بكثير الأنظمة التقليدية السابقة. للوصول إليها، انتقل إلى: إعدادات ووكومرس > الإعدادات المتقدمة > الميزات (Features) > وقم بتفعيل وضع التوافق (مزامنة الطلبات بين نظام HPOS وجدول المنشورات الافتراضي للووردبريس). (اقرأ المزيد حول نظام تخزين الطلبات HPOS في وثائق ووكومرس الرسمية).

3. التحقق من تنصيب مهام مجدول cron وتشغيلها بكفاءة

يتولى مجدول المهام Cron تنفيذ العمليات والوظائف الأساسية بانتظام، مثل إرسال الإشعارات الجارية وإعادة محاولات إرسال الرسائل الفاشلة. نوصي بتنشيط وتفعيل إضافة WP Crontrol للتحقق من تنصيب وسلاسة عمل المجدول.

رابط الإضافة: https://wordpress.org/plugins/wp-crontrol/ من الشريط الجانبي لووردبريس > أدوات (Tools) > أحداث كرون (Cron Events)

ابحث عن كلمة wawp لعزل ورصد عمليات الخلفية لـ Wawp. راجع جدول خطافات الأتمتة المكامل أدناه:

4. تعطيل وحذف ثابت WP-Cron التعطيلي

افتح ملف الإعداد والتكوين الرئيسي wp-config.php الموجود في المجلد الجذري لموقعك (مثل public_html). ابحث عن أي أمر برمجي مخصص لتعطيل أو تخطي مجدول مهام ووردبريس، والذي غالباً ما يكون مكتوباً كالتالي: define('DISABLE_WP_CRON', true);

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

5. التأكد من تنشيط وتفعيل خيار رمز الدولة

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

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

الهدف النهائي والأهم هو أن يستلم خادم الإرسال رقم الهاتف متضمناً مفتاح الدولة كاملاً وبصيغة خالية من الأصفار والرموز الإضافية (مثل: 201111111111 أو 96650000000)، دون وجود شارة الزائد + أو أصفار دولية 00 في بداية الرقم.

6. التحقق من قيود مجدول المهام Cron المفروضة من الاستضافة

في بعض لوحات الاستضافة، يمكنك الوصول لأدوات إدارة وقيود كرون، مثل أداة WP-Toolkit المدمجة في لوحات تحكم cPanel و aapanel. تأكد من تعطيل وإيقاف معطلات ومقيدات مهام كرون، أو تواصل مع الدعم الفني للاستضافة لتأكيد فتحها. وتأكد من إيقاف وتعطيل أي ميزات تفرض استيلاءً كاملاً على ملف wp-cron.php.

7. التحقق من تهيئة وخيارات وسجلات DNS في كلودفلير (Cloudflare)

تواصل مع مزود خدمة الاستضافة أو مدير السيرفر لتهيئة وضبط سجلات DNS وحذف ميزة البروكسي (التحويل المسبق) — بحيث تصبح أيقونة السحابة باللون الرمادي (DNS Only) — للنطاق الرئيسي أو الفرعي الذي تم تنصيب وتفعيل إضافة Wawp عليه؛ وذلك لضمان تواصل واتصال مباشر وسريع بواجهة البرمجة وسحابة الإرسال دون انقطاع. (راجع دليل إدارة سجلات DNS في كلودفلير).

8. مراجعة تعارضات وتداخلات بعض الإضافات النشطة

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

لا تعمل ميزات الإرسال الفوري والمراسلة بشكل مثالي عند تفعيل التخزين المؤقت الكثيف في LiteSpeed، سواء كانت إضافة تنظيف الكاش نشطة في موقعك أو مهيأة بداخل السيرفر كبديل لخادم أباتشي لخدمة الإرسال اللحظي. نوصي بتعطيل ميزات الكاش الكثيفة للمسارات التفاعلية أو تعديل إعدادات التهيئة لتجنب تعارضات تخزين البيانات. (اقرأ المزيد حول إدارة LiteSpeed Cache).

قد تتعرض مواقع ووردبريس التي تضم عدداً كبيراً من الإضافات أو تعمل في بيئات خوادم مقيدة لتعارضات برمجية تؤدي لتعطل إرسال المراسلات، أو انقطاع اتصالات واجهات البرمجة API، أو فشل التحقق. وفيما يلي دليل تشخيصي مفصل لأربعة مجالات شائعة لتعارضات الإضافات:

أ. تعارضات التخزين المؤقت والتحسين (LiteSpeed Cache و WP Rocket و W3 Total Cache)

• المشكلة والتعارض: تقوم محركات التخزين المؤقت بحفظ نسخ ثابتة من الصفحات واستعلامات قاعدة البيانات. وتعتمد Wawp بشكل أساسي على طلبات REST API تفاعلية وديناميكية في الوقت الفعلي للتحقق من تنسيق أرقام الهواتف، معالجة تسجيلات OTP، وتتبع حالات الاتصال النشطة. فإذا قامت إضافة الكاش بتخزين استجابات REST API، فستقوم بإرجاع بيانات قديمة ومخزنة مؤقتاً؛ مما يسبب فشل عمليات التسليم والتوثيق.
• الحل التقني: قم بتهيئة قائمة الاستثناءات في إضافة التخزين المؤقت لديك لتخطي واستثناء روابط واستدعاءات واجهة REST API الخاصة بـ Wawp بالكامل، عن طريق إدراج المسار التالي إلى قائمة الروابط غير الخاضعة للكاش: /wp-json/wawp/v1/* بالإضافة إلى ذلك، تأكد من تعطيل أو استثناء ميزات "Object Cache" أو "Database Cache" لجداول Wawp المخصصة.

ب. حظر جدران الحماية الأمنية و WAF (Wordfence و Solid Security و Cloudflare WAF)

• المشكلة والتعارض: تقوم إضافات الحماية وجدران حماية تطبيقات الويب (WAF) بفحص وتدقيق طلبات HTTP الواردة والصادرة. وقد تمنع هذه الأدوات أحياناً اتصالات Loopback الصادرة التي تجريها Wawp للتحقق من الاتصال برابط api.wawp.net، أو تحجب إشعارات الويب هوك الواردة؛ مما يتسبب في إرجاع رمز خطأ 403 Forbidden وفشل المزامنة.
• الحل التقني: قم بإدراج مسار Wawp REST API المخصص (/wp-json/wawp/v1/*) وعناوين IP التابعة لسحابة Wawp في القائمة البيضاء الخاصة بإضافة الحماية بموقعك أو في قواعد تخطي جدار حماية كلودفلير.

ج. database optimizers وحذف البيانات المؤقتة (WP-Optimize و Advanced Database Cleaner)

• المشكلة والتعارض: للحفاظ على موارد الخادم، تقوم Wawp بتخزين جلسات واتساب النشطة وحالات واجهة البرمجة ورموز الدخول مؤقتاً داخل سجلات تسمى البيانات المؤقتة (Transients). وتقوم الإضافات التي تنظف أو تحسن قواعد البيانات تلقائياً بمسح هذه البيانات؛ مما يؤدي لإسقاط الجلسات النشطة، ويجبر النظام على إعادة محاولات الاتصال بشكل متكرر ومستمر مما يسبب بطء الاستجابة وأخطاء المهلة.
• الحل التقني: استثنِ سجلات ومفاتيح Wawp المخصصة في قاعدة البيانات (خاصة تلك التي تبدأ بـ _transient_wawp_ أو _transient_timeout_wawp_) من عمليات التنظيف والمسح التلقائي لقاعدة البيانات.

د. قواعد إعادة التوجيه وإضافات العضوية (Theme My Login و Ultimate Member)

• المشكلة والتعارض: تقوم إضافات إدارة العضويات والمستخدمين التي تستبدل شاشات الدخول والتسجيل الافتراضية لووردبريس أحياناً بتخطي خطافات المدخلات التابعة لـ Wawp؛ مما يوقف عمل ميزة حقل الهاتف المتقدم وفحوصات التحقق من مفاتيح البلدان وتوجيهات تسجيل الدخول الآمن، ويسمح بتخزين أرقام هواتف خاطئة أو مشوهة.
• الحل التقني: قم بتعطيل وإيقاف خيارات إعادة التوجيه الافتراضية للنماذج بداخل إعدادات العضوية في أي صفحة مهيأة ومعدة لتشغيل نماذج تسجيل Wawp أو بوابات الدخول بـ OTP.

9. حظر طلبات الاتصال التبادلية (Loopback Requests) في السيرفر

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

طريقة التشخيص: توجه بداخل لوحة التحكم إلى أدوات (Tools) > صحة الموقع (Site Health) > معلومات (Info)، واستعرض حالة خيار "Loopback Requests". أو بدلاً من ذلك، تفضل بمراجعة لوحة حالة النظام داخل إعدادات Wawp والتي تقوم بهذا الفحص التشخيصي تلقائياً وبشكل فوري.

الأسباب الشائعة والحلول المتاحة:

• قد تكون إحدى إضافات الأمان (مثل Wordfence أو Solid Security) تحظر طلبات Loopback. نوصي بتعطيلها مؤقتاً لإجراء فحص وتجربة.
• قد يقوم جدار حماية السيرفر (Firewall) بحظر الطلبات القادمة من عنوان 127.0.0.1 أو localhost. يرجى مطالبة الدعم الفني للاستضافة بإدراج هذه الاتصالات المحلية في القائمة البيضاء المسموح بها.
• قد يتسبب سطر مخصص في ملف .htaccess في إعادة توجيه أو حجب كافة الطلبات. نوصي بمراجعة قواعد الحجب العامة المدرجة بالملف.

10. تعطيل أو حظر واجهة REST API لووردبريس

تعتمد إضافة Wawp بالكامل على واجهة برمجة التطبيقات ووردبريس REST API بالمسار (/wp-json/wawp/v1/*) للتحقق من صحة وتنسيق الأرقام، مصادقة OTP، إدارة الاتصال وقنوات الإرسال، وتلقي إشعارات الويب هوك. فإذا تم إيقاف وتعطيل REST API بشكل كامل وشامل في موقعك — بسبب تعارضات إضافة أخرى، كود بالقالب، إعداد بملف .htaccess، أو جدار حماية — فستفشل كافة وظائف Wawp التشغيلية بالكامل دون ظهور أي رسالة خطأ.

طريقة التشخيص: افتح المتصفح وتصفح الرابط التالي: https://yoursite.com/wp-json/wp/v2/types/post. فإذا ظهرت لك صفحة خطأ أو صفحة حظر 403 Forbidden بدلاً من استعراض وعرض بيانات بصيغة JSON، فهذا يعني أن REST API محجوبة بموقعك. كما تقوم لوحة حالة النظام في Wawp بالتحقق من هذا الأمر وعرض حالته تلقائياً.

الأسباب الشائعة والحلول المتاحة:

• قد تحتوي إحدى إضافات الأمان على ميزة مثل "تعطيل REST API للمستخدمين غير المسجلين". يرجى تعطيل هذا القيد أو إضافة استثناء مخصص لمسارات Wawp.
• قد يحتوي ملف functions.php أو أي كود مخصص على أمر إلغاء المزامنة مثل remove_action('rest_api_init', ...) أو add_filter('rest_authentication_errors', ...). يرجى إزالة وحذف هذا التعطيل البرمجي فوراً.
• قد يحظر جدار حماية تطبيقات الويب (WAF) كافة روابط wp-json. يرجى إدراج المسار /wp-json/wawp/v1/* في القائمة البيضاء.

11. انخفاض حد ذاكرة السيرفر PHP Memory Limit

تتطلب إضافة Wawp حداً أدنى لذاكرة PHP يبلغ 1024MB (1GB) لتتمكن من معالجة عمليات إرسال الحملات الكثيفة والجماعية، تقييم سلات التسوق المتروكة، وطوابير الرسائل الكثيفة. فإذا كان حد الذاكرة المخصص منخفضاً جداً، فسيقوم السيرفر بإنهاء مهام المعالجة الجارية بالخلفية بشكل مفاجئ وصامت؛ مما يؤدي لاختفاء الرسائل من قائمة الانتظار دون إرسالها ودون توثيق أي خطأ.

طريقة التشخيص: تفضل بزيارة صفحة حالة النظام في إعدادات Wawp. فإذا ظهر تحذير باللون البرتقالي بجانب خيار PHP Memory Limit، فهذا يعني أن خادمك يعمل بقدرات أقل من الحد الأدنى المطلوب لتشغيل الإشعار.

كيفية الإصلاح: أضف أو حدّث السطر البرمجي التالي بداخل ملف التكوين wp-config.php (قبل سطر التنويه النهائي /* That's all, stop editing! */):

وإذا لم ينجح هذا التعديل، فيرجى التواصل الفوري مع الدعم الفني للاستضافة لمطالبتهم برفع قيمة memory_limit بداخل ملف التكوين php.ini أو لوحة التحكم الخاصة بك.

12. انخفاض مهلة وقت التنفيذ PHP Max Execution Time

نوصي بضبط حد أدنى لوقت التنفيذ يبلغ 300 ثانية لضمان استقرار وموثوقية مهام الإرسال بالخلفية. فإذا كانت هذه القيمة منخفضة جداً (وهو أمر شائع يقتصر على 30 أو 60 ثانية في الاستضافات المشتركة)، فسيقوم مفسر PHP بإنهاء وقت تشغيل مهام معالجة الحملات وبث الإشعارات بالخلفية قبل اكتمالها؛ مما يعوق تسليم الرسائل للمستلمين.

طريقة التشخيص: راجع تقرير لوحة حالة النظام. فظهور تحذير بجانب PHP Max Execution Time يعني أن قيمة الوقت الحالية المتاحة أقل من 300 ثانية.

كيفية الإصلاح: أضف السطر التالي بداخل ملف wp-config.php:

أو بدلاً من ذلك، أضف السطر التالي بداخل ملف التوجيه .htaccess:

أو تواصل مع الدعم الفني للاستضافة لتعديل القيمة بداخل ملف php.ini الرئيسي.

13. فقدان أو تلف بعض جداول قاعدة بيانات Wawp

تقوم إضافة Wawp بحفظ وتخزين كافة بياناتها التشغيلية (سجلات الأحداث وتفاعل الزوار، خيارات الإشعارات المؤتمتة، بيانات اتصال الحسابات والأجهزة، أكواد OTP الصادرة، طوابير بث المراسلات) بداخل جداول SQL مخصصة تابعة لها بقاعدة البيانات. فإذا تعرض أحد هذه الجداول للفقدان أو التلف — بسبب فشل التحديث، أو إجراء تدويني خاطئ من إضافات تحسين قاعدة البيانات، أو خطأ في النقل — فستتوقف ميزات الإضافة عن العمل تماماً وبشكل صامت.

طريقة التشخيص: توجه إلى صفحة حالة النظام في إضافتك. يعرض قسم الجداول حالة كل جدول مخصص مطلوب؛ فظهور عبارة "مفقود - Missing" بجانب أي جدول يعني وجوب إعادة بنائه فوراً.

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

14. تعطل أو عدم تهيئة شهادة الأمان SSL بنجاح بالخادم

تتم جميع الاتصالات التبادلية بين إضافة Wawp وسحابة بوابة الإرسال الخارجية (api.wawp.net) بشكل آمن ومحمي عبر بروتوكول HTTPS المشفر. فإذا كان السيرفر يفتقد لشهادة أمان SSL صالحة وموثوقة، أو إذا كانت مكتبة curl بالخادم غير قادرة على التحقق من سلسلة التوثيق والشهادة، فستفشل كافة الطلبات الصادرة بواجهة البرمجة (API) بسبب أخطاء التحقق؛ مما يمنع إرسال وتسليم الرسائل.

طريقة التشخيص: تفقد لوحة تقرير حالة النظام. فظهور تحذير بجانب SSL Status يعني عدم تشغيل موقعك الإلكتروني عبر اتصال HTTPS الآمن والمحمي. وننصح بمراجعة تاريخ صلاحية شهادة الأمان من لوحة تحكم استضافتك.

كيفية الإصلاح:

• قم بتنصيب شهادة أمان SSL صالحة وموثوقة عبر لوحة تحكم استضافتك (نوفر شهادة Let's Encrypt المجانية والمدعومة بشكل واسع).
• تأكد من أن عنوان رابط موقعك المسجل بداخل إعدادات ووردبريس العامة يبدأ برمز البروتوكول الآمن https://.
• إذا كنت تعمل على سيرفر تطوير محلي وتستخدم شهادة موقعة ذاتياً (Self-signed Certificate)، فتأكد من تحديث حزمة CA بداخل خادمك (مثل تحديث حزمة ca-certificates في نظام لينكس).

15. تنشيط وضع تصحيح الأخطاء WP_DEBUG في المواقع المباشرة

صُمم وضع تصحيح ومعالجة الأخطاء WP_DEBUG في ووردبريس ليستخدم في بيئات التطوير والاختبار المحلية فقط. فإذا تم تفعيله بالمواقع المباشرة، فقد يتسبب في حقن وعرض إشعارات وتنبيهات PHP البرمجية بداخل استجابات JSON الخاصة بواجهة REST API؛ مما يشوه بنيتها ويجعلها غير قابلة للمزامنة والقراءة بواسطة إضافة Wawp. ويؤدي ذلك لحدوث أعطال في توثيق OTP، ورفض طلبات الويب هوك، وأخطاء في تسليم الرسائل يصعب رصدها ومتابعتها.

طريقة التشخيص: تفحص تقرير لوحة حالة النظام. فظهور تحذير بجانب WordPress Debug Mode يؤكد أن وضع التطحيح نشط بموقعك.

كيفية الإصلاح: افتح ملف wp-config.php وتأكد من ضبط القيمة لتصبح false كما هو موضح بالسطر التالي:

وتأكد كذلك من ضبط وتعيين ثوابت WP_DEBUG_LOG و WP_DEBUG_DISPLAY لتصبح false بداخل خادم الإنتاج الخاص بموقعك.

الخطوات التالية

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