Chatbot Magento: un agente AI per Magento 2 e Adobe Commerce
Orygo AI si collega a Magento 2 e Adobe Commerce con un token di integrazione e trasforma la chat del negozio in un agente AI che conosce catalogo, ordini e clienti. Cerca i prodotti per nome, apre la scheda partendo dallo slug, dall’URL completo o dallo SKU, e aggiunge l’articolo al carrello Magento dalla chat. Dopo l’acquisto legge l’ordine dall’increment ID, solo se l’email del cliente combacia, e risponde su stato, totali e tracking. Un modulo Magento collega ogni ordine pagato alla conversazione che lo ha preceduto. Lo configura un AI engineer dedicato: online in 2-3 giorni lavorativi.
4
azioni sul negozio: ricerca, scheda prodotto, ordine, profilo cliente
3
modi di aprire un prodotto: slug, URL completo o SKU
10
righe d’ordine lette per ogni ordine, con nome, SKU, quantità e prezzo
1
token di integrazione, creato da System › Extensions › Integrations
Di Davide Petruzzi, founder di Orygo AI · Aggiornato il
Cosa fa il chatbot AI di Orygo su Magento?
Su Magento Orygo AI usa un solo agente per vendere e per assistere: prima dell’acquisto cerca nel catalogo, apre le schede con prezzi e attributi e aggiunge al carrello dalla chat; dopo l’acquisto legge ordini e profili dei clienti. I dati arrivano dall’API REST di Magento nel momento della domanda.
Prima dell’acquisto
Il cliente descrive cosa cerca e l’agente interroga il catalogo per nome prodotto. Riceve nomi, descrizioni brevi, prezzi, immagini, SKU e disponibilità, e mostra i prodotti in chat come schede. Per i dettagli apre la scheda completa: descrizione, prezzi, immagini e attributi personalizzati, cioè i campi che il tuo catalogo usa per materiali, misure, compatibilità o certificazioni. Il cliente aggiunge al carrello Magento senza lasciare la chat. Il modo in cui l’agente propone e confronta i prodotti è nella pagina della chat AI sul sito.
Dopo l’acquisto
Per un ordine l’agente chiede email e numero d’ordine, cioè l’increment ID che Magento mostra al cliente (100000123, con o senza #). Se l’email combacia, risponde con stato, totali, sconti, tracking e articoli. Con il profilo cliente vede gli ordini recenti, le spedizioni e il totale speso, utile per chi chiede “cosa avevo preso l’ultima volta?”. Il percorso completo è nella pagina sul tracking ordini con l’AI.
| Il cliente chiede | Cosa fa l’agente | Dati letti da Magento |
|---|---|---|
| “Cerco un divano a tre posti sfoderabile” | Cerca nel catalogo e mostra le schede in chat | Nome, descrizione breve, prezzo, immagini, SKU, disponibilità |
| “Il codice MB-2040 è compatibile con il mio modello?” | Apre la scheda dallo SKU e legge gli attributi | Descrizione, prezzi, immagini, attributi personalizzati |
| “Aggiungilo al carrello” | Aggiunge il prodotto al carrello Magento dalla chat | Carrello del negozio |
| “Dov’è l’ordine #100000123?” | Verifica l’email e legge l’ordine | Stato, totali, tracking, righe d’ordine |
| “Quanti ordini ho fatto quest’anno?” | Legge il profilo del cliente | Numero di ordini, totale speso, ordini recenti |
Come si collega Orygo AI a Magento 2?
Orygo AI si collega a Magento 2 con l’URL base del negozio in https e un access token di integrazione, creato nell’admin in System › Extensions › Integrations (Sistema › Estensioni › Integrazioni nell’admin in italiano). Per il carrello in chat e la misura delle vendite si installa il modulo Magento di Orygo AI. La configurazione la segue un AI engineer dedicato, e si va online in 2-3 giorni lavorativi.
[01]
Crea l’integrazioneNell’admin apri System › Extensions › Integrations e scegli Add New Integration. Dai un nome riconoscibile, per esempio “Orygo AI”, e conferma con la password del tuo utente admin.[02]
Limita le risorseNella scheda API imposta Resource Access su Custom e seleziona solo ciò che serve all’agente: catalogo, ordini e clienti. Le azioni di Orygo AI su Magento leggono e basta.[03]
Attiva e copia l’access tokenSalva, premi Activate e poi Allow: Magento mostra le credenziali dell’integrazione. A Orygo AI serve l’access token.[04]
Inserisci URL base e token in Orygo AIL’URL va scritto con https. Le credenziali appartengono a un singolo agente: ogni agente ha le sue.[05]
Accendi le azioni una per unaRicerca prodotti, scheda prodotto, ordine e profilo cliente si attivano separatamente.[06]
Installa il modulo Magento di Orygo AIPer segnare il carrello quando il cliente chatta e riportare a Orygo gli ordini pagati.[07]
Prova prima del lancioNel playground, con le domande vere dei tuoi clienti e i codici prodotto del tuo catalogo.
Una nota su Magento 2.4.4 e versioni successive
Da Magento 2.4.4 l’access token di un’integrazione non vale più da solo come token Bearer: Adobe lo ha disattivato di default per ragioni di sicurezza, e lo si riabilita in Stores › Configuration › Services › OAuth › Consumer Settings, opzione “Allow OAuth Access Tokens to be used as standalone Bearer tokens”. Il dettaglio è nella documentazione di Adobe Commerce sull’autenticazione a token. In configurazione verifichiamo con te questa impostazione prima di collegare l’agente.
Il widget di chat si aggiunge al tema con uno snippet. Tutti i passaggi, dalla prima chiamata al lancio: come si va live.
Quali dati legge Orygo AI da Magento e quali azioni esegue?
Orygo AI ha quattro azioni su Magento, tutte in sola lettura: cerca prodotti, apre una scheda prodotto, legge un ordine e legge il profilo di un cliente. Nessuna modifica prodotti, ordini o clienti. Nella chat del sito si aggiungono le schede prodotto, l’aggiunta al carrello e l’attribuzione degli ordini pagati.
| Azione | Cosa serve all’agente | Cosa restituisce | Tipo |
|---|---|---|---|
| Cerca prodotti | Le parole del cliente, confrontate con i nomi dei prodotti | Nomi, descrizioni brevi, prezzi, immagini, SKU, disponibilità. Fino a 10 risultati di default, configurabile da 1 a 20 | Lettura |
| Scheda prodotto | Lo slug dell’URL (negozio.it/uomo/camicia-lino.html diventa camicia-lino), l’URL completo o, in mancanza, lo SKU | Descrizione, prezzi, immagini con URL già risolti, attributi personalizzati | Lettura |
| Leggi ordine | Email del cliente più increment ID (100000123 o #100000123) | Numero, stato e state, stato del pagamento, date, subtotale, totale, tasse, sconto, valuta, data di annullamento, indirizzo parziale (città, regione, paese), tracking (numero, codice e nome del corriere), fino a 10 righe (nome, SKU, quantità, prezzo) | Lettura |
| Profilo cliente | Email del cliente | Nome, telefono, indirizzi, numero di ordini, totale speso, data di registrazione, ordini recenti con articoli, spedizione e tracking | Lettura |
Perché l’agente chiede sempre l’email
Un ordine Magento si apre solo se l’email scritta dal cliente è quella dell’ordine. Se non combacia, l’agente riceve “ordine non trovato”: un increment ID, che è un numero progressivo facile da indovinare, da solo non basta a leggere l’ordine di un altro. L’indirizzo arriva in forma parziale, solo città, regione e paese. Le altre protezioni sono nella pagina sicurezza.
Stato e state: cosa dice l’agente al cliente
Magento distingue lo state dell’ordine, la fase interna (nuovo, in lavorazione, completato, annullato), dallo status, l’etichetta che il negozio può personalizzare. Orygo AI li legge entrambi, insieme al tracking con il codice del corriere, e nella procedura decidi tu come tradurli per il cliente, per esempio “in lavorazione” diventa “stiamo preparando il pacco”.
Nella chat del sito e nell’helpdesk
Schede e carrello
I prodotti compaiono in chat come schede, e il cliente li aggiunge al carrello Magento sul dominio del negozio.
Ordini attribuiti
Il modulo Magento segna il carrello e riporta gli ordini pagati: ogni ordine resta collegato alla conversazione e al ramo del test A/B. Il meccanismo è nel funnel della chat AI.
Profilo accanto alla chat
Nell’helpdesk di Orygo AI il profilo Magento del cliente si fissa accanto alla conversazione, con la tabella degli ordini recenti.
Orygo AI regge cataloghi grandi, più store e clienti B2B su Magento?
Su cataloghi grandi Orygo AI lavora per ricerca: interroga Magento a ogni domanda e riceve al massimo 20 prodotti, quindi la dimensione del catalogo non pesa sulla conversazione. Per i codici esatti apre la scheda dallo SKU. Le credenziali sono per agente e ogni agente si collega a un URL base. Listini per gruppo di clienti, cataloghi condivisi e preventivi delle funzioni B2B di Adobe Commerce non fanno parte dei dati che l’integrazione legge.
| Situazione | Come la gestisce Orygo AI |
|---|---|
| Decine di migliaia di prodotti | Ricerca per nome a ogni domanda, da 1 a 20 risultati (10 di default); la scheda completa si apre solo per il prodotto scelto |
| Clienti che conoscono il codice | Scheda aperta direttamente dallo SKU, anche senza URL |
| Specifiche tecniche negli attributi | Attributi personalizzati letti con la scheda e usati nella risposta |
| Ordini con molte righe | L’agente legge fino a 10 righe per ordine; per gli ordini più lunghi la procedura può passare il caso al team |
| Più siti o mercati | Un agente per URL base, ciascuno con le sue credenziali, le sue procedure e il suo tono di voce |
| Prezzi riservati a un cliente B2B | Non letti dall’integrazione: l’agente risponde con i prezzi di catalogo o passa la richiesta al commerciale |
Le regole su chi passa a chi si scrivono nella procedura. Un esempio per un negozio di ricambi; nomi delle azioni e regole sono di esempio.
Ricambi e ordini
- 1Se il cliente scrive un codice prodotto, apri la scheda con @Scheda prodotto usando lo SKU e conferma nome, prezzo e disponibilità.
- 2Se il cliente descrive il pezzo senza codice, chiedi marca e modello, poi usa @Cerca prodotti e proponi al massimo tre risultati.
- 3Se il cliente è un’azienda e chiede un prezzo riservato o un preventivo, raccogli ragione sociale ed email e passa la richiesta al team commerciale.
- 4Per un ordine chiedi email e numero d’ordine, poi usa @Leggi ordine. Se l’ordine è annullato, spiega il motivo solo se il team lo ha indicato nell’ordine, altrimenti passa il caso a una persona.
Come si scrivono le procedure: procedure in linguaggio naturale. Come avviene il passaggio a una persona: passaggio dal chatbot all’operatore.
Meglio un’estensione chatbot per Magento 2 o un agente AI collegato via API?
Le estensioni chatbot per Magento 2 si installano nel negozio e girano sul tuo server. Orygo AI lavora da fuori, con l’API REST e un token che puoi revocare in qualsiasi momento: in Magento entra solo un modulo leggero per carrello e attribuzione. La differenza si sente soprattutto ai canali e alle analisi.
| Estensione chatbot in Magento | Orygo AI | |
|---|---|---|
| Dove gira | Sul server del negozio | Sulla piattaforma Orygo AI, che legge Magento via API REST |
| Cosa entra in Magento | L’estensione intera | Un’integrazione con permessi scelti da te e il modulo per carrello e attribuzione |
| Canali | Di solito la chat del sito | Chat del sito, email, WhatsApp, Instagram, Messenger, Amazon, ticket Zendesk e Freshdesk |
| Vendite generate | Dipende dall’estensione | Ordini pagati collegati alla conversazione, nelle vendite attribuite |
| Configurazione | A carico tuo o dell’agenzia | Un AI engineer dedicato, online in 2-3 giorni lavorativi |
Politiche di reso, tempi di spedizione e garanzie restano nella knowledge base dell’agente, accanto ai dati del negozio. Le altre piattaforme collegate sono nella pagina integrazioni, per esempio PrestaShop.
Quali risultati ottengono gli ecommerce italiani con Orygo AI?
Nei casi pubblicati, gli ordini passati dalla chat di Orygo AI valgono dal 6,4% al 12,2% del fatturato online, con uno scontrino medio via chat fino al 128% più alto della media del negozio. Questi casi non sono presentati come negozi Magento: li riportiamo perché le quattro azioni dell’agente sono le stesse su tutte e sei le piattaforme supportate.
| Brand | Quota del fatturato online via chat | Scontrino medio via chat | Periodo |
|---|---|---|---|
| Yeppon, elettronica | 12,2% (€60.306 su 361 ordini) | €167 contro €73 del negozio (+128%) | 21 settembre - 20 ottobre 2026 |
| Lakshmi, cosmesi | 9,6% (€2.343 su 22 ordini) | €107 contro €87 del sito (+23%) | 1-30 ottobre 2026 |
| Velasca, scarpe e abbigliamento | 6,4% (€23.785 su 68 ordini) | €350 | 15 ottobre - 3 novembre 2026 |
Fonte: dashboard Orygo AI dei tre brand, canale chat sul sito, periodi indicati in tabella.
Domande frequenti su Orygo AI e Magento
Serve un’estensione Magento per usare Orygo AI?
Per leggere catalogo, ordini e clienti no: basta un’integrazione creata nell’admin, con il suo access token. Il modulo Magento di Orygo AI serve per la vendita nella chat del sito: segna il carrello quando il cliente chatta e riporta gli ordini pagati, così vedi quali vendite nascono dalle conversazioni.
Orygo AI funziona con Adobe Commerce Cloud?
Orygo AI legge il negozio con l’API REST e un token di integrazione, gli stessi strumenti presenti in Magento Open Source e in Adobe Commerce. Su Adobe Commerce su infrastruttura cloud il modulo per carrello e attribuzione segue il processo di deploy del tuo progetto, e lo pianifichiamo insieme in configurazione.
Il cliente deve scrivere il numero d’ordine con il cancelletto?
No. Orygo AI accetta l’increment ID con o senza #, per esempio 100000123 o #100000123. Serve anche l’email dell’acquisto, che deve combaciare con quella dell’ordine: senza, l’ordine non si apre.
Orygo AI trova un prodotto partendo dallo SKU?
Sì. L’agente apre la scheda prodotto preferibilmente dallo slug dell’URL, accetta anche l’URL completo e, quando l’URL non c’è, usa lo SKU. È il caso tipico di chi compra ricambi o riordina un codice che conosce già.
Il token di integrazione dà a Orygo AI accesso in scrittura a Magento?
Dipende dalle risorse che selezioni nell’integrazione. Le azioni di Orygo AI su Magento sono tutte in lettura, quindi basta dare accesso a catalogo, ordini e clienti. L’integrazione si può disattivare o eliminare in qualsiasi momento da System › Extensions › Integrations.
Le risposte sugli ordini Magento funzionano anche su WhatsApp e nei ticket?
Sì. Le azioni su Magento sono disponibili in ogni conversazione dell’agente: chat del sito, email, WhatsApp, Instagram, Messenger e ticket di Zendesk o Freshdesk. Schede prodotto e aggiunta al carrello sono invece della chat sul sito.
Collega Orygo AI a Shopify: ricerca nel catalogo, carrello in chat, ordini e recupero carrelli su WhatsApp gestiti dall’agente AI. Live in 2-3 giorni.
Scopri shopifyOrygo AI si collega a WooCommerce con le chiavi REST API e un plugin: risposte sui prodotti, carrello in chat e stato degli ordini. Scopri l’integrazione.
Scopri WooCommerceIntegra Orygo AI con PrestaShop: l’agente AI consiglia prodotti, aggiunge al carrello e risponde su ordini e spedizioni. Live in 2-3 giorni. Prenota una demo.
Scopri PrestaShopCollega Orygo AI a BigCommerce: l’agente AI cerca nel catalogo, legge ordini e clienti e aggiunge al carrello in chat. Live in 2-3 giorni. Prenota una demo.
Scopri BigCommerceOrygo AI si integra con Salesforce Commerce Cloud: un agente AI per brand enterprise che legge catalogo, ordini e clienti, in sola lettura. Scopri come.
Scopri Salesforce Commerce CloudVuoi vedere Orygo AI sul tuo negozio Magento?
Prenota una demo: colleghiamo l’agente al tuo Magento 2 o Adobe Commerce con un token di integrazione, lo vedi cercare per nome e per SKU, aggiungere al carrello e leggere un ordine vero, e insieme scriviamo la prima procedura con le tue regole.