Epinium Docs

Italiano

Español
English
Français
Deutsch

Italiano

Español
English
Français
Deutsch

Appearance

Integrazione con WooCommerce ​

Accesso da: Configurazione → Connessioni

Una volta collegato il tuo negozio WooCommerce, il tuo assistente IA può consultare il catalogo del negozio tramite il MCP di Epinium. La connessione è in sola lettura: il tuo assistente consulta, ma Epinium non modifica nulla nel tuo negozio.

Non devi creare nessuna app. È il negozio stesso a generare una chiave di accesso in sola lettura, e tu approvi, dalla bacheca di WordPress, che Epinium la usi. Il processo ha due passi e richiede pochi minuti.

I menu di WordPress, nella tua lingua

Questa guida chiama i menu di WordPress e WooCommerce come appaiono in italiano. La tua bacheca li mostrerà nella lingua del tuo WordPress, e qualche nome potrebbe variare leggermente a seconda della versione.

Prima di iniziare ​

  • Il tuo negozio deve usare una connessione sicura. Il suo indirizzo deve iniziare con https:// e aprirsi nel browser senza avvisi di sicurezza.
  • I permalink di WordPress non possono essere impostati su "Semplice". Si cambiano nella bacheca di WordPress, in Impostazioni → Permalink: va bene qualsiasi altra opzione.
  • L'API REST del tuo negozio deve essere raggiungibile. È il canale con cui WooCommerce condivide i dati con altre applicazioni, e alcuni plugin di sicurezza la bloccano.
  • Devi accedere a WordPress come amministratore del negozio. Se il negozio lo amministra un'altra persona, tienila a portata di mano: sarà lei ad accedere e ad approvare l'accesso.

Passo 1: verifica il tuo negozio ​

  1. Vai su Configurazione → Connessioni e fai clic su Aggiungi connessione.
  2. Scegli WooCommerce.
  3. In Indirizzo del tuo negozio, scrivi l'indirizzo che i tuoi clienti usano per entrare nel tuo negozio, ad esempio mionegozio.com. Puoi scriverlo con o senza https://.
  4. Fai clic su "Verifica negozio".

Epinium verifica che a quell'indirizzo ci sia un negozio WooCommerce che soddisfa i requisiti. Se ne manca qualcuno, te lo dice subito, prima di aprire qualsiasi cosa nel tuo negozio (i messaggi e cosa fare con ciascuno sono in Problemi frequenti).

Se è tutto a posto, vedrai il messaggio "Abbiamo trovato il tuo negozio", con l'indirizzo che verrà collegato. Potrebbe non essere esattamente quello che hai scritto: se il tuo negozio usa www. o è installato in una cartella (mionegozio.com/negozio), Epinium usa l'indirizzo che dichiara il negozio stesso.

Passo 2: approva l'accesso nel tuo negozio ​

  1. Fai clic su "Approva nel mio negozio". Si apre una finestra del tuo negozio.
  2. Accedi a WordPress come amministratore, se non avevi già effettuato l'accesso.
  3. WooCommerce ti mostra che Epinium - nome del tuo account vuole collegarsi al tuo negozio con accesso in lettura. Fai clic su "Approva".
  4. La finestra si chiude ed Epinium ti conferma che il negozio è collegato. Fai clic su "Finalizzare".

In quella schermata, WooCommerce elenca tutto ciò che una chiave in lettura permette di vedere in generale: coupon, clienti, ordini e report di vendita, e prodotti. È il suo testo standard per qualsiasi applicazione che chieda accesso in lettura. Epinium lascia consultare al tuo assistente solo ciò che è descritto in Cosa può leggere il tuo assistente e cosa no.

Se lasci passare qualche minuto tra il passo 1 e il passo 2, Epinium ti chiederà di verificare di nuovo il negozio prima di continuare.

Perché compare il nome del tuo account

WooCommerce mostra il nome di chi chiede l'accesso. Epinium aggiunge il nome del tuo account perché la persona che approva sappia esattamente chi lo chiede. WooCommerce lo salva anche nella descrizione della chiave, così in seguito la riconoscerai nel tuo negozio come Epinium - nome del tuo account - API (data). Se sei un'agenzia e colleghi il negozio di un cliente, compare il nome di quel cliente in Epinium. Se chi approva non riconosce il nome, non deve approvare.

Alternativa: collegarsi con una chiave ​

