إذا كان موقعك مبنيًا بملفات HTML عادية، فإضافة شات بوت MirajX تكون غالبًا سهلة جدًا. ستضع كودًا واحدًا قبل وسم الإغلاق </body> في صفحات الموقع.

الحصول على كود MirajX

  1. سجّل الدخول إلى لوحة العميل في MirajX.
  2. افتح قسم الودجت أو كود التضمين.
  3. انسخ كود التضمين كاملًا. إذا لم يظهر التوكن، اضغط Regenerate Token وانسخ الكود الجديد.
  4. لا تعدّل الكود إلا إذا طلب منك فريق MirajX ذلك.

الخطوات من cPanel

  1. سجّل الدخول إلى cPanel.
  2. افتح File Manager.
  3. افتح public_html. هذا غالبًا هو مجلد الموقع الرئيسي.
  4. ابحث عن ملف الصفحة الرئيسية. غالبًا يكون index.html أو أحيانًا index.htm.
  5. حمّل نسخة احتياطية من الملف قبل أي تعديل.
  6. اختر الملف واضغط Edit.
  7. انزل إلى نهاية الملف وابحث عن </body>.
  8. الصق كود MirajX فوق </body> مباشرة.
  9. احفظ الملف.

هل يجب إضافته لكل الصفحات؟

إذا كان موقعك مكوّنًا من ملف واحد فقط، فإضافة الكود إلى index.html تكفي. أما إذا كان الموقع يحتوي على صفحات منفصلة مثل about.html و services.html و contact.html، فأضف نفس الكود قبل </body> في كل صفحة تريد ظهور الشات بوت فيها.

مثال على مكان الكود

<footer>
  محتوى الفوتر
</footer>

<script
  src="https://your-mirajx-domain.com/widgets/mirajx_chatboot.js"
  data-webhook-url="https://your-mirajx-domain.com/api/runtime/chat"
  data-widget-config-url="https://your-mirajx-domain.com/api/runtime/widget-config"
  data-brand-name="Your Business Name"
  data-tenant-id="YOUR_TENANT_ID"
  data-agent-id="YOUR_AGENT_ID"
  data-widget-token="YOUR_WIDGET_TOKEN"
></script>
</body>
</html>

طريقة الاختبار

  • افتح الموقع من نافذة خاصة أو Incognito.
  • انتظر بضع ثوانٍ حتى تنتهي الصفحة من التحميل.
  • ابحث عن فقاعة المحادثة، غالبًا في زاوية الموقع السفلية.
  • أرسل سؤالًا قصيرًا للتأكد من أن المساعد يرد.

أخطاء شائعة

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

ملاحظة أمان

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