دليل التكامل مع Magento
يتصل Tajo بـ Adobe Commerce (Magento 2) عبر Commerce REST API. لا توجد إضافة من Tajo تُثبَّت في شفرة متجرك على Magento، فالاتصال يستخدم رمز تكامل (integration token) يُبقي خط نشر متجرك دون أي تغيير.
Magento اليوم اتصال يُبنى أثناء التهيئة: فهو، بخلاف Shopify وWooCommerce، ليس ذاتي الخدمة بعد، ويتولى فريق Tajo لديك توصيل المزامنة ضمن مرحلة التهيئة. وتتابع حالة تنفيذ الموصّل الوضع الحالي. والتحضير من جهة المتجر الموضّح أدناه هو كل ما يحتاجه Magento منك، وهو يعمل مع Magento القياسي دون أي تعديل على الشفرة.
المتطلبات المسبقة
- Adobe Commerce / Magento Open Source 2.4+
- صلاحية مسؤول لإنشاء رمز تكامل
- HTTPS على متجرك (مطلوب لمصادقة الرمز)
- حساب Tajo باشتراك فعّال
الخطوة 1: أنشئ رمز تكامل في Magento
- من لوحة تحكم Magento، انتقل إلى System ← Extensions ← Integrations ← Add New Integration.
- سمِّه
Tajo، وأدخل كلمة مرور المسؤول، ثم امنح ضمن API صلاحية القراءة على موارد Customers وSales وCatalog. - احفظ، ثم فعّل التكامل وانسخ Access Token.
يصادق Tajo باستخدام Authorization: Bearer <access token> مقابل عنوان REST الأساسي لمتجرك (https://yourstore.com/rest/V1/).
الخطوة 2: سلّم الاتصال إلى فريق Tajo
شارك مع مسؤول التهيئة لديك في Tajo:
| الحقل | القيمة |
|---|---|
| عنوان المتجر | https://yourstore.com |
| رمز الوصول | رمز التكامل من الخطوة 1 |
يُتحقق من الاتصال بطلب للقراءة فقط قبل بدء أي مزامنة. ويمكنك تدوير الرمز في Magento في أي وقت لإلغاء الوصول.
ما الذي يزامنه اتصال Magento
- العملاء: حقول الهوية وبيانات الحساب من أجل تحديد جهة الاتصال؛ ولا يُستنتج قبول التسويق أبدًا من مجرد وجود حساب
- الطلبات: سجل الشراء والإجماليات والعملة والحالة وبنود الطلب من أجل التقسيم حسب دورة الحياة وأتمتة الاستعادة
- المنتجات والفئات: بنية الكتالوج من أجل التقسيم حسب الاهتمام والحملات المدركة للمنتجات
يُنفَّذ الاستيراد التاريخي أولًا، ثم تُبقي المزامنة التزايدية Tajo محدثًا عبر استطلاع السجلات المعدّلة. أما أحداث واجهة المتجر في الوقت الفعلي (السلات وعمليات الدفع الجارية) فتتطلب إضافة داخل المتجر، وهي غير متوفرة لـ Magento اليوم، لكن الأتمتة القائمة على الطلبات تبقى مدعومة بالكامل عبر المزامنة.
أتمتة التسويق
تُضبط عمليات الأتمتة (البريد الإلكتروني وSMS وواتساب عبر Brevo وغيره من مزودي التفاعل) داخل Tajo باستخدام البيانات المزامَنة، مثل رسائل المتابعة بعد الشراء على الطلبات الجديدة، واستعادة العملاء المتوقفين، وحملات الاهتمام بالمنتجات انطلاقًا من سجل الفئات.
استكشاف الأخطاء
| العَرَض | السبب والحل |
|---|---|
| خطأ 401 من المتجر | أُعيد توليد رمز التكامل أو أُلغي تفعيل التكامل، فأعد تفعيله وحدّث الرمز في Tajo |
| العملاء يُزامَنون لكن الطلبات لا | صلاحيات API الممنوحة للتكامل تفتقد مورد Sales |
| بطء الاستيراد الأولي | تُستورد المتاجر الكبيرة على صفحات، ويمكن لمسؤولك في Tajo إفادتك بالتقدم في أي لحظة |
الخطوات التالية
- مرجع موصّل Magento: حالة التنفيذ وملاحظات تقنية
- مزامنة العملاء: تعيين عملاء Magento داخل نظام السجل لديك