Connettore Magento
Funziona con Magento
Collega Magento 2 o Adobe Commerce a FreeScout così le conversazioni mostrano gli ordini dei clienti abbinati e il contesto di acquisto. Un piccolo modulo Magento di sola lettura espone un riepilogo di supporto tramite l'API REST di Magento, e il connettore FreeScout lo mostra nella barra laterale della conversazione. ReplyRabbit alimenta anche il contesto di proprietà del prodotto nel livello AI così le bozze possono fare riferimento a ciò che un cliente ha acquistato.
Cerchi la panoramica?
Panoramica
Il connettore Magento aggiunge una barra laterale dell'ordine alle conversazioni FreeScout. Quando una conversazione ha un indirizzo email del cliente, il connettore chiama il moo-support/summary endpoint sul tuo negozio Magento per abbinare gli ordini e li mostra accanto alla conversazione.
La barra laterale mostra un pannello cliente, la cronologia completa degli ordini, le righe d'ordine per ogni ordine con quantità e prezzi, i totali finanziari, il valore del ciclo di vita del cliente (CLV), il valore medio dell'ordine (AOV) e il diritto di proprietà del prodotto che confluisce nel contesto AI di ReplyRabbit per bozze più pertinenti.
Ci sono due componenti da installare:
- Il Modulo connettore ReplyRabbit per Magento 2. Aggiunge due endpoint REST di sola lettura (
/rest/V1/moo-support/summarye/rest/V1/moo-support/purchased-products) dietro un'autorizzazione amministrativa dedicata chiamata API del connettore ReplyRabbit. Non modifica la vetrina né il checkout. - Il Modulo connettore Magento per FreeScout. Chiama quegli endpoint tramite HTTPS usando un token di accesso all'integrazione Magento e visualizza la barra laterale dell'ordine. Ha la propria pagina di impostazioni per casella di posta in FreeScout.
La barra laterale degli ordini funziona da sola. L'entitlement di proprietà dei prodotti che confluisce nelle bozze AI è la parte che usa ReplyRabbit.
Prerequisiti
Prima di iniziare, assicurati di avere:
- Un'installazione FreeScout funzionante.
- Un negozio Magento 2.4 o successivo (Magento Open Source o Adobe Commerce) raggiungibile via HTTPS, con accesso SSH per eseguire i comandi CLI di Magento.
- Accesso amministratore Magento per creare un'Integrazione.
- ReplyRabbit installato e attivato se desideri il contesto di proprietà del prodotto nelle bozze AI.
- Una licenza Magento Connector (18 EUR una tantum, per un'installazione FreeScout), oppure un piano ReplyRabbit Pro o Team attivo, che la include.
Se ReplyRabbit non è ancora installato, inizia con Come installare il modulo ReplyRabbit, poi completa Come configurare ReplyRabbit.
Installa il modulo Magento
Scarica il modulo Magento
Accedi su app.replyrabbit.app e scarica lo ZIP del modulo Magento dalla scheda del connettore Magento.Scompattalo in app/code
Carica lo ZIP nella root di Magento e scompattalo. Creaapp/code/Moogento/SupportData.Abilita il modulo
Dalla radice di Magento, esegui:Su uno store in modalità produzione, esegui anchebashbin/magento module:enable Moogento_SupportData bin/magento setup:upgrade bin/magento setup:di:compile bin/magento cache:flushbin/magento setup:static-content:deploycome faresti per qualsiasi installazione di modulo.
Installazioni Composer
moogento/m2-supportdata dal repository dei pacchetti Moogento. L'installazione ZIP sopra non richiede credenziali Composer.Crea un token di integrazione Magento
Il connettore si autentica con un token di accesso da una Integrazione Magento. Creane una con ambito limitato al permesso di sola lettura del modulo.
Apri Integrazioni
Nell'admin di Magento, vai su Sistema, poi Estensioni, poi Integrazioni, e clicca Aggiungi nuova integrazione.Assegna un nome e imposta l'ambito API
Inserisci un nome come "ReplyRabbit Connector" e la tua password amministratore. Nella API scheda, imposta Accesso alle risorse a Personalizzato e spunta solo API del connettore ReplyRabbit (sotto l'albero amministrativo di primo livello). Salva.Attiva e copia il token di accesso
Clicca Attiva accanto alla nuova integrazione, poi Consenti. Copia il Token di accesso. Magento mostra il token nei dettagli dell'integrazione, così puoi tornarci in seguito.
Accesso in sola lettura
Installa il modulo connettore FreeScout
Il modulo connettore Magento per FreeScout chiama gli endpoint di Magento e mostra la barra laterale dell'ordine nelle conversazioni. È un modulo a sé con le proprie impostazioni, separato da ReplyRabbit.
Scarica il modulo connettore
Accedi su app.replyrabbit.app per scaricare lo ZIP del modulo connettore FreeScout. Entrambi i download appaiono una volta acquistato il connettore o se hai un piano ReplyRabbit Pro o Team attivo.Carica su FreeScout
In FreeScout, vai su Moduli, clicca il pulsante di caricamento, scegli il ZIP e installalo.Attiva il modulo
Attiva il Integrazione Magento modulo dall'elenco Moduli.
Configura per casella di posta
Dopo che il modulo è installato, collegalo al tuo negozio nella pagina delle impostazioni per casella di posta del connettore.
Apri le impostazioni del connettore
In FreeScout, apri la casella che deve mostrare i dati degli ordini Magento, apri il menu delle impostazioni della casella e scegli Connettore del negozio. Questa è la pagina delle impostazioni del connettore Magento, non una sezione all'interno delle impostazioni di ReplyRabbit.Inserisci l'URL di base di Magento
Incolla l'URL di base del tuo negozio Magento su HTTPS, ad esempiohttps://your-store.com. Non è necessaria una barra finale.Inserisci il token di accesso
Incolla la Token di accesso dall'integrazione Magento. È memorizzata crittografata, e dopo il salvataggio viene mostrata solo un'anteprima mascherata.Imposta l'ID del negozio (opzionale)
Lascia vuoto per abbinare gli ordini in tutti i negozi. Inserisci un ID negozio Magento per limitare la barra laterale a un negozio o a una vista negozio.Aggiungi la chiave di licenza del tuo connettore
Se hai acquistato il connettore, inserisci la sua chiave di licenza. Salta questo passaggio se un piano ReplyRabbit Pro o Team attivo copre l'installazione.Salva e verifica
Salva le impostazioni. Apri una conversazione FreeScout in cui l'email del cliente corrisponde a un ordine Magento e conferma che appare la barra laterale dell'ordine.
Ogni casella di posta FreeScout memorizza il proprio URL di base, token di accesso e ID negozio, così puoi connettere caselle di posta diverse a negozi o viste negozio Magento diversi.
Cosa mostra il connettore
- Un pannello cliente per la persona nella conversazione.
- Cronologia completa degli ordini con numero d'ordine, data, stato e totale.
- Righe per ordine con quantità e prezzi.
- Totali finanziari (subtotale, sconto, spedizione, imposte, rimborsi).
- Valore del ciclo di vita del cliente (CLV) e valore medio dell'ordine (AOV).
- Diritto di utilizzo del prodotto per le bozze AI.
Come ottenere il connettore
Il Connettore Magento è un modulo a pagamento. Puoi ottenerlo in due modi:
- Acquista il Magento Connector per 18 EUR come licenza una tantum per un'installazione FreeScout, poi incolla la sua chiave di licenza nelle impostazioni del connettore.
- Usa un piano ReplyRabbit Pro o Team attivo, che include il connettore senza costi aggiuntivi.
Acquista la licenza o scarica il connettore dal tuo Dashboard di ReplyRabbit. Visita la pagina dei prezzi per le opzioni del piano ReplyRabbit. Se un piano ReplyRabbit Pro o Team attivo copre l'installazione, il connettore funziona una volta configurato, senza bisogno di una chiave di licenza separata.
Risoluzione dei problemi
| Sintomo | Cosa controllare |
|---|---|
| La barra laterale ordine non appare | Conferma che l'URL di base e il token di accesso nelle impostazioni del connettore siano corretti e che il pannello della casella di posta sia abilitato. |
| HTTP 404 dal negozio | Il modulo Connettore ReplyRabbit non è installato o abilitato. Esegui di nuovo bin/magento module:enable Moogento_SupportData e bin/magento setup:upgrade, poi svuota la cache. |
| HTTP 401 o 403 dal negozio | L'integrazione non è attivata, il token è stato rigenerato, oppure all'integrazione manca il API del connettore ReplyRabbit risorsa. Riattiva l'integrazione e incolla il token corrente. |
| "Connessione rifiutata" o errore di timeout | Verifica che il server FreeScout possa raggiungere l'URL del tuo negozio tramite HTTPS. Firewall, allowlist di IP o la modalità di manutenzione potrebbero bloccare la richiesta. |
| L'URL di base viene rifiutato | Lo store deve essere servito tramite HTTPS. Un semplice http:// URL o un host irraggiungibile viene rifiutato. |
| Gli ordini sono vuoti per un cliente noto | Conferma che l'email del cliente nella conversazione FreeScout corrisponda all'email dei suoi ordini Magento e che l'ID del negozio (se impostato) corrisponda al negozio da cui ha ordinato. |
| Voci, dati finanziari o CLV non vengono mostrati | Conferma che la chiave di licenza del connettore sia salvata, oppure che un piano ReplyRabbit Pro o Team attivo copra l'installazione. |
| Il contesto di proprietà del prodotto non appare nelle bozze | Conferma che il connettore sia licenziato, che ReplyRabbit sia installato, che il connettore restituisca ordini e che la funzionalità di contesto AI sia abilitata per la casella di posta. |
Per problemi più ampi, vedi Risoluzione dei problemi di ReplyRabbit.
Privacy e gestione dei dati
Quando il connettore interroga Magento, invia l'indirizzo email del cliente al tuo negozio Magento tramite HTTPS. I dati degli ordini restituiti dal tuo negozio popolano la barra laterale di FreeScout e, con ReplyRabbit, costruiscono il contesto AI per le bozze.
Il token di integrazione necessita solo del permesso di sola lettura API del connettore ReplyRabbit risorsa, quindi il connettore non scrive mai nel tuo store. Il token è memorizzato cifrato in FreeScout, e le richieste in uscita verificano TLS e non seguono reindirizzamenti.
Nessun dato ordine Magento viene inviato a terzi se non tramite il provider AI selezionato per la casella di posta, e solo quando la funzionalità di contesto AI lo usa. Se la tua policy richiede che i dati degli ordini restino interamente sui tuoi server, usa un provider AI locale (come Ollama) per la casella di posta.
Prossimi passi
- Fine Come configurare ReplyRabbit se la casella richiede ancora impostazioni di provider, contesto o stile.
- Anche su WooCommerce? Vedi la Connettore WooCommerce guida.
FAQ
Serve un modulo Magento per il connettore?
Sì. Il connettore legge un endpoint support-summary che il modulo ReplyRabbit Connector aggiunge alla REST API di Magento 2. Ci sono due download, il modulo Magento e il modulo connettore Magento per FreeScout, entrambi disponibili dal tuo account ReplyRabbit.
Quali versioni di Magento sono supportate?
Magento 2.4 e successivi, inclusi Magento Open Source e Adobe Commerce, su PHP 8.0 fino a 8.4. Magento 1 non è supportato.
Quanto costa il connettore Magento?
Il Connettore Magento è incluso con un piano ReplyRabbit Pro o Team attivo. Altrimenti, costa 18 EUR come licenza una tantum per una installazione di FreeScout. Se lo acquisti, incolla la sua chiave di licenza nelle impostazioni del connettore.
Quale permesso richiede il token di accesso?
Solo la risorsa API ReplyRabbit Connector, che è di sola lettura. Il connettore non scrive mai nel tuo store, quindi l'integrazione non necessita di altre autorizzazioni admin.
Ogni casella di posta FreeScout può connettersi a un negozio Magento diverso?
Sì. Ogni casella memorizza il proprio URL di base, token di accesso e ID store opzionale nelle impostazioni del connettore, così store o viste store diversi possono collegarsi a caselle diverse.