Magento انٹیگریشن گائیڈ

Tajo، Adobe Commerce (Magento 2) سے Commerce REST API کے ذریعے کنیکٹ ہوتا ہے۔ آپ کے Magento کوڈ بیس میں انسٹال کرنے کے لیے کوئی Tajo ایکسٹینشن نہیں ہے۔ کنکشن ایک انٹیگریشن ٹوکن استعمال کرتا ہے، جس کی وجہ سے آپ کے اسٹور کی ڈیپلائے پائپ لائن کو ہاتھ نہیں لگانا پڑتا۔

Magento فی الحال آن بورڈنگ کے دوران بنایا جانے والا کنکشن ہے: Shopify اور WooCommerce کے برعکس یہ ابھی سیلف سروس نہیں ہے، اور آپ کی Tajo ٹیم آن بورڈنگ کے حصے کے طور پر سنک ترتیب دیتی ہے۔ کنیکٹر کے نفاذ کی صورتحال بتاتی ہے کہ کام کہاں تک پہنچا ہے۔ نیچے دی گئی اسٹور کی طرف کی تیاری وہ سب کچھ ہے جو Magento کو آپ سے درکار ہے، اور یہ اسٹاک Magento کے ساتھ چلتی ہے، کوڈ میں کوئی تبدیلی نہیں۔

پیشگی شرائط

• Adobe Commerce / Magento Open Source 2.4+
• انٹیگریشن ٹوکن بنانے کے لیے ایڈمن رسائی
• آپ کے اسٹور پر HTTPS (ٹوکن کی توثیق کے لیے لازمی)
• فعال سبسکرپشن کے ساتھ Tajo اکاؤنٹ

مرحلہ 1: Magento انٹیگریشن ٹوکن بنائیں

1. Magento ایڈمن میں System → Extensions → Integrations → Add New Integration پر جائیں۔
2. اس کا نام Tajo رکھیں، اپنا ایڈمن پاس ورڈ درج کریں، اور API کے تحت Customers، Sales اور Catalog ریسورسز پر پڑھنے کی رسائی دیں۔
3. محفوظ کریں، پھر انٹیگریشن کو Activate کریں اور Access Token کاپی کریں۔

Tajo آپ کے اسٹور کے REST بیس URL (https://yourstore.com/rest/V1/) کے ساتھ Authorization: Bearer <access token> کے ذریعے توثیق کرتا ہے۔

مرحلہ 2: کنکشن اپنی Tajo ٹیم کے حوالے کریں

اپنے Tajo آن بورڈنگ رابطے کے ساتھ یہ شیئر کریں:

فیلڈ	ویلیو
اسٹور URL	https://yourstore.com
ایکسیس ٹوکن	مرحلہ 1 سے حاصل کردہ انٹیگریشن ٹوکن

کوئی بھی سنک شروع ہونے سے پہلے کنکشن کی توثیق صرف پڑھنے والی درخواست سے کی جاتی ہے۔ رسائی منسوخ کرنے کے لیے آپ Magento میں ٹوکن کسی بھی وقت تبدیل کر سکتے ہیں۔

Magento کنکشن کیا سنک کرتا ہے

• گاہک: رابطے کی شناخت کے لیے شناختی فیلڈز اور اکاؤنٹ میٹا ڈیٹا؛ مارکیٹنگ کی رضامندی کبھی بھی اکاؤنٹ کے وجود سے اخذ نہیں کی جاتی
• آرڈرز: لائف سائیکل سیگمنٹیشن اور واپس لانے والی آٹومیشنز کے لیے خریداری کی تاریخ، کل رقوم، کرنسی، اسٹیٹس اور لائن آئٹمز
• پروڈکٹس اور کیٹیگریز: دلچسپی کی سیگمنٹیشن اور پروڈکٹ سے آگاہ مہمات کے لیے کیٹلاگ کا ڈھانچہ

پہلے تاریخی امپورٹ چلتا ہے، پھر انکریمنٹل سنک تبدیل شدہ ریکارڈز کو پول کرتے ہوئے Tajo کو تازہ رکھتا ہے۔ ریئل ٹائم اسٹور فرنٹ ایونٹس (کارٹس، جاری چیک آؤٹ) کے لیے اسٹور کے اندر ایک ایکسٹینشن درکار ہوتی ہے، جو Magento کو آج میسر نہیں۔ آرڈر پر مبنی آٹومیشنز سنک کے ذریعے پوری طرح معاون رہتی ہیں۔

مارکیٹنگ آٹومیشن

آٹومیشنز (Brevo اور دیگر فراہم کنندگان کے ذریعے ای میل، SMS، واٹس ایپ) سنک شدہ ڈیٹا کی مدد سے Tajo میں کنفیگر کی جاتی ہیں، مثلاً نئے آرڈرز پر خریداری کے بعد فالو اپ، غیر فعال گاہکوں کو واپس لانے کی مہم، اور کیٹیگری کی تاریخ سے پروڈکٹ کی دلچسپی والی مہمات۔

مسائل کا حل

علامت	وجہ اور حل
اسٹور سے 401	انٹیگریشن ٹوکن دوبارہ بنایا گیا یا انٹیگریشن غیر فعال کر دی گئی۔ انٹیگریشن دوبارہ فعال کریں اور Tajo میں ٹوکن اپ ڈیٹ کریں
گاہک سنک ہوتے ہیں مگر آرڈرز نہیں	انٹیگریشن کی API اجازتوں میں Sales ریسورس موجود نہیں
ابتدائی امپورٹ سست ہے	بڑے اسٹورز صفحہ بہ صفحہ امپورٹ ہوتے ہیں؛ آپ کا Tajo رابطہ کسی بھی وقت پیش رفت بتا سکتا ہے

اگلے اقدامات

• Magento کنیکٹر ریفرنس: نفاذ کی صورتحال اور تکنیکی نوٹس
• گاہک کی سنک: Magento گاہکوں کو آپ کے سسٹم آف ریکارڈ میں میپ کرنا