Guida all’integrazione Magento
Tajo si collega ad Adobe Commerce (Magento 2) tramite la Commerce REST API. Non c’è nessuna estensione Tajo da installare nel codice del tuo Magento: la connessione usa un token di integrazione, quindi la pipeline di deploy del tuo negozio resta intatta.
Oggi Magento è una connessione predisposta in onboarding: a differenza di Shopify e WooCommerce non è ancora self-serve, ed è il tuo team Tajo a configurare la sincronizzazione durante l’onboarding. Lo stato di implementazione del connettore ne traccia l’avanzamento. La preparazione lato negozio descritta qui sotto è tutto ciò che Magento richiede da parte tua e funziona con un Magento standard, senza modifiche al codice.
Prerequisiti
- Adobe Commerce / Magento Open Source 2.4+
- Accesso amministratore per creare un token di integrazione
- HTTPS attivo sul tuo negozio (necessario per l’autenticazione con token)
- Account Tajo con un abbonamento attivo
Passaggio 1: crea un token di integrazione Magento
- Nell’amministrazione di Magento, vai su System → Extensions → Integrations → Add New Integration.
- Chiamalo
Tajo, inserisci la tua password di amministratore e, nella sezione API, concedi l’accesso in lettura alle risorse Customers, Sales e Catalog. - Salva, poi attiva l’integrazione e copia l’Access Token.
Tajo si autentica con Authorization: Bearer <access token> verso l’URL base REST del tuo negozio (https://yourstore.com/rest/V1/).
Passaggio 2: consegna la connessione al tuo team Tajo
Condividi con il tuo referente di onboarding Tajo:
| Campo | Valore |
|---|---|
| URL del negozio | https://yourstore.com |
| Access token | Il token di integrazione del passaggio 1 |
La connessione viene validata con una richiesta in sola lettura prima che inizi qualsiasi sincronizzazione. Puoi ruotare il token in Magento in qualsiasi momento per revocare l’accesso.
Cosa sincronizza una connessione Magento
- Clienti: campi identificativi e metadati dell’account per la risoluzione dei contatti; il consenso al marketing non viene mai dedotto dall’esistenza di un account
- Ordini: cronologia degli acquisti, totali, valuta, stato e righe d’ordine per la segmentazione del ciclo di vita e le automazioni di win-back
- Prodotti e categorie: struttura del catalogo per la segmentazione per interessi e le campagne basate sui prodotti
Prima viene eseguita l’importazione storica, poi la sincronizzazione incrementale mantiene Tajo aggiornato interrogando i record modificati. Gli eventi di storefront in tempo reale (carrelli, checkout in corso) richiedono un’estensione installata nel negozio, che oggi Magento non ha; le automazioni basate sugli ordini restano invece pienamente supportate tramite la sincronizzazione.
Automazione del marketing
Le automazioni (email, SMS, WhatsApp tramite Brevo e altri provider) si configurano in Tajo usando i dati sincronizzati, per esempio follow-up post-acquisto sui nuovi ordini, win-back sui clienti inattivi e campagne di interesse sui prodotti a partire dalla cronologia delle categorie.
Risoluzione dei problemi
| Sintomo | Causa e soluzione |
|---|---|
| 401 dal negozio | Il token di integrazione è stato rigenerato oppure l’integrazione è stata disattivata: riattivala e aggiorna il token in Tajo |
| I clienti si sincronizzano ma gli ordini no | Ai permessi API dell’integrazione manca la risorsa Sales |
| Importazione iniziale lenta | I negozi di grandi dimensioni vengono importati a pagine; il tuo referente Tajo può comunicarti l’avanzamento in qualsiasi momento |
Passaggi successivi
- Riferimento del connettore Magento: stato di implementazione e note tecniche
- Sincronizzazione clienti: come mappare i clienti Magento nel tuo sistema di riferimento