كيفية إضافة روبوت الدردشة Asyntai AI إلى Adobe Commerce (Magento)

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

المنصة:

الخطوة 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>

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

الخطوة 2: استخدام منشئ الصفحات (مُوصى به)

أسهل طريقة لإضافة روبوت الدردشة هي استخدام كتلة كود HTML في منشئ الصفحات:

سجّل الدخول إلى لوحة إدارة Magento
انتقل إلى Content → Pages
حرر الصفحة الرئيسية (أو أي صفحة تريد فيها روبوت الدردشة)
في منشئ الصفحات، اسحب عنصر "HTML Code" إلى الصفحة
الصق كود تضمين Asyntai
انقر على "Save"
امسح ذاكرة التخزين المؤقت: System → Cache Management → Flush Magento Cache

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

بديل: استخدام Layout XML (جميع الصفحات)

لإضافة روبوت الدردشة إلى جميع الصفحات، أنشئ ملف تخطيط في قالبك:

انتقل إلى مجلد القالب: app/design/frontend/[Vendor]/[theme]/
أنشئ بنية المجلدات إذا لم تكن موجودة: Magento_Theme/layout/
أنشئ أو حرر ملف default_head_blocks.xml
أضف الكود التالي:
<?xml version="1.0"?> <page xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:View/Layout/etc/page_configuration.xsd"> <head> <script src="https://asyntai.com/static/js/chat-widget.js" src_type="url" async="true" data-asyntai-id="YOUR_WIDGET_ID"/> </head> </page>
استبدل YOUR_WIDGET_ID بمعرف الأداة الفعلي الخاص بك
نفّذ: bin/magento cache:flush
نفّذ: bin/magento setup:static-content:deploy -f (إذا كنت في وضع الإنتاج)

بديل: استخدام كتلة CMS

يمكنك أيضًا إنشاء كتلة CMS وتضمينها في التذييل:

انتقل إلى Content → Blocks
انقر على "Add New Block"
اضبط عنوانًا مثل "Asyntai Chatbot"
اضبط المعرف على asyntai_chatbot
في محرر المحتوى، بدّل إلى وضع HTML والصق كود التضمين
انقر على "Save Block"
أضف الكتلة إلى قالب التذييل باستخدام: {{block id="asyntai_chatbot"}}
امسح ذاكرة التخزين المؤقت

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

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