استكشاف الأخطاء وإصلاحها
آخر تحديث:
لمشغلي المتاجر والمديرين الفنيين. السابق:
ابحث عن الرسالة التي تراها على الشاشة، ثم اتبع الخطوات في الجدول ذي الصلة. الرسائل محفوظة بالإنجليزية حتى تتمكن من مطابقتها مع الواجهة.
فحوصات سريعة
قبل استكشاف مشكلة محددة:
- تأكد من أنك تعمل في الورشة الصحيحة.
- افتح ** PrestaKick الذكاء الاصطناعي → الاتصال** في الوحدة.
- تحقق من حالة Connected.
- إذا قمت بتغيير الإعدادات للتو، اختر Save configuration.
- افتح وظائف الكرون → السجلات وتحقق من آخر جولة.
- في لوحة التحكم، تحقق من حالة Healthy أو Degraded أو Offline أو Unknown.
- حاول مرة أخرى باستخدام نافذة متخفية لاستبعاد البيانات القديمة في المتصفح.
خطأ في توصيل الوحدة
| رسالة أو عرض | السبب المشترك | ماذا تفعل |
|---|---|---|
| API connection required | الوحدة لا تتصل أو تفشل في استدعاء API | افتح Connection ، أعد الاتصال واختر Save configuration |
| Not connected | OAuth غير مكتمل أو غير متصل | اختر Connect with PrestaKick ، اختر المتجر الصحيح وتأكد |
| Connected لكن Features لا يزال يبلغ عن خطأ | الإعدادات غير المحفوظة، عنوان URL غير صحيح أو عدم وجود وصول إنترنت صادر | احفظ الإعدادات، تحقق من https://api.prestakick.com ، ثم استخدم Test connection |
| Connection failed / Connection test failed | معلومات مفقودة أو واجهات برمجة تطبيقات غير متاحة | تحقق من Module Secret و API Base URL و Shop ID والاتصال بالشبكة |
| Invalid API Base URL format | رابط الرابط مشوه |
لا تقدم أسرار الوحدة أو مفاتيح API في طلبات الدعم.
خطأ أوث
| الرسالة | ماذا تفعل |
|---|---|
| Invalid connection request | أغلق الصفحة الحالية وابدأ من جديد من Connect with PrestaKick في الوحدة |
| OAuth connection token has expired | ابدأ من الوحدة من جديد؛ الرابط القديم انتهى |
| OAuth connection token has already been used | لا تعيد فتح الرابط القديم؛ ابدأ تدفق اتصال جديد |
| Shop is already connected to another PrestaShop URL | تحقق من الروابط القديمة والجديدة قبل اختيار إعادة الاتصال |
| Only the shop owner can connect this shop | سجل الدخول بحساب مالك أو اطلب من المالك القيام بذلك |
| No unconnected shops | أنشئ ماجرا أو أعد ربط متجر قائم إذا كان هذا ما تنوي فعله |
افتح عملية OAuth واحدة فقط في كل مرة.
الوحدة أو التزامن غير المتصلة تفتقر إلى البيانات
| الظاهرة | كيفية التعامل مع الأمر |
|---|---|
| تقارير الوحدات Offline | تحقق من تفعيل الوحدة، وأن الكرون يعمل وأن الخادم لديه اتصال بالإنترنت |
| تقارير الوحدات Degraded | افتح وظائف الكرون → السجلات، وتحقق من الأخطاء المتكررة وقائمة الانتظار، ثم راقب ما إذا كانت الحالة تستعيد |
| الوحدة تبلغ عن Unknown بعد اتصال جديد | انتظر بضع دقائق وشغل كرون مرة واحدة |
| بيانات لوحة المعلومات القديمة أو المفقودة | تحقق من حالة الوحدة وافتح Data sync لطلب إعادة مزامنة |
| Manual sync is rate limited to once per hour per entity type | انتظر انتهاء الوقت قبل إعادة تشغيل نوع البيانات مرة أخرى |
| تقارير وظائف المزامنة Failed | افتح التفاصيل، حل السبب، ثم أعد تشغيل المهمة |
| Unauthorized: Invalid or missing API Key | تحقق من مفتاح واجهة برمجة التطبيقات في المتجر (Store API)، اختر Save configuration ، أو أعد الاتصال باستخدام OAuth |
| Unauthorized: invalid or missing cron token. | انسخ رموز الكرون من وتحديث حول الاستضافة |
الأداة لا تظهر
تحقق بهذا الترتيب:
- Show Widget مفعل، أو أن عنوان IP للاختبار موجود في Preview IPs.
- أنت اخترت Save configuration.
- اسم النطاق الحالي موجود في Allowed storefront domains.
- الوحدة ليست في حالة Offline.
- المتصفح لا يستخدم JavaScript قديم؛ جرب تحديث قوي أو نافذة متخفية.
- إذا كان الاختبار على الهاتف، ف Show on Mobile يكون على الخدمة.
| الرسالة | ماذا تفعل |
|---|---|
| Widget origin is not allowed for this shop | يضيف المالك اسم النطاق الصحيح في الإعدادات → Domains & Access، ثم يختار Save rules |
| Invalid widget key | أعد توصيل OAuth أو حدث مفتاح Widget جديد في إحالتك الحالية |
| Failed to save widget configuration | تحقق من الاتصال، الأدنى، وحدود الخطة، ثم احفظ مرة أخرى |
| Upgrade to Starter or higher to allow image uploads | الترقية إلى مستوى البداية أو أعلى، أو إيقاف Allow image uploads |
الدردشة ومساعدو الذكاء الاصطناعي
| رسالة أو عرض | ماذا تفعل |
|---|---|
| يفتح الدردشة لكن الذكاء الاصطناعي لا يجيب | تحقق من الحصص، حالة الوحدات، البيانات المتزامنة وإشعارات الخدمة |
| You are sending messages too fast... | انتظر بضع ثوان ثم أعد التقديم |
| AI credits have been exhausted | يشتري المالكون المزيد من الاعتمادات، أو يطورون خطتهم، أو ينتظرون حدا جديدا |
| Too many requests. Please try again later | انتظر وحاول مرة أخرى؛ إذا حدث ذلك بشكل متكرر مع حركة المرور الحقيقية، تواصل مع الدعم |
| Service is temporarily unavailable | حاول مرة أخرى لاحقا؛ يمكن للوكلاء تولي إدارة المحادثات إذا كان صندوق الوارد الدردشة لا يزال نشطا |
| يعطي المساعد إجابة عامة | تحقق من وصف المنتجات، صفحات السياسات، تعليمات المزامنة والمساعد |
| Message could not be sent. | تحقق من الاتصال وحاول مرة أخرى |
| Could not send the image. | تحقق من تنسيق الصورة، حجم الملف، وما إذا كانت الخطة تسمح برفع الصور |
تسجيل الدخول والأمن
| الرسالة | ماذا تفعل |
|---|---|
| Invalid credentials | تحقق من البريد الإلكتروني، كلمة المرور، وقفل Caps؛ استخدم Forgot password إذا لزم الأمر |
| Account is not verified | افتح بريدا إلكترونيا للتحقق أو اطلب إعادة إرسال رابط |
| Account is suspended or locked | تواصل مع الدعم عبر القنوات الرسمية |
| TOTP code is required | أدخل رمزا مكون من ستة أرقام من تطبيق مصادقة |
| TOTP code is invalid | انتظر كودا جديدا وتحقق من أن هاتفك يضبط وقته تلقائيا |
| Refresh token has expired | سجل الدخول مرة أخرى إلى لوحة التحكم |
| التشغيل الحساس غير الكامل | تحقق من دورك وأكمل عملية إعادة التحقق |
| You need an active shop membership... | تحقق من متجرك المختار وحالة العضوية |
إذا فقدت جهاز المصادقة الخاص بك، استخدم رمز استرداد غير مستخدم. لا ترسل رموز TOTP أو الاسترداد للآخرين.
الخطط والحدود
| الرسالة | ماذا تفعل |
|---|---|
| Image search is not available on the current plan | ترقية إلى مستوى البداية أو أعلى، أو إيقاف الميزة |
| Recommendations are not available on the current plan | قم بالترقية إلى Launch أو أعلى، أو إيقاف التوصيات |
| The monthly recommendation request quota has been reached | انتظر لفترة الحصة التالية أو قم بترقية الخطة |
| Current usage exceeds the selected plan limits | قلل من الاستخدام إلى ما دون الحد أو اختر خطة مختلفة |
| Your current plan does not allow connecting another shop | قم بترقية خطتك أو استخدم متجرا ضمن حدودك الحالية |
| Image storage quota exceeded | احذف البيانات غير الضرورية إذا كان هناك خيار مناسب، أو قم بترقية الخطة |
عندما تحتاج للتواصل مع الدعم
التحضير:
- اسم المتجر ونطاق الموقع الإلكتروني.
- لقطة شاشة كاملة لرسالة الخطأ.
- وقت الحدث، مع المنطقة الزمنية.
- الخطوات التي اتخذت للتو.
- ما إذا كان الخطأ يؤثر على الجميع أو على حساب واحد أو جهاز أو عنوان IP واحد فقط.
- السجل ذي الصلة في سجلات CRON Jobs →، إذا كان ذلك مناسبا.
لا ترسل كلمات مرور، أو رموز TOTP، أو رموز الاسترداد، أو أسرار الوحدات، أو مفاتيح واجهة برمجة التطبيقات، أو مفاتيح الويدجت، أو رموز الكرون.