Przewodnik po integracji z Magento
Tajo łączy się z Adobe Commerce (Magento 2) przez Commerce REST API. Nie musisz instalować żadnego rozszerzenia Tajo w swoim kodzie Magento: połączenie korzysta z tokenu integracji, więc pipeline wdrożeniowy Twojego sklepu pozostaje nietknięty.
Magento jest dziś połączeniem budowanym podczas onboardingu: w przeciwieństwie do Shopify i WooCommerce nie działa jeszcze w trybie samoobsługowym, a synchronizację podłącza Twój zespół Tajo w ramach wdrożenia. Status implementacji konektora pokazuje, na jakim etapie jest ta praca. Przygotowanie po stronie sklepu opisane poniżej to wszystko, czego Magento potrzebuje od Ciebie, i działa na standardowej instalacji Magento, bez zmian w kodzie.
Wymagania wstępne
- Adobe Commerce / Magento Open Source 2.4+
- Dostęp administratora, aby utworzyć token integracji
- HTTPS w Twoim sklepie (wymagany przy uwierzytelnianiu tokenem)
- Konto Tajo z aktywną subskrypcją
Krok 1: utwórz token integracji w Magento
- W panelu administracyjnym Magento przejdź do System → Extensions → Integrations → Add New Integration.
- Nadaj integracji nazwę
Tajo, podaj swoje hasło administratora, a w sekcji API przyznaj prawo odczytu zasobów Customers, Sales oraz Catalog. - Zapisz, następnie wybierz Activate dla integracji i skopiuj Access Token.
Tajo uwierzytelnia się nagłówkiem Authorization: Bearer <access token> wobec bazowego adresu REST Twojego sklepu (https://yourstore.com/rest/V1/).
Krok 2: przekaż połączenie swojemu zespołowi Tajo
Przekaż swojej osobie kontaktowej ds. wdrożenia w Tajo:
| Pole | Wartość |
|---|---|
| Adres sklepu | https://yourstore.com |
| Access token | Token integracji z kroku 1 |
Połączenie jest weryfikowane zapytaniem tylko do odczytu, zanim ruszy jakakolwiek synchronizacja. Token możesz w każdej chwili zmienić w Magento, aby odebrać dostęp.
Co synchronizuje połączenie z Magento
- Klienci: pola tożsamości i metadane konta na potrzeby rozpoznawania kontaktów; zgoda marketingowa nigdy nie jest wnioskowana z samego istnienia konta
- Zamówienia: historia zakupów, kwoty, waluta, status i pozycje zamówienia na potrzeby segmentacji cyklu życia i automatyzacji win-back
- Produkty i kategorie: struktura katalogu na potrzeby segmentacji według zainteresowań i kampanii uwzględniających produkty
Najpierw uruchamia się import historyczny, potem synchronizacja przyrostowa utrzymuje Tajo w aktualnym stanie, odpytując o zmienione rekordy. Zdarzenia sklepowe w czasie rzeczywistym (koszyki, trwający checkout) wymagają rozszerzenia zainstalowanego w sklepie, którego Magento dziś nie otrzymuje. Automatyzacje oparte na zamówieniach nadal są w pełni obsługiwane przez synchronizację.
Automatyzacja marketingu
Automatyzacje (email, SMS, WhatsApp przez Brevo i innych dostawców) konfigurujesz w Tajo na zsynchronizowanych danych, na przykład kontakt po zakupie przy nowych zamówieniach, win-back dla klientów, którzy przestali kupować, oraz kampanie oparte na zainteresowaniach wynikających z historii kategorii.
Rozwiązywanie problemów
| Objaw | Przyczyna i rozwiązanie |
|---|---|
| 401 ze sklepu | Token integracji został wygenerowany ponownie albo integracja została wyłączona. Włącz ją ponownie i zaktualizuj token w Tajo |
| Klienci się synchronizują, a zamówienia nie | Uprawnieniom API integracji brakuje zasobu Sales |
| Wolny import początkowy | Duże sklepy importują się stronami; Twoja osoba kontaktowa w Tajo może w każdej chwili podać postęp |
Kolejne kroki
- Dokumentacja konektora Magento: status implementacji i uwagi techniczne
- Synchronizacja klientów: mapowanie klientów Magento do Twojego systemu źródła prawdy