تخط وانتقل إلى المحتوى الرئيسي

دليل ربط بزنس شات بمنصة ماجنتو

يرشدك هذا الدليل الشامل خطوة بخطوة خلال عملية تثبيت وتهيئة وتفعيل ربط نظام بزنس شات بمتجرك الإلكتروني على منصة ماجنتو.

📋 قائمة التحقق (قبل البدء)

يرجى التأكد من جاهزية المتطلبات التالية لديك أو لدى مطور الموقع قبل البدء في عملية التثبيت:

  • إصدار ماجنتو (Magento Version): يجب أن يكون الإصدار 2.4.x أو أحدث.

  • مستويات الوصول (Access Levels): ستحتاج إلى كل من:

    1. بيانات تسجيل الدخول إلى لوحة تحكم مدير ماجنتو (Magento Admin Panel).

    2. صلاحية الوصول إلى الخادم (عبر SSH أو FTP/SFTP أو مدير ملفات cPanel).

📂 الخطوة 1: رفع الملفات

بمجرد فك ضغط مجلد بزنس شات، يجب عليك نقله ورفعه إلى خادم ماجنتو الخاص بك.

الهدف النهائي: يجب أن يكون مسار الملف النهائي بعد الرفع مطابقاً تماماً لهذا الهيكل:

your-magento-root/app/code/BusinessChat/Integration/registration.php

كيفية الرفع (اختر طريقة واحدة)

  • الخيار أ (موصى به للمحترفين): استخدم بروتوكول SSH/SCP لرفع مجلد BusinessChat بعد فك ضغطه مباشرة إلى مسار app/code/.

  • الخيار ب (بروتوكول FTP العادي): استخدم برنامج عميل FTP (مثل FileZilla) لسحب وإفلات مجلد BusinessChat داخل مسار app/code/.

  • الخيار ج (مدير ملفات cPanel): قم برفع ملف الـ ZIP المضغوط مباشرة إلى مسار app/code/ باستخدام مدير ملفات cPanel، ثم قم بفك ضغطه هناك.

💡 نصيحة الدعم الفني: إذا لم يكن مجلد code موجوداً بالفعل داخل مجلد app/ لديك، فقم بإنشائه يدوياً أولاً باسم code ثم ارفع الملفات بداخله!

💻 الخطوة 2: تشغيل أوامر الإعداد

تتطلب منصة ماجنتو تشغيل سلسلة من الأوامر البرمجية عبر الطرفية (Terminal) للتعرف على ملفات الإضافة الجديدة وتفعيلها وتجميعها. قم بتشغيل الأوامر التالية في طرفية الخادم، واحداً تلو الآخر، من المجلد الرئيسي لماجنتو (Magento root directory):

  1. تمكين الإضافة (Enable Module): php bin/magento module:enable BusinessChat_Integration

  2. ترقية وتحديث قاعدة البيانات (Upgrade): php bin/magento setup:upgrade

  3. تجميع ملفات الاعتماد والتبعية (Compile): php bin/magento setup:di:compile

  4. نشر ملفات العرض الثابتة (Deploy Static Content): php bin/magento setup:static-content:deploy -f

  5. تفريغ ذاكرة التخزين المؤقت (Flush Cache): php bin/magento cache:flush

🔑 الخطوة 3: ربط معرّف الأعمال (Business ID)

الآن، توجه إلى لوحة تحكم ماجنتو لربط حساب متجرك بحساب بيزنس شات الخاص بك.

  1. سجل الدخول إلى لوحة تحكم مدير ماجنتو (Magento Admin Panel).

  2. انتقل إلى المتاجر (Stores) > الإعدادات (Configuration).

  3. من القائمة الجانبية، اختر BusinessChat > إعدادات الربط (Integration Settings).

  4. أدخل معرّف الأعمال (Business ID) الخاص بك في الحقل المخصص، ثم اضغط على حفظ الإعدادات (Save Config).

  5. ⚠️ خطوة حاسمة جداً: يجب عليك تفريغ ذاكرة التخزين المؤقت مجدداً لتطبيق التغييرات. اذهب إلى النظام (System) > إدارة ذاكرة التخزين المؤقت (Cache Management) واضغط على تفريغ ذاكرة تخزين ماجنتو المؤقتة (Flush Magento Cache).

🤝 الخطوة 4: التفعيل النهائي

تنشئ هذه الخطوة بروتوكول اتصال آمن وصلاحيات تبادل البيانات (API Handshake) بين متجر ماجنتو وبيزنس شات.

  1. في الطرفية (Terminal): قم بتشغيل الأمر التالي لإنشاء عملية الربط برمجياً: php bin/magento businesschat:integration:create

  2. في لوحة تحكم مدير ماجنتو: اذهب إلى النظام (System) > عمليات الربط (Integrations)

  3. تفعيل الإضافة: ابحث عن السطر المسمى "Business Chat Integration"، ثم اضغط على تفعيل (Activate)، وبعد ذلك اختر السماح (Allow) للموافقة على منح الأذونات المطلوبة.

🔒 الخطوة 5: إعداد الأمان "الإلزامي"

⚠️ ملاحظة بالغة الأهمية: لن تعمل عملية الربط ولن يتم مزامنة أو إرسال أي أحداث من متجرك الإلكتروني بدون إكمال هذه الخطوة الأمنية الأخيرة.

  1. من لوحة تحكم مدير ماجنتو، اذهب إلى المتاجر (Stores) > الإعدادات (Configuration) > الخدمات (Services) > OAuth.

  2. ابحث عن الإعداد المسمى "السماح باستخدام رموز وصول OAuth كرموز حامل مستقلة (Allow OAuth Access Tokens to be used as standalone Bearer tokens)" وقم بتغيير الخيار إلى نعم (Yes).

  3. اضغط على حفظ الإعدادات (Save Config) ثم قم بـ تفريغ ذاكرة التخزين المؤقت (Flush Cache) للمرة الأخيرة لتحديث النظام بالكامل.

🛠️ دليل استكشاف الأخطاء وإصلاحها

إذا واجهتك أي مشكلة في المزامنة أو التهيئة، يرجى الاستعانة بالجدول أدناه لتطبيق الحلول السريعة:

المشكلة

الحل السريع وطريقة الإصلاح

أخطاء الصلاحيات (Permission Errors)

قم بتشغيل أمر تعديل ملكية الملفات التالي في طرفية الخادم لتصحيح صلاحيات المجلد:

chown -R www-data:www-data app/code/BusinessChat/

(ملاحظة: استبدل www-data بالمستخدم المخصص لتشغيل الويب في خادمك إذا كان مختلفاً).

أخطاء الذاكرة (Memory Errors)

في حال واجهت مشكلة انتهاء الذاكرة أثناء التجميع، أضف رمز تحديد سعة الذاكرة يدويًا للأمر كالتالي:

php -d memory_limit=2G bin/magento setup:di:compile

الأحداث لا تتزامن (Events Not Syncing)

يرجى إعادة التحقق من تطبيق الخطوة 5 (رموز الحامل - Bearer Tokens) بدقة، حيث يعد عدم تفعيلها السبب الأول والأكثر شيوعاً لعدم إرسال الأحداث وتوقف المزامنة.

الحالة تظهر كـ "غير نشط" (Inactive)

انتقل إلى لوحة تحكم ماجنتو ثم إلى النظام (System) > عمليات الربط (Integrations)، وابحث عن ربط بيزنس شات، ثم اضغط على إعادة تفويض (Reauthorize).

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