Se la finestra del tuo negozio non si apre, o dopo l'approvazione WordPress ti mostra una pagina di errore e la finestra non torna a Epinium, puoi collegarti creando tu la chiave nel negozio e incollandola in Epinium.

Nel tuo negozio: crea la chiave ​

  1. Nella bacheca di WordPress, vai su WooCommerce → Impostazioni → Avanzate → API REST e fai clic su "Aggiungi chiave".
  2. Dalle una descrizione che ti aiuti a riconoscerla in seguito, ad esempio "Epinium".
  3. Scegli un utente amministratore.
  4. Scegli il permesso "Lettura": così la chiave permette solo di consultare.
  5. Fai clic su "Genera chiave API". WooCommerce ti mostra la chiave cliente (inizia con ck_) e il segreto cliente (inizia con cs_). Copiali adesso: WooCommerce li mostra solo in quella schermata.

In Epinium: incolla la chiave ​

  1. Nella schermata WooCommerce di Epinium, scrivi l'Indirizzo del tuo negozio, come al passo 1.
  2. Apri il pannello "La finestra non si apre o dà errore? Collegati con una chiave".
  3. Incolla la chiave in Chiave cliente (consumer key) e il segreto in Segreto cliente (consumer secret).
  4. Fai clic su "Collegati con la chiave".

Epinium prova la chiave con il tuo negozio prima di salvarla. Se non funziona, la connessione non viene creata e la schermata ti dice perché.

Se arrivi da un tentativo di approvazione che non si è concluso, Epinium ti offre il pulsante "Collegati con una chiave", che ti porta direttamente a questo modulo.

Cosa può leggere il tuo assistente e cosa no ​

Il tuo assistente può consultare:

  • Il catalogo: prodotti e le loro variazioni, categorie, tag, marchi e attributi.
  • I report di vendita, i prodotti più venduti e i totali del negozio (quanti ordini, prodotti, clienti, coupon o recensioni ci sono, senza vederne nessuno in particolare).
  • Dati di riferimento: paesi, continenti e valute.

Il tuo assistente non può consultare:

  • Ordini, clienti, coupon né recensioni, perché contengono nomi, email o indirizzi di persone.
  • La configurazione del negozio: impostazioni, imposte, spedizioni o metodi di pagamento.
  • I campi che i plugin aggiungono ai prodotti. Alcuni plugin vi salvano dati personali, perciò Epinium non li consegna mai, anche se la chiave tecnicamente permette di leggerli.

Epinium non scrive nulla nel tuo negozio: la chiave è in sola lettura, quindi è il negozio stesso a impedire qualsiasi modifica.

I tuoi dati e il modello di IA

Epinium non conserva i dati del tuo negozio WooCommerce e non li invia a nessun modello di IA proprio. Il tuo assistente consulta il negozio nel momento in cui ne ha bisogno, e sei tu a scegliere e pagare il modello di IA che preferisci, collegandolo per conto tuo.

Scollegare e revocare l'accesso ​

  1. In Configurazione → Connessioni, trova il tuo negozio nell'elenco e scegli "Eliminare" tra le sue azioni.
  2. Conferma. Epinium elimina subito la connessione e le chiavi che conservava.
  3. Perché la chiave smetta di esistere anche nel tuo negozio, vai su WooCommerce → Impostazioni → Avanzate → API REST nella bacheca di WordPress, trova la chiave Epinium - nome del tuo account - API (data) (o la descrizione che le hai dato, se l'hai creata tu) e revocala.

Epinium non può revocare la chiave al posto tuo: WooCommerce permette di farlo solo dalla bacheca del negozio. Finché non la revochi, la chiave continua a esistere nel tuo negozio, anche se Epinium non la usa più.

Se ricolleghi lo stesso negozio

Quando ricolleghi un negozio che era già collegato, Epinium inizia a usare una chiave nuova e quella precedente resta attiva nel tuo negozio. Puoi revocare quella vecchia allo stesso modo.

Problemi frequenti ​

Causa: il tuo WordPress usa l'opzione "Semplice" per i permalink, e con essa WooCommerce non può completare l'approvazione.

Soluzione: nella bacheca di WordPress, vai su Impostazioni → Permalink, scegli qualsiasi altra opzione, salva le modifiche e fai di nuovo clic su "Verifica negozio". Questa impostazione cambia il formato degli indirizzi delle tue pagine: se un'altra persona gestisce il tuo sito, avvisala prima.

"Il tuo negozio deve usare una connessione sicura (https)" ​

Causa: il tuo negozio si apre con http:// invece di https://, oppure l'indirizzo che dichiara il negozio stesso non è sicuro.

Soluzione: attiva la connessione sicura (il certificato SSL) dal pannello del tuo hosting, o chiedi al tuo fornitore di attivarla. Quando il negozio si apre con https://, verificalo di nuovo.

"Non siamo riusciti a raggiungere il tuo negozio" ​

Causa: l'indirizzo è scritto male, il sito non funziona o non risponde in tempo, oppure il suo certificato di sicurezza non è valido.

Soluzione: apri l'indirizzo nel browser e controlla che il negozio si carichi senza avvisi di sicurezza. Correggilo se serve e riprova.

"Non abbiamo trovato WooCommerce a questo indirizzo" ​

Causa: WooCommerce non è attivo su quel sito, oppure un plugin di sicurezza (o il firewall del tuo hosting) blocca l'API REST del negozio.

Soluzione: controlla in Plugin che WooCommerce sia attivo. Se lo è, rivedi la configurazione dei tuoi plugin di sicurezza e consenti l'accesso all'API REST, oppure chiedi al tuo hosting.

Il mio browser blocca la finestra del negozio ​

Causa: il tuo browser non permette a Epinium di aprire finestre pop-up.

Soluzione: consenti le finestre pop-up per Epinium nel tuo browser e fai di nuovo clic su "Approva nel mio negozio".

WordPress mostra un errore dopo l'approvazione e la finestra non torna a Epinium ​

Causa: il negozio non è riuscito a completare la consegna della chiave a Epinium. Di solito dipende da un plugin di sicurezza che blocca l'API REST o da un hosting che non rileva correttamente la connessione sicura. Quando succede, WooCommerce elimina la chiave e mostra la propria pagina di errore invece di tornare a Epinium, quindi nel tuo negozio non resta nessuna chiave a metà.

Soluzione: chiudi la finestra del negozio e, in Epinium, fai clic su "Annullare". Vedrai il pulsante "Collegati con una chiave": usalo e segui l'alternativa con una chiave.

"Il tuo negozio ha rifiutato la chiave" anche se la chiave è corretta ​

Causa più comune: la chiave non è stata copiata per intero, appartiene a un utente che non è amministratore oppure non ha il permesso di lettura.

Altra causa: il tuo negozio è dietro una CDN o un proxy (ad esempio, un servizio come Cloudflare) che riceve la connessione sicura ma non la passa a WordPress. WordPress crede allora che la connessione non sia sicura e rifiuta la chiave, anche se l'indirizzo del tuo negozio inizia con https://.

Soluzione: controlla prima la chiave, l'utente e il permesso "Lettura". Se è tutto corretto e usi una CDN o un proxy, chiedi a chi gestisce il tuo hosting di fare in modo che WordPress riconosca la connessione sicura che gli arriva attraverso quel servizio, e riprova.

Ho annullato l'accesso nel mio negozio ​

Causa: nella schermata di WooCommerce l'accesso è stato rifiutato invece che approvato. Epinium lo segnala con il messaggio "Hai annullato l'accesso nel tuo negozio".

Soluzione: se è stato per errore, fai di nuovo clic su "Verifica negozio" e su "Approva nel mio negozio", e questa volta fai clic su "Approva".

La connessione appare come "Senza connessione" con il pulsante "Rinnovare" ​

Causa: il tuo negozio non accetta più la chiave di Epinium. Succede quando qualcuno la revoca in WooCommerce → Impostazioni → Avanzate → API REST, o quando l'utente WordPress a cui appartiene perde il ruolo di amministratore o viene eliminato.

Soluzione: in Configurazione → Connessioni, fai clic su "Rinnovare" su quel negozio e ripeti il collegamento: il passo 1 e il passo 2, o l'alternativa con una chiave. Rinnovare aggiorna la stessa connessione: non conta come un nuovo negozio nel tuo piano.

"Il tuo piano non consente altre connessioni" ​

Causa: ogni negozio WooCommerce conta come una connessione del tuo piano, e hai già usato tutte quelle che include.

Soluzione: passa a un piano superiore dall'avviso che compare sullo schermo e riprova. Rinnovare un negozio già collegato non viene bloccato da questo limite.

Hai bisogno di ulteriore aiuto?

Se il problema persiste dopo aver seguito questi passaggi, contatta il team di supporto di Epinium tramite la chat della piattaforma o all'indirizzo support@epinium.com.

Epinium Documentation