
Connettore WooCommerce
Funziona con WooCommerce
Collega WooCommerce a FreeScout così le conversazioni mostrano gli ordini dei clienti abbinati e il contesto di acquisto. Il connettore comunica direttamente con l'API REST di WooCommerce, quindi non c'è alcun plugin lato negozio da installare. 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 WooCommerce aggiunge una barra laterale degli ordini alle conversazioni FreeScout. Quando una conversazione ha un indirizzo email del cliente, il connettore interroga la REST API di WooCommerce (wc/v3) 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 WooCommerce per FreeScout. Legge la REST API di WooCommerce tramite HTTPS usando una consumer key e un secret, 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 WooCommerce raggiungibile via HTTPS, con accesso amministratore per creare chiavi REST API.
- Un negozio che non è dietro l'autenticazione HTTP Basic a livello di sito, che entra in conflitto con l'header di autenticazione della REST API.
- ReplyRabbit installato e attivato se desideri il contesto di proprietà del prodotto nelle bozze AI.
- Una licenza WooCommerce 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.
Genera chiavi API REST WooCommerce
Il connettore si autentica con una chiave REST API di WooCommerce, composta da una consumer key e un consumer secret. Crea la chiave nel tuo pannello di amministrazione WordPress.
Apri le impostazioni dell'API REST
Nell'admin di WordPress, vai su WooCommerce, poi Impostazioni, poi Avanzate, poi API REST.Aggiungi una chiave
Clicca Aggiungi chiave. Inserisci una descrizione come "ReplyRabbit Connector", imposta Autorizzazioni a Leggi, e clicca Genera chiave API.Copia la consumer key e il secret
Copia il Consumer key e Consumer secret. WooCommerce mostra il secret una sola volta, quindi conserva entrambi i valori in un luogo sicuro prima di lasciare la pagina.
Accesso in sola lettura
Installa il modulo connettore FreeScout
Il modulo connettore WooCommerce per FreeScout interroga l'API REST di WooCommerce 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. 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 WooCommerce 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 WooCommerce, apri il menu delle impostazioni della casella e scegli Connettore del negozio. Questa è la pagina delle impostazioni del connettore WooCommerce, non una sezione all'interno delle impostazioni di ReplyRabbit.Inserisci l'URL dello store
Incolla l'URL di base del tuo negozio WooCommerce su HTTPS, ad esempiohttps://your-store.com. Non è necessaria una barra finale.Inserisci la consumer key e il secret
Incolla la Consumer key e Consumer secret che hai generato in WooCommerce. Sono memorizzati in forma crittografata e dopo il salvataggio viene mostrata solo un'anteprima mascherata.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 WooCommerce e conferma che appare la barra laterale dell'ordine.
Ogni casella di posta FreeScout memorizza il proprio URL del negozio e le chiavi API REST, così puoi connettere caselle di posta diverse a negozi WooCommerce 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 WooCommerce è un modulo a pagamento. Puoi ottenerlo in due modi:
- Acquista il WooCommerce 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 del negozio, la consumer key e il consumer secret nelle impostazioni del connettore siano corretti e che il pannello della casella di posta sia abilitato. |
| "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 del negozio è rifiutato | Lo store deve essere servito tramite HTTPS. Un semplice http:// URL o un host irraggiungibile viene rifiutato. |
| L'autenticazione fallisce | Conferma che il negozio non sia protetto dall'autenticazione Basic HTTP a livello di sito, che intercetta l'header di autenticazione dell'API REST prima che WooCommerce lo veda. |
| La consumer key o il secret è rifiutato | Rigenera la chiave in WooCommerce sotto Impostazioni, poi Avanzate, poi API REST, con Leggi autorizzazione e incolla la nuova consumer key e il secret nelle impostazioni del connettore. |
| Gli ordini sono vuoti per un cliente noto | Conferma che l'email del cliente nella conversazione FreeScout corrisponda all'email di fatturazione dei suoi ordini WooCommerce. |
| 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 WooCommerce, invia l'indirizzo email del cliente alla tua API WooCommerce REST 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.
La chiave API REST necessita solo di Leggi autorizzazione, quindi il connettore non scrive mai nel tuo store. La consumer key e il secret sono memorizzati cifrati in FreeScout, e le richieste in uscita verificano TLS e non seguono reindirizzamenti.
Nessun dato ordine WooCommerce 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.
- Vedi Come installare il modulo ReplyRabbit se non hai ancora installato ReplyRabbit.
FAQ
Serve un plugin WordPress per il connettore WooCommerce?
No. Il connettore comunica direttamente con l'API REST di WooCommerce. Generi una chiave API REST in WooCommerce e inserisci l'URL dello store, la consumer key e il consumer secret nel connettore FreeScout. C'è un solo download, il modulo connettore WooCommerce per FreeScout.
Quanto costa il connettore WooCommerce?
Il Connettore WooCommerce è incluso con un piano ReplyRabbit Pro o Team attivo. In alternativa, costa 18 EUR come licenza una tantum per una installazione FreeScout. Se lo acquisti, incolla la sua chiave di licenza nelle impostazioni del connettore.
Come fa il connettore a trovare i clienti?
Il connettore cerca gli ordini WooCommerce tramite l'indirizzo email del cliente nella conversazione FreeScout. Per la proprietà dei prodotti, verifica anche le email collegate e, come fallback best-effort, altri ordini pagati sullo stesso dominio email.
Quale permesso richiede la chiave API REST?
Solo lettura. Il connettore non scrive mai nel tuo negozio, quindi una chiave con permesso di Lettura è sufficiente.
Ogni casella di posta FreeScout può connettersi a un negozio WooCommerce diverso?
Sì. Ogni casella memorizza il proprio URL dello store e le chiavi REST API nelle impostazioni del connettore, così store diversi possono collegarsi a caselle diverse.