Connettore Shopify
Funziona con Shopify
Collega Shopify a FreeScout così le conversazioni mostrano gli ordini dei clienti abbinati e il contesto di acquisto. Crea un'app personalizzata di sola lettura nel tuo admin Shopify e incolla il suo token di accesso in FreeScout, così non sono coinvolti account Partner né revisione dell'app. 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 Shopify aggiunge una barra laterale dell'ordine alle conversazioni FreeScout. Quando una conversazione ha un indirizzo email del cliente, il connettore interroga l'API GraphQL Admin di Shopify sul tuo negozio per gli ordini corrispondenti 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.
C'è un componente da installare: il Modulo connettore Shopify per FreeScout. Legge la Shopify GraphQL Admin API tramite HTTPS usando un token di accesso Admin API da un'app personalizzata, poi 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 Shopify su un
your-store.myshopify.comdominio (o un dominio personalizzato che mappa su uno), con permessi per lo staff per sviluppare app. - ReplyRabbit installato e attivato se desideri il contesto di proprietà del prodotto nelle bozze AI.
- Una licenza Shopify 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.
Crea un'app personalizzata in Shopify
Il connettore si autentica con un token di accesso Admin API da un'app personalizzata che risiede nel tuo negozio.
Apri Sviluppa app
Nell'admin di Shopify, vai su Impostazioni, poi App e canali di vendita, poi Sviluppa app. Se richiesto, consenti lo sviluppo di app personalizzate.Crea l'app
Clicca Crea un'app, chiamalo "ReplyRabbit Connector" e crealo.Imposta gli scope dell'Admin API
Apri Configura gli scope dell'Admin API e spuntaread_customers,read_orders, eread_products. Selezionaread_all_ordersanche se vuoi la cronologia ordini più vecchia di 60 giorni. Salva.Installa e copia il token
Clicca Installa app, poi Mostra il token una sola volta e copia la Token di accesso API admin (inizia conshpat_). Shopify lo mostra una sola volta, quindi conservalo in un luogo sicuro.
Accesso in sola lettura
Installa il modulo connettore FreeScout
Scarica il modulo connettore
Scarica il modulo connettore FreeScout in formato ZIP da Dashboard di ReplyRabbit. Il download appare 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 Shopify modulo dall'elenco Moduli.
Configura per casella di posta
Apri le impostazioni del connettore
In FreeScout, apri la casella che deve mostrare i dati degli ordini Shopify, apri il menu delle impostazioni della casella e scegli Connettore del negozio. Questa è la pagina delle impostazioni del connettore Shopify, non una sezione all'interno delle impostazioni di ReplyRabbit.Inserisci il dominio dello store e il token di accesso
Inserisci il dominio del tuo store, ad esempioyour-store.myshopify.com, e incolla il token di accesso Admin API. Salva. Il connettore verifica il token e gli ambiti rispetto al tuo negozio prima di memorizzarlo; il token viene memorizzato crittografato e non viene mai più mostrato.Aggiungi la chiave di licenza del tuo connettore
Se hai acquistato il connettore, impostaSHOPIFYINTEGRATION_LICENSE_KEYnel tuo FreeScout.envalla sua chiave di licenza. Salta questo passaggio se un piano ReplyRabbit Pro o Team attivo copre l'installazione.Test
Apri una conversazione FreeScout in cui l'email del cliente corrisponde a un ordine Shopify e conferma che appare la barra laterale dell'ordine.
Ogni casella di posta FreeScout memorizza il proprio dominio del negozio e token di accesso, così puoi connettere caselle di posta diverse a negozi 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 Shopify è un modulo a pagamento. Puoi ottenerlo in due modi:
- Acquista lo Shopify Connector per 18 EUR come licenza una tantum per un'installazione FreeScout, poi imposta la sua chiave di licenza come
SHOPIFYINTEGRATION_LICENSE_KEYnel FreeScout.env. - 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 |
|---|---|
| "Shopify ha rifiutato la connessione" al salvataggio | Il token è stato digitato male, revocato o appartiene a un altro store. Rivela un nuovo token reinstallando l'app personalizzata e incollalo di nuovo. |
| "Mancano questi ambiti Admin API" al salvataggio | Apri l'app personalizzata, aggiungi gli scope mancanti sotto Configura gli scope dell'Admin API, salva e reinstalla l'app. La reinstallazione emette un nuovo token. |
| Il dominio del negozio è rifiutato | Usa il your-store.myshopify.com dominio, o un dominio personalizzato che mappa su di esso. Gli host privati e gli indirizzi IP vengono rifiutati. |
| La barra laterale ordine non appare | Conferma che il pannello della casella di posta sia abilitato e che la connessione risulti connessa nella pagina delle impostazioni. |
| Gli ordini sono vuoti per un cliente noto | Conferma che l'email del cliente nella conversazione FreeScout corrisponda all'email dei suoi ordini Shopify. |
| Vengono mostrati solo gli ordini degli ultimi 60 giorni | Aggiungi il read_all_orders ambito all'app personalizzata, reinstallala e incolla il nuovo token. |
| 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 Shopify, invia l'indirizzo email del cliente all'API Shopify GraphQL Admin tramite HTTPS usando il token della tua app personalizzata. I dati degli ordini restituiti dal tuo negozio popolano la barra laterale di FreeScout e, con ReplyRabbit, costruiscono il contesto AI per le bozze.
L'app personalizzata ha solo ambiti di lettura, quindi il connettore non scrive mai nel tuo negozio. Il token di accesso è memorizzato crittografato in FreeScout, e le richieste in uscita verificano TLS e non seguono reindirizzamenti.
Nessun dato ordine Shopify 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 o Magento? Vedi la Connettore WooCommerce e Connettore Magento guide.
FAQ
Come si connette il connettore Shopify al mio negozio?
Con un'app personalizzata che crei nell'admin di Shopify (Impostazioni, App e canali di vendita, Sviluppa app). Assegna gli scope read_customers, read_orders e read_products, installala e incolla il suo token di accesso all'API Admin insieme al dominio del tuo negozio nelle impostazioni del connettore FreeScout. Il connettore verifica il token rispetto al tuo negozio prima di salvarlo.
Serve un account Shopify Partner o una scheda sull'App Store?
No. Un'app personalizzata viene creata all'interno dell'admin del tuo store e non richiede un account Partner, né una revisione dell'app, né una pubblicazione pubblica.
Quanto costa il connettore Shopify?
Il Connettore Shopify è 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, imposta la sua chiave di licenza come SHOPIFYINTEGRATION_LICENSE_KEY nel tuo .env di FreeScout.
Perché vedo solo ordini degli ultimi 60 giorni?
Shopify limita le app a 60 giorni di cronologia ordini, a meno che l'app non abbia lo scope read_all_orders. Seleziona read_all_orders durante la configurazione dell'app personalizzata per vedere la cronologia completa.
Ogni casella di posta FreeScout può connettersi a un negozio Shopify diverso?
Sì. Ogni casella memorizza il proprio dominio dello store e token di accesso nelle impostazioni del connettore, così store diversi possono collegarsi a caselle diverse.