Ghid de integrare cu Magento
Tajo se conectează la Adobe Commerce (Magento 2) prin API-ul REST Commerce. Nu există nicio extensie Tajo de instalat în codul magazinului tău Magento: conexiunea folosește un token de integrare, așa că pipeline-ul de deployment al magazinului rămâne neatins.
Magento este deocamdată o conexiune construită la inițiere: spre deosebire de Shopify și WooCommerce, nu este încă self-service, iar echipa Tajo configurează sincronizarea ca parte din procesul de inițiere. Statusul de implementare al conectorului arată unde se află lucrurile. Pregătirea din partea magazinului, descrisă mai jos, este tot ce îi trebuie Magento de la tine și funcționează cu un Magento standard, fără modificări de cod.
Cerințe preliminare
- Adobe Commerce / Magento Open Source 2.4+
- Acces de administrator pentru a crea un token de integrare
- HTTPS pe magazinul tău (obligatoriu pentru autentificarea cu token)
- Cont Tajo cu un abonament activ
Pasul 1: creează un token de integrare în Magento
- În panoul de administrare Magento, mergi la System → Extensions → Integrations → Add New Integration.
- Numește-l
Tajo, introdu parola de administrator și, la API, acordă acces de citire la resursele Customers, Sales și Catalog. - Salvează, apoi activează integrarea și copiază Access Token.
Tajo se autentifică cu Authorization: Bearer <access token> la URL-ul de bază REST al magazinului tău (https://yourstore.com/rest/V1/).
Pasul 2: predă conexiunea echipei Tajo
Trimite persoanei tale de contact din echipa Tajo:
| Câmp | Valoare |
|---|---|
| URL-ul magazinului | https://yourstore.com |
| Access token | Tokenul de integrare de la Pasul 1 |
Conexiunea este validată cu o cerere doar de citire înainte să înceapă orice sincronizare. Poți roti tokenul în Magento oricând ca să revoci accesul.
Ce sincronizează o conexiune Magento
- Clienți: câmpuri de identitate și metadate de cont pentru rezolvarea contactelor; consimțământul de marketing nu este niciodată dedus din simpla existență a unui cont
- Comenzi: istoricul de cumpărături, totalurile, moneda, statusul și liniile de comandă pentru segmentare pe ciclu de viață și automatizări de recâștigare
- Produse și categorii: structura catalogului pentru segmentare pe interese și campanii construite în jurul produselor
Importul istoric rulează primul, apoi sincronizarea incrementală ține Tajo la zi interogând înregistrările modificate. Evenimentele din magazin în timp real (coșuri, comenzi în curs de finalizare) au nevoie de o extensie instalată în magazin, pe care Magento nu o primește astăzi. Automatizările bazate pe comenzi rămân pe deplin disponibile prin sincronizare.
Automatizare de marketing
Automatizările (e-mail, SMS, WhatsApp prin Brevo și alți furnizori) se configurează în Tajo pe baza datelor sincronizate, de exemplu mesaje de urmărire după cumpărare la comenzi noi, recâștigarea clienților inactivi și campanii pe interese de produs pornind de la istoricul categoriilor.
Depanare
| Simptom | Cauză și rezolvare |
|---|---|
| 401 de la magazin | Tokenul de integrare a fost regenerat sau integrarea a fost dezactivată. Reactiveaz-o și actualizează tokenul în Tajo |
| Clienții se sincronizează, dar comenzile nu | Permisiunile API ale integrării nu includ resursa Sales |
| Import inițial lent | Magazinele mari se importă pe pagini; persoana ta de contact din echipa Tajo îți poate spune oricând cum stă progresul |
Pașii următori
- Referința conectorului Magento: statusul implementării și note tehnice
- Sincronizarea clienților: cum mapezi clienții Magento în sistemul tău de evidență