---
title: "Guida all’integrazione Magento | Tajo"
description: "Collega Adobe Commerce (Magento) a Tajo tramite la Commerce REST API per sincronizzare clienti, ordini e prodotti"
url: https://tajo.io/it/docs/ecommerce-platforms/magento/
markdown: https://tajo.io/it/docs/ecommerce-platforms/magento.md
lang: it-IT
author: "Set Noa"
author_url: https://tajo.io/it/set-noa/
robots: noindex
---

Richiedi l’accesso anticipato

Inserisci il tuo nome e indirizzo email aziendale. Ti invieremo un link per confermare la richiesta di accesso a Tajo.

# Guida all’integrazione Magento

[Set Noa](https://tajo.io/it/set-noa/)

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](https://tajo.io/docs/connectors/magento/) 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

1. Nell’amministrazione di Magento, vai su **System → Extensions → Integrations → Add New Integration**.
2. Chiamalo `Tajo`, inserisci la tua password di amministratore e, nella sezione **API**, concedi l’accesso in lettura alle risorse **Customers**, **Sales** e **Catalog**.
3. 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](https://tajo.io/docs/connectors/magento/): stato di implementazione e note tecniche
- [Sincronizzazione clienti](https://tajo.io/it/docs/skills/data-sync/customer-sync/): come mappare i clienti Magento nel tuo sistema di riferimento