كيفية تثبيت ويدجت الدردشة من Papo على موقع HTML ثابت

Q: ماذا أفعل إذا لم يظهر الويدجت على الموقع؟

تحقق من أن الكود مُدرج قبل ، وأن صندوق الوارد نشط وبه وكلاء مرتبطون، وأنه لا توجد مانعات نصوص برمجية في المتصفح. كما يساعد مسح ذاكرة التخزين المؤقت للموقع.

لتثبيت ويدجت الدردشة من Papo (https://papo.global/) على موقع HTML ثابت، انسخ الكود المُنشأ في لوحة التحكم والصقه مباشرة في الكود المصدري، قبل وسم </body>، في جميع الصفحات التي يجب أن تظهر فيها خدمة العملاء. يتم تخصيص الألوان ورسالة الترحيب بالكامل في لوحة التحكم دون تعديل HTML.

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

كيفية تثبيت الويدجت على موقع HTML ثابت

أنشئ صندوق وارد من نوع موقع
في لوحة تحكم Papo، انتقل إلى الإعدادات → صناديق الوارد، انقر على إضافة صندوق واختر موقع. أدخل اسمًا (مثل: 'دردشة الموقع') وعنوان URL للموقع (لا يؤثر على العمل، يساعد فقط في تحديد القناة). لا حاجة لتثبيت أي إضافة؛ العملية نفسها لأي موقع يقدم ملفات HTML.
انسخ الكود المُنشأ
بعد إنشاء الصندوق، تعرض لوحة التحكم كود JavaScript فريدًا. انسخ كتلة <script>...</script> بالكامل.
الصق الكود في HTML
افتح ملف HTML للصفحة (على سبيل المثال، index.html) وأدخل الكود مباشرة قبل وسم </body>. افعل ذلك في كل صفحة تريد عرض الدردشة فيها. إذا كان الموقع يستخدم ملف تذييل أو رأس مشترك (عبر include أو PHP)، فإن إضافة الكود في هذا الملف الواحد تنشط الويدجت في الموقع بأكمله.

مثال على الموضع في الكود:
```
<body>
  
  <script src="https://app.papo.global/..."></script>
</body>
```
لا يُطلب أي معرفة بالواجهة الخلفية؛ يعمل الويدجت في متصفح الزائر.
اربط الوكلاء بالصندوق
عد إلى لوحة التحكم، في نفس صندوق الوارد، وأضف وكيلًا واحدًا على الأقل. بدون وكيل مرتبط، يبقى الصندوق بدون مشغل وقد لا يظهر الويدجت. إذا كان لديك وكيل واحد فقط، يكون الربط تلقائيًا؛ في الفرق، حدد الأعضاء المسؤولين.

تخصيص الألوان ورسالة الترحيب

بعد لصق الكود، يمكنك تخصيص مظهر الويدجت دون تعديل الكود:

اللون الرئيسي: في لوحة التحكم، ضمن إعدادات الصندوق، اختر اللون الذي يتناسب مع الهوية البصرية للموقع. ينعكس التغيير فورًا.
رسالة الترحيب: فعّل التحية الاستباقية واكتب نصًا يظهر تلقائيًا بعد بضع ثوانٍ. أمثلة فعالة: "مرحبًا! كيف يمكننا المساعدة؟" أو "هل تحتاج مساعدة بشأن طلبك؟".

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

كيفية اختبار جمع العملاء المحتملين

افتح الموقع في نافذة تصفح متخفي (لتجنب الذاكرة المؤقتة) وتحقق من ظهور أيقونة الدردشة في زاوية الشاشة.
انقر على الأيقونة وأرسل رسالة تجريبية (على سبيل المثال، "أريد مزيدًا من المعلومات").
في لوحة تحكم Papo، افتح صندوق الوارد للموقع وتأكد من ظهور المحادثة. سيتم تسجيل جهة الاتصال تلقائيًا في CRM، ويمكنك الرد من خلال لوحة التحكم.

إذا لم تصل الرسالة، تحقق من أن الكود موجود قبل </body>، وأن صندوق الوارد نشط، وأن هناك وكيلًا واحدًا على الأقل مرتبطًا. قد تمنع مانعات النصوص البرمجية التحميل؛ اختبر أيضًا بدون إضافات نشطة.

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

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

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

هل أحتاج إلى خادم خلفي لاستخدام الويدجت؟

لا. يعتمد الويدجت على JavaScript يعمل في المتصفح. ما عليك سوى لصق الكود في HTML وستعمل الدردشة.

هل يجب نسخ الكود في جميع الصفحات؟

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

هل يمكنني تخصيص الألوان بعد التثبيت؟

نعم، يتم إجراء تغييرات اللون ونص رسالة الترحيب في لوحة تحكم Papo وتظهر تلقائيًا في الويدجت، دون الحاجة إلى تعديل الكود.

ماذا أفعل إذا لم يظهر الويدجت على الموقع؟

تحقق من أن الكود مُدرج قبل </body>، وأن صندوق الوارد نشط وبه وكلاء مرتبطون، وأنه لا توجد مانعات نصوص برمجية في المتصفح. كما يساعد مسح ذاكرة التخزين المؤقت للموقع.

هل أحتاج إلى إعادة إنشاء الكود لكل موقع مختلف؟

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

هل يؤثر الويدجت على أداء الموقع؟

التحميل غير متزامن ولا يمنع عرض الصفحة. ملف الويدجت خفيف ويُحمّل فقط عند الحاجة.