Magento-Integrationsleitfaden
Tajo verbindet sich über die Commerce REST API mit Adobe Commerce (Magento 2). Es gibt keine Tajo-Extension, die du in deiner Magento-Codebasis installieren musst. Die Verbindung nutzt ein Integrations-Token und lässt die Deploy-Pipeline deines Stores unberührt.
Magento ist derzeit eine im Onboarding eingerichtete Verbindung: Anders als Shopify und WooCommerce ist es noch nicht Self-Service, dein Tajo-Team richtet den Sync im Rahmen des Onboardings ein. Der Implementierungsstatus des Connectors zeigt, wo die Arbeit gerade steht. Die Vorbereitung im Store weiter unten ist alles, was Magento von deiner Seite braucht, und sie funktioniert mit einem Standard-Magento, ganz ohne Code-Änderungen.
Voraussetzungen
- Adobe Commerce / Magento Open Source 2.4+
- Admin-Zugang, um ein Integrations-Token zu erstellen
- HTTPS in deinem Store (für die Token-Authentifizierung erforderlich)
- Tajo-Konto mit aktivem Abo
Schritt 1: Magento-Integrations-Token erstellen
- Gehe im Magento-Admin zu System → Extensions → Integrations → Add New Integration.
- Nenne sie
Tajo, gib dein Admin-Passwort ein und erteile unter API Lesezugriff auf die Ressourcen Customers, Sales und Catalog. - Speichere, aktiviere die Integration anschließend mit Activate und kopiere das Access Token.
Tajo authentifiziert sich mit Authorization: Bearer <access token> gegen die REST-Basis-URL deines Stores (https://yourstore.com/rest/V1/).
Schritt 2: Die Verbindung an dein Tajo-Team übergeben
Teile deiner Ansprechperson im Tajo-Onboarding mit:
| Feld | Wert |
|---|---|
| Store-URL | https://yourstore.com |
| Access Token | Das Integrations-Token aus Schritt 1 |
Die Verbindung wird vor jedem Sync mit einer reinen Leseanfrage geprüft. Du kannst das Token in Magento jederzeit erneuern und den Zugriff so entziehen.
Was eine Magento-Verbindung synchronisiert
- Kund:innen: Identitätsfelder und Konto-Metadaten für die Kontaktauflösung; ein Marketing-Einverständnis wird nie daraus abgeleitet, dass ein Konto existiert
- Bestellungen: Kaufhistorie, Summen, Währung, Status und Positionen für Lifecycle-Segmentierung und Rückgewinnungs-Automationen
- Produkte und Kategorien: Katalogstruktur für Interessens-Segmentierung und produktbezogene Kampagnen
Zuerst läuft der historische Import, danach hält ein inkrementeller Sync Tajo aktuell, indem er geänderte Datensätze abfragt. Echtzeit-Events in der Storefront (Warenkörbe, laufende Checkouts) brauchen eine Extension im Store, die es für Magento heute nicht gibt. Bestellbasierte Automationen bleiben über den Sync vollständig unterstützt.
Marketing-Automatisierung
Automationen (E-Mail, SMS, WhatsApp über Brevo und andere Anbieter) richtest du in Tajo auf Basis der synchronisierten Daten ein, zum Beispiel Nachfass-Nachrichten nach dem Kauf bei neuen Bestellungen, Rückgewinnung inaktiver Kund:innen und Kampagnen nach Produktinteresse aus der Kategorie-Historie.
Fehlerbehebung
| Symptom | Ursache und Lösung |
|---|---|
| 401 vom Store | Das Integrations-Token wurde neu erzeugt oder die Integration deaktiviert, aktiviere sie erneut und aktualisiere das Token in Tajo |
| Kund:innen werden synchronisiert, Bestellungen nicht | Den API-Berechtigungen der Integration fehlt die Ressource Sales |
| Langsamer erster Import | Große Stores werden seitenweise importiert; deine Ansprechperson bei Tajo kann dir den Fortschritt jederzeit nennen |
Nächste Schritte
- Magento-Connector-Referenz: Implementierungsstatus und technische Hinweise
- Kundensynchronisation: Magento-Kund:innen in dein System of Record übernehmen