كيفية إضافة روبوت الدردشة Asyntai AI إلى OpenCart

دليل خطوة بخطوة لمواقع OpenCart

المنصة:

The Easy Way: Install the Asyntai Extension

We publish a free extension on the OpenCart Marketplace. It puts the chatbot on your storefront and connects your account, and there is no code to copy and no template to edit. It works on OpenCart 3.x and 4.x.

Download Asyntai - AI Chatbot from the OpenCart Marketplace
In your admin panel, go to Extensions → Installer and upload the ZIP file
Go to Extensions → Extensions, choose Modules in the list, find Asyntai AI Chatbot and press the green install button
Press edit, then press Connect to Asyntai. A window opens where you sign in or create an account.

That is all. The chatbot is live on your storefront when the window closes.

Your products, prices and stock

When you connect, the extension also lets Asyntai read your catalogue. Your assistant then answers with the price you charge today and tells shoppers what is in stock, instead of repeating whatever your pages said when they were last read.

Asyntai reads your products through a read-only address on your own store. Every request is signed, and the reply carries the prices a shopper would actually pay, with your tax rules already applied. You can switch this off at any time on the extension's settings screen.

Updating from version 1.0.0? OpenCart clears a module's settings when you uninstall it, so press Connect to Asyntai once after the update. From this version on, updates keep your connection.

Or Add the Code Yourself

Prefer not to install an extension? The rest of this page shows how to add the chatbot by hand. You will not get the catalogue reading this way.

الخطوة 1: احصل على كود التضمين

First, go to your Asyntai Dashboard and scroll down to the "Embed Code" section. Copy your unique embed code which will look like this:

<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>

ملاحظة: الكود أعلاه مجرد مثال. يجب عليك نسخ كود التضمين الفريد الخاص بك من لوحة التحكم لأنه يحتوي على معرف الأداة الشخصي الخاص بك.

Step 2: Edit Footer Template

أسهل طريقة لإضافة روبوت الدردشة هي تعديل قالب تذييل القالب الخاص بك:

الوصول إلى ملفات OpenCart عبر FTP أو مدير الملفات
انتقل إلى قالب تذييل القالب الخاص بك:
- OpenCart 3.x/4.x: catalog/view/theme/YOUR_THEME/template/common/footer.twig
- OpenCart 2.x: catalog/view/theme/YOUR_THEME/template/common/footer.tpl
افتح ملف التذييل للتعديل
ابحث عن وسم الإغلاق </body>
الصق كود تضمين Asyntai الخاص بك قبل وسم </body> مباشرة
احفظ الملف
امسح ذاكرة التخزين المؤقت لـ OpenCart: Dashboard → أيقونة الترس الزرقاء (أعلى اليمين) → Refresh أو احذف محتويات system/storage/cache/

نصيحة: إذا كنت تستخدم القالب الافتراضي، فسيكون المسار catalog/view/theme/default/template/common/footer.twig. أنشئ دائماً نسخة احتياطية قبل تعديل ملفات القوالب.

بديل: استخدام خيار الكود المخصص في القالب

تتضمن العديد من قوالب OpenCart الحديثة خياراً مدمجاً للكود المخصص:

سجّل الدخول إلى لوحة إدارة OpenCart
انتقل إلى Extensions → Themes (أو Extensions → Extensions → Themes)
انقر على Edit في القالب النشط
ابحث عن قسم "Custom Code" أو "Footer Scripts" أو "Custom JavaScript"
الصق كود تضمين Asyntai
انقر على "Save"
امسح ذاكرة التخزين المؤقت

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

بديل: استخدام إضافة كود مخصص

يمكنك تثبيت إضافة مجانية من سوق OpenCart لإضافة أكواد مخصصة:

Go to the OpenCart Marketplace
ابحث عن "Custom Script" أو "Header Footer Scripts" أو "Custom Code"
قم بتنزيل وتثبيت إضافة مناسبة
في لوحة الإدارة، انتقل إلى Extensions → Extensions → Modules
ابحث عن وحدة الكود المخصص وقم بتثبيتها
قم بتكوين الوحدة والصق كود تضمين Asyntai في قسم التذييل
احفظ وامسح ذاكرة التخزين المؤقت

مهم: يُوصى باستخدام الإضافات بدلاً من تعديل الملفات الأساسية، لأنها تبقى سليمة بعد تحديثات OpenCart. تشمل الإضافات الشائعة "Custom Script in Header & Footer" المتوفرة في السوق.

بديل: استخدام طريقة addScript (للمطورين)

للمطورين، يوفر OpenCart 3.x/4.x طريقة برمجية لإضافة الأكواد:

افتح catalog/controller/common/footer.php
أضف السطر التالي قبل $data['scripts'] = $this->document->getScripts('footer');:
$this->document->addScript('https://asyntai.com/static/js/chat-widget.js', 'footer');
بالنسبة لسمة البيانات، ستحتاج إلى تعديل footer.twig لتضمينها يدوياً، أو إضافة JavaScript مضمن بعد حلقة الأكواد

ملاحظة: لكي تعمل الأداة بشكل صحيح مع سمة البيانات، فإن طريقة القالب أبسط لأن طريقة addScript لا تدعم السمات المخصصة مباشرة.

الخطوة 3: التحقق من التثبيت

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

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

التوثيق