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

في هذه المقالة
انتقل متجرك إلى Hyvä، وأصبح تقرير مؤشرات أداء الويب الأساسية (Core Web Vitals) في Search Console أخضر أخيرًا. ثم يطلب أحدهم إضافة محادثة مباشرة قبل زحام موسم الأعياد، فيصمت المطوّر لديك. ولهذا ما يبرره: فسكربت خارجي ثقيل واحد قد يضيّع جزءًا كبيرًا مما كسبته من الانتقال.
المحادثة المباشرة على Hyvä لا تعني بالضرورة التضحية بهذه السرعة. اختر إضافة لا تعتمد واجهتها الأمامية على JavaScript الخاص بقالب Luma، ولا تجعل عرض الصفحة ينتظر أبدًا واجهة API الخاصة بالمورّد، وقرّر عن قصد هل مكان المحادثة في صفحة الدفع أم لا، وقِس Core Web Vitals قبل التثبيت وبعده.
فيما يلي: ما الذي يجب التحقق منه، وكيف تتلاءم إضافة Conviro لـMagento (ماجنتو) مع متجر Hyvä، وروتين اختبار لبيئة التجربة (staging).
أهم النقاط
- يستغني Hyvä عن RequireJS وKnockout وjQuery في الواجهة الأمامية، لذا تحتاج الإضافات المبنية عليها إلى وحدة توافق أو إلى إعادة عمل.
- قد تُبطئ المحادثة المتجر في موضعين: الاستدعاءات من جهة الخادم، وJavaScript في الواجهة الأمامية؛ فتحقق من الاثنين.
- قِس LCP وINP وCLS في بيئة التجربة قبل التثبيت وبعده، ثم تأكد من النتائج ببيانات الاستخدام الفعلي (field data).
لماذا تحتاج المحادثة المباشرة على Hyvä إلى عناية إضافية
الواجهة الأمامية في Luma مبنية على RequireJS وKnockout.js وjQuery وLESS. أما Hyvä فيستبدل هذه المجموعة بـAlpine.js وTailwind CSS، ويزيل معظم JavaScript الذي تحمّله صفحة Luma. ومن هنا تأتي سرعته، وهذا أيضًا سبب عدم عمل كثير من الإضافات التي صُممت في عهد Luma عليه دون تعديل.
يمكن لإضافة المحادثة أن تصل إلى الواجهة الأمامية لمتجرك بثلاث طرق، ولكل منها طريقة فشل مختلفة على Hyvä:
| كيف تصل المحادثة إلى الصفحة | ماذا يعني ذلك على Hyvä |
|---|---|
| ملفات Layout XML مع وحدات RequireJS وقوالب Knockout | تتعطل أو لا يظهر شيء دون وحدة توافق مع Hyvä |
| سكربت مستقل من المورّد يُحقن في الصفحة | لا يرتبط بالقالب عادةً، لكن حجمه وطريقة تحميله ينعكسان على Core Web Vitals لديك |
| استدعاءات PHP لواجهة API الخاصة بالمورّد أثناء عرض الصفحة | تضيف وقت استجابة المورّد إلى وقت توليد الصفحة، أيًا كان القالب |
الصف الأول مشكلة توافق. أما الصفّان الآخران فمشكلتا أداء، ومن السهل أن تفوتاك لأن المحادثة "تعمل" رغم ذلك.
ما الذي تتحقق منه في إضافة محادثة متوافقة مع Hyvä
إصدار Hyvä الذي اختُبرت عليه وتعديلات القالب
اسأل المورّد عن إصدار Hyvä الذي اختبر عليه، وهل تلزم وحدة توافق، وهل ستحتاج إلى تجاوز القوالب (template overrides). فعبارة "تعمل مع Hyvä" دون رقم إصدار نقطة بداية، لا إجابة.
حجم السكربت وطريقة تحميله
افتح صفحة منتج في Chrome DevTools مع تعطيل ذاكرة التخزين المؤقت وتفعيل محاكاة سرعة الجوال (throttling). وفي لوحة Network، صفِّ الطلبات حسب نطاقات مورّد المحادثة، ودوّن ما يُحمَّل قبل أن ينقر أي شخص على زر تشغيل المحادثة: عدد الطلبات، وحجم JavaScript المنقول، والخطوط، وهل يجلب نسخته الخاصة من jQuery أو من إطار عمل آخر. ثم سجّل تتبعًا في لوحة Performance وابحث عن المهام الطويلة (long tasks) التي تتجاوز 50 مللي ثانية وتأتي من سكربت المحادثة، فهي التي تؤخر الاستجابة للمسات وتضر بمؤشر INP.
الاستدعاءات من جهة الخادم أثناء عرض الصفحة
فحص سريع قبل تثبيت أي شيء:
grep -rnE "GuzzleHttp|HTTP.Client|curl_init" vendor/<vendor>/<module>/
أي نتيجة داخل observers أو plugins أو blocks تعمل مع طلبات الواجهة الأمامية للمتجر تستحق نظرة أدق. فلا ينبغي لوحدة المحادثة أن تجعل توليد الصفحة ينتظر واجهة API بعيدة، ولا ينبغي أن تعتمد صفحة الدفع على توفر خدمة المورّد.
نطاق صفحة الدفع
Hyvä Checkout منتج منفصل عن قالب Hyvä؛ والمتاجر التي لا تستخدمه تعمل عادةً بصفحة الدفع البديلة من Hyvä المبنية على Luma، أو بصفحة دفع من طرف ثالث. اعرف أيهما لديك، واختبر المحادثة عليها تحديدًا. ولاحظ أيضًا أن صفحات الدفع، بدءًا من Magento 2.4.7، تفرض سياسة أمان المحتوى (Content Security Policy) في الوضع المقيِّد (restrict mode) افتراضيًا، لذا يجب السماح صراحةً بأي سكربت خارجي فيها. وراجع وحدة تحكم المتصفح (console) في صفحة الدفع بحثًا عن انتهاكات CSP.
الموضع على الجوال
إذا كانت صفحات منتجاتك تستخدم شريط "أضف إلى السلة" ثابتًا على الجوال، فتأكد من أن زر تشغيل المحادثة لا يغطيه ولا يغطي لافتة ملفات تعريف الارتباط (الكوكيز). ويتناول دليلنا عن أفضل ممارسات أداة المحادثة الموضع والتوقيت بتفصيل أكبر.
كيف تتلاءم إضافة Conviro لـMagento مع متجر Hyvä
تمنح إضافة Conviro for Magento مساعدَ الذكاء الاصطناعي الأسعار والمخزون مباشرة وحالة الطلبات بعد التحقق، وتحوّل المحادثات إلى فريقك عند الحاجة؛ ويعرض دليلنا عن إضافة Magento المجانية الميزات كاملة. وبالنسبة إلى متجر Hyvä، تهم النقاط التالية:
- مُختبرة على Hyvä 1.5.2. اختُبر تثبيت الإضافة على Magento 2.4.9 مع PHP 8.4 على كل من Luma وHyvä 1.5.2، دون الحاجة إلى أي تعديل في القالب. وتعرض صفحة الإصدارات المدعومة جدول التوافق الحالي.
- لا استدعاءات PHP من صفحات المتجر. لا تستدعي صفحات الواجهة الأمامية للمتجر Conviro عبر PHP، لذا لا ينتظر توليد الصفحة واجهة API الخاصة بـConviro.
- قائمة انتظار بدلًا من التعطيل. تُكتب أحداث الدفع والتسجيل وحفظ المنتجات في قائمة انتظار محلية تتولى مهام cron في Magento إرسالها في الخلفية. وإذا تعذّر الوصول إلى Conviro، تستمر معالجة الطلبات.
- Hyvä Checkout غير مُختبر. إذا كنت تستخدمه لصفحة الدفع، فنفّذ طلبات تجريبية كاملة بكل وسيلة دفع في بيئة التجربة قبل الإطلاق الفعلي، وأبلغ عن أي سلوك غريب قبل الإطلاق.
- توثيق للواجهات الأمامية غير القياسية. يتضمن توثيق الإضافة صفحة عن إعدادات headless وPWA وHyvä.
يتم التثبيت عبر Composer بالطريقة المعتادة؛ ويضم دليل تثبيت Magento 2 كل الأوامر، وتقدّم صفحة تكامل Magento 2 النظرة العامة. الإضافة مجانية؛ أما ربط المتجر فيتطلب باقة Pro أو أعلى (راجع الأسعار). وكما هو الحال مع أي سكربت خارجي، قِس أداة المحادثة على قوالبك أنت بدلًا من الاكتفاء بكلام أي أحد، وكلامنا من ضمنه.
قائمة اختبار المحادثة المباشرة على Hyvä: قبل التثبيت وبعده
هذه هي حدود "الجيد" لدى Google (جوجل)، وتُقاس عند المئين الخامس والسبعين من عمليات تحميل الصفحات الفعلية:
| المؤشر | جيد | كيف يمكن أن تؤثر فيه المحادثة | أين تقيسه |
|---|---|---|---|
| LCP | ≤ 2.5 ثانية | تنافس على عرض النطاق والخيط الرئيسي (main thread) أثناء التحميل | Lighthouse وPageSpeed Insights |
| INP | ≤ 200 مللي ثانية | المهام الطويلة تؤخر الاستجابة للمسات والنقرات | بيانات الاستخدام الفعلي؛ وTBT بديلًا في الاختبار المعملي |
| CLS | ≤ 0.1 | أزرار التشغيل أو اللافتات التي تزيح المحتوى عند ظهورها | Lighthouse ولوحة Performance في DevTools |
نفّذ هذا الروتين على نسخة تجريبية تطابق بيئة الإنتاج: وضع الإنتاج (production mode)، وذاكرة التخزين المؤقت للصفحة الكاملة (full-page cache) مفعّلة، وVarnish إذا كانت بيئة الإنتاج تستخدمه.
- خط الأساس. شغّل Lighthouse في وضع الجوال خمس مرات لكل من الصفحة الرئيسية وصفحة الفئة وصفحة المنتج وصفحة السلة، وسجّل الوسيط. واحفظ بيانات الاستخدام الفعلي من PageSpeed Insights لعناوين URL في بيئة الإنتاج.
- التثبيت والربط. ثبّت الإضافة عبر Composer، وشغّل معالج الإعداد، وامسح ذاكرة التخزين المؤقت.
- أعِد الاختبار. كرّر عمليات التشغيل نفسها تمامًا، وقارن الوسيط، وحجم JavaScript المنقول، وعدد الطلبات، والمهام الطويلة.
- اختبر المحادثات. اسأل عن مخزون متغير واحد من منتج قابل للتهيئة (configurable product)، وتأكد من عملة واجهة المتجر (store view)، واطلب التحدث إلى شخص. وتضم قائمة اختبار الشات بوت بالذكاء الاصطناعي مزيدًا من السيناريوهات.
- اختبر صفحة الدفع. نفّذ طلبات بكل وسيلة دفع، وراقب وحدة التحكم (console) بحثًا عن الأخطاء وانتهاكات CSP.
- راقب بيانات الاستخدام الفعلي. يعتمد تقرير Core Web Vitals في Search Console على فترة 28 يومًا، لذا احكم على الأثر بعد بضعة أسابيع، لا بعد بضع ساعات.
الأسئلة الشائعة
هل أحتاج إلى وحدة توافق مع Hyvä لإضافة المحادثة المباشرة؟
فقط إذا كانت الواجهة الأمامية لإضافة المحادثة تعتمد على شيفرة RequireJS أو Knockout أو jQuery الخاصة بـLuma. أما الإضافات التي تحمّل سكربتًا مستقلًا فلا تحتاج إليها عادةً، لكن اسأل دائمًا عن إصدار Hyvä الذي اختُبرت عليه. وقد اختُبر تثبيت إضافة Conviro لـMagento على Hyvä 1.5.2 دون الحاجة إلى أي تعديل في القالب.
هل تضر أداة المحادثة بمؤشرات Core Web Vitals في متجري على Hyvä؟
قد تضر بها، غالبًا عبر INP إذا نفّذ السكربت مهام طويلة، وعبر LCP إذا نافس الصورة الرئيسية أثناء التحميل. والإجابة الموثوقة الوحيدة هي القياس: شغّل Lighthouse في بيئة التجربة قبل التثبيت وبعده، وقارن الوسيط، ثم راجع بيانات الاستخدام الفعلي في Search Console بعد بضعة أسابيع.
هل تعمل Conviro مع Hyvä Checkout؟
لم تُختبر معه بعد. إضافة Conviro مُختبرة على قالب Hyvä 1.5.2 وعلى Luma، لكن Hyvä Checkout منتج منفصل وليس ضمن قائمة ما اختُبر. وإذا كنت تستخدمه، فنفّذ طلبات تجريبية كاملة بكل وسيلة دفع في بيئة التجربة قبل الإطلاق الفعلي.
الخطوات التالية
سجّل أرقام خط الأساس هذا الأسبوع، قبل أن تقترب الإضافة من بيئة الإنتاج. ثم ثبّتها في بيئة التجربة، ونفّذ قائمة التحقق، وقارن النتائج. وعندما تصمد الأرقام، أنشئ حسابك في Conviro، واختر باقة Pro أو أعلى، واربط متجرك على Hyvä.
نشرت من قبل
كونفيرو
مشاركة الرؤى حول دعم العملاء المدعوم بالذكاء الاصطناعي وأتمتة روبوتات الدردشة واستراتيجيات نمو SaaS.
ضع كتاب اللعب موضع التنفيذ
حوّل معرفتك بالدعم إلى إجابات أسرع
استكشف مساحة عمل دعم الذكاء الاصطناعي في Conviro، ثم ابدأ مجانًا عندما يناسب سير العمل فريقك.
مقالات ذات صلة
المزيد من المشاركات
Guides & Tutorials
WhatsApp Business متعدد المستخدمين: كيف يتشارك أفراد الفريق رقمًا واحدًا من هواتفهم
7 دقيقة قراءة
اقرأ المقال
Guides & Tutorials
تطبيق محادثة مباشرة لـAndroid: كيف ترد على زوار موقعك من هاتفك
7 دقيقة قراءة
اقرأ المقال
Guides & Tutorials
تطبيق إدارة رسائل Instagram للشركات: رد على عملائك من هاتفك
7 دقيقة قراءة
اقرأ المقال