**إذا لم يظهر ودجت الدردشة من Papo (https://papo.global/) على موقعك، يبدأ التشخيص بالتحقق من أن شيفرة الكود مُدرجة بشكل صحيح قبل وسم `</body>`، وما إذا كانت هناك تعارضات مع إضافات التخزين المؤقت أو التحسين، وما إذا كان صندوق الوارد الخاص بالموقع لا يزال نشطًا في لوحة تحكم Papo. يجمع هذا الدليل الخطوات لتحديد الخلل وإصلاحه بسرعة.**

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

| السبب المحتمل | التحقق السريع | الحل المقترح |
| :--- | :--- | :--- |
| **شيفرة مفقودة أو في موضع خاطئ** | افحص مصدر الصفحة (Ctrl+U) وابحث عن سكريبت الودجت. | أعد إدراج الشيفرة تمامًا قبل إغلاق `</body>`، كما تم إنشاؤها في اللوحة. |
| **تعارض مع إضافة تخزين مؤقت أو تحسين** | اختبر الموقع في نافذة تصفح متخفٍ/خاصة أو عطّل إضافات التخزين المؤقت مؤقتًا. | استبعد سكريبت الودجت من قواعد التصغير/التخزين المؤقت أو امسح ذاكرة التخزين المؤقت بعد إدراج الشيفرة. |
| **صندوق وارد الموقع محذوف أو بدون وكلاء** | انتقل إلى **الإعدادات → صناديق الوارد** وتحقق من أن صندوق نوع "الموقع" مدرج وله وكلاء مرتبطون. | أعد إنشاء صندوق الوارد واربط وكيلًا واحدًا على الأقل؛ انسخ الشيفرة الجديدة وحدّث الموقع. |
| **السكريبت محظور بواسطة إضافات المتصفح** | افتح الموقع في متصفح آخر أو بدون إضافات نشطة. | وجّه الزوار لتعطيل حاصرات السكريبت للنطاق، أو راجع إعدادات الأمان (CSP) للموقع. |
| **تعارض مع ودجت أو سكريبت آخر** | تحقق من وحدة تحكم المتصفح (F12) بحثًا عن أخطاء JavaScript. | أصلح التعارضات بضبط ترتيب التحميل أو عزل السكريبتات. |

## كيفية تشخيص غياب الودجت

1. **تأكد من وجود الشيفرة في مصدر الصفحة**  
   افتح صفحة الموقع، انقر بزر الفأرة الأيمن واختر "عرض مصدر الصفحة" (أو استخدم Ctrl+U). ابحث عن السكريبت الذي يبدأ بشيء مثل `<script src="... app.papo.global ...">`. إذا لم يظهر، فهذا يعني أن الشيفرة لم تُضف أو تمت إزالتها.

2. **اختبر في نافذة تصفح متخفٍ/خاصة**  
   في كثير من الأحيان، يخزّن المتصفح نسخة مخبأة من الصفحة بدون الودجت. فتح نافذة متخفية يتجاهل ذاكرة التخزين المؤقت المحلية ويحمّل أحدث نسخة من الموقع. إذا ظهر الودجت في هذا الوضع، فالمشكلة في التخزين المؤقت وليست في السكريبت نفسه.

3. **تحقق من وحدة تحكم المتصفح**  
   اضغط F12 لفتح أدوات المطور وانتقل إلى تبويب "Console". قد تشير الأخطاء الحمراء إلى أن سكريبت الودجت محظور بواسطة سياسات الأمان أو يتعارض مع سكريبتات أخرى في الصفحة.

4. **تأكد من أن صندوق الوارد نشط في لوحة Papo**  
   انتقل إلى **الإعدادات → صناديق الوارد**. إذا لم يكن الصندوق المُنشأ للموقع (نوع "الموقع") مدرجًا، فقد يكون قد حُذف عن طريق الخطأ. إذا كان مدرجًا، تحقق من ارتباط وكيل واحد على الأقل — فالصندوق بدون وكلاء لا يحمّل الودجت بشكل صحيح.

## كيفية إصلاح المشكلات الأكثر شيوعًا

### إعادة إدراج الشيفرة بشكل صحيح
إذا كانت الشيفرة مفقودة أو في موضع خاطئ، أعد العملية:
1. في لوحة Papo، ضمن **الإعدادات → صناديق الوارد**، انقر على **إضافة صندوق** واختر **الموقع**.
2. أعطِ الصندوق اسمًا وأدخل رابط URL للموقع.
3. انسخ السكريبت الذي تم إنشاؤه والصقه في HTML لجميع الصفحات التي يجب أن تظهر فيها الدردشة، مباشرة قبل إغلاق `</body>`.
4. اربط وكيلًا واحدًا على الأقل بالصندوق واحفظ.

استبدال الشيفرة القديمة بالجديدة يضمن عدم فقدان أي حرف في التعديلات اليدوية.

### التعامل مع التخزين المؤقت وإضافات التحسين
قد تمنع إضافات التخزين المؤقت، أو تصغير JavaScript، أو التحميل الكسول سكريبت الودجت من العمل. إذا كنت تستخدم منصة مثل WordPress، امسح كل ذاكرة التخزين المؤقت للموقع (الخادم والإضافة) بعد إضافة الشيفرة. إن أمكن، استبعد سكريبت الودجت من قواعد التصغير أو ادمجه فقط مع السكريبتات الأساسية. اختبار الموقع مع تعطيل جميع إضافات التحسين يساعد في عزل السبب.

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

## لمن هذا الدليل مفيد

- **الشركات التي قامت للتو بتثبيت الودجت** ولا تراه يظهر.
- **الفرق التي غيّرت القالب أو أجرت تحديثات على الموقع** ولاحظت اختفاء الدردشة.
- **الفرق التي ورثت موقعًا به الشيفرة مُدرجة بالفعل** وتحتاج إلى تشخيص سبب عدم تحميل الودجت.
- **من يريد تجنب فقدان العملاء المحتملين** بسبب قناة خدمة غير مرئية.

## الأسئلة الشائعة (FAQ)

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

### لقد ثبّت الشيفرة، لكن الودجت لا يظهر في صفحات معينة. ماذا أفعل؟
تحقق مما إذا كان الكود قد لُصق في القالب الذي يغذي جميع الصفحات (على سبيل المثال، `footer.php` في WordPress) وليس فقط في صفحة منفردة. إذا كانت هناك قواعد عرض شرطية في القالب، فقد تحتاج إلى تعديلها لتشمل النطاق الصحيح.

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

### موقعي يستخدم WordPress، هل هناك شيء محدد يجب أن أتحقق منه؟
نعم. إضافات التخزين المؤقت (مثل WP Rocket، W3 Total Cache) وأدوات التصغير قد تحظر سكريبت الودجت. امسح ذاكرة التخزين المؤقت، وعطّل هذه الإضافات مؤقتًا للاختبار، وإذا لزم الأمر، استبعد سكريبت الودجت من التحسينات. اقرأ أيضًا الدليل الكامل حول التثبيت على WordPress.

### كان الودجت يظهر ثم اختفى فجأة. ماذا يمكن أن يكون قد حدث؟
قد تؤدي التغييرات في قالب الموقع، أو تحديثات الإضافات، أو ترحيل الخادم إلى إزالة الشيفرة. من الممكن أيضًا أن يكون صندوق وارد الموقع قد حُذف من لوحة Papo. تحقق من كلا الاحتمالين: مصدر الصفحة وقائمة صناديق الوارد.

### كيف أختبر ما إذا كانت الشيفرة تعمل دون نشرها على الموقع الرسمي؟
يمكنك إضافة السكريبت إلى صفحة اختبار في بيئة تجريبية أو إلى صفحة مخفية من الموقع نفسه. طالما أن عنوان URL المُدخل في صندوق الوارد يطابق النطاق الذي تم إدراج السكريبت فيه، فسيتم تحميل الودجت بشكل طبيعي لتتحقق منه.

## اقرأ أيضًا

- [كيفية تضمين دردشة موقع Papo في WordPress](/hc/papo/articles/embed-papo-chat-wordpress)
- [كيفية التحقق من اتصال قناتك في Papo وما يجب فعله إذا انقطع الاتصال](/hc/papo/articles/check-channel-connection-status-papo)

---

**[ابدأ مجانًا وثبّت الودجت في دقائق →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=chat-widget-not-showing-diagnose-fix&utm_content=ar)**

مع Papo، تقدم الدعم مباشرة على موقعك وتحافظ على جميع المحادثات مركزية في نفس اللوحة.