Průvodce integrací Magento
Tajo se připojuje k Adobe Commerce (Magento 2) přes Commerce REST API. Do kódu Vašeho obchodu na Magento se neinstaluje žádné rozšíření Tajo, protože připojení používá integrační token. Nasazovací proces Vašeho obchodu tak zůstává nedotčený.
Magento je aktuálně připojení sestavené při onboardingu: na rozdíl od Shopify a WooCommerce zatím není samoobslužné a synchronizaci zapojí Váš tým Tajo v rámci onboardingu. Stav implementace konektoru ukazuje, kde se práce nachází. Příprava na straně obchodu popsaná níže je vše, co Magento z Vaší strany potřebuje, a funguje se standardním Magento bez zásahů do kódu.
Předpoklady
- Adobe Commerce / Magento Open Source 2.4+
- Přístup správce pro vytvoření integračního tokenu
- HTTPS na Vašem obchodu (vyžadováno pro ověření tokenem)
- Účet Tajo s aktivním předplatným
Krok 1: Vytvořte integrační token v Magento
- V administraci Magento přejděte na System → Extensions → Integrations → Add New Integration.
- Pojmenujte ji
Tajo, zadejte heslo správce a v sekci API udělte přístup pro čtení ke zdrojům Customers, Sales a Catalog. - Uložte, poté integraci aktivujte a zkopírujte Access Token.
Tajo se ověřuje hlavičkou Authorization: Bearer <access token> proti základní REST URL Vašeho obchodu (https://yourstore.com/rest/V1/).
Krok 2: Předejte připojení svému týmu Tajo
Sdílejte se svým onboardingovým kontaktem v Tajo:
| Pole | Hodnota |
|---|---|
| URL obchodu | https://yourstore.com |
| Access token | Integrační token z kroku 1 |
Připojení se před zahájením jakékoli synchronizace ověří požadavkem pouze pro čtení. Token můžete v Magento kdykoli obnovit a přístup tím odvolat.
Co připojení Magento synchronizuje
- Zákazníky: identifikační pole a metadata účtu pro rozpoznání kontaktu; marketingový souhlas se nikdy neodvozuje z existence účtu
- Objednávky: historii nákupů, celkové částky, měnu, stav a položky objednávky pro segmentaci podle životního cyklu a automatizace pro získání zákazníka zpět
- Produkty a kategorie: strukturu katalogu pro segmentaci podle zájmů a kampaně zohledňující produkty
Nejprve proběhne import historie, poté udržuje Tajo aktuální přírůstková synchronizace, která načítá změněné záznamy. Události ve výloze v reálném čase (košíky, rozpracované objednávky) vyžadují rozšíření v obchodě, které Magento dnes nemá. Automatizace založené na objednávkách zůstávají přes synchronizaci plně podporované.
Marketingová automatizace
Automatizace (e-mail, SMS, WhatsApp přes Brevo a další poskytovatele) se nastavují v Tajo nad synchronizovanými daty, například jako navazující zprávy po nákupu u nových objednávek, oslovení neaktivních zákazníků a kampaně podle zájmu o produkty odvozené z historie kategorií.
Řešení potíží
| Příznak | Příčina a náprava |
|---|---|
| 401 z obchodu | Integrační token byl znovu vygenerován nebo byla integrace deaktivována, aktivujte ji znovu a aktualizujte token v Tajo |
| Zákazníci se synchronizují, ale objednávky ne | Oprávnění API dané integrace neobsahují zdroj Sales |
| Pomalý úvodní import | Velké obchody se importují po stránkách; Váš kontakt v Tajo Vám kdykoli sdělí, jak import postupuje |
Další kroky
- Reference konektoru Magento: stav implementace a technické poznámky
- Synchronizace zákazníků: mapování zákazníků z Magento do Vašeho systému záznamů