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 lettura e scrittura: oltre a consultare, il tuo assistente può creare, modificare ed eliminare prodotti e contenuti del catalogo, purché tu gli dia quel permesso (vedi Cosa può scrivere il tuo assistente).

Non devi creare nessuna app. È il negozio stesso a generare una chiave di accesso in lettura e scrittura, 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 e scrittura. 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 e scrittura permette di vedere e modificare in generale: coupon, clienti, ordini e report di vendita, e prodotti. È il suo testo standard per qualsiasi applicazione che chieda quel permesso. Epinium lascia toccare al tuo assistente solo ciò che è descritto in Cosa può leggere il tuo assistente e cosa no e in Cosa può scrivere il tuo assistente.

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 "Leggi/Scrivi": così la chiave permette di consultare e anche di modificare il catalogo. Con "Leggi" la connessione funziona, ma il tuo assistente potrà solo 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.

Cosa può scrivere il tuo assistente ​

Perché il tuo assistente modifichi qualcosa nel tuo negozio, la chiave API o l'autorizzazione del MCP deve avere il permesso Dati dei tuoi negozi e piattaforme collegati → Modificare (si sceglie in Impostazioni → API Keys o quando autorizzi l'assistente; concedere permessi di modifica è incluso a partire dal piano Business). Senza, il tuo assistente si limita a consultare. Una chiave o un'autorizzazione che avevi già non lo riceve: creane una nuova o autorizza di nuovo.

Con quel permesso, il tuo assistente può modificare ciò che può consultare, e nient'altro. Può creare, modificare ed eliminare:

  • Prodotti e le loro variazioni.
  • Categorie, tag, marchi e attributi, e i termini di ogni attributo.

Il tuo assistente non può toccare ordini, clienti, coupon, recensioni né la configurazione del negozio, né scrivere nei campi che i plugin aggiungono ai prodotti. I report e i dati di riferimento (paesi, continenti e valute) si possono solo consultare.

Due cose da sapere prima di concedere il permesso:

  • Le modifiche si applicano direttamente nel tuo negozio, senza revisione preventiva. Non passano per Processi → Attività.
  • Alcune eliminazioni non si possono annullare. Un prodotto eliminato va nel cestino di WooCommerce, da cui puoi recuperarlo, a meno che l'assistente non chieda l'eliminazione definitiva. Categorie, tag, marchi, attributi e termini non hanno cestino: si eliminano per sempre.

Cosa viene registrato ​

Ogni modifica che il tuo assistente invia al tuo negozio viene registrata per 12 mesi: cosa ha chiesto, quando, il risultato (applicato, rifiutato dal negozio o risultato sconosciuto), la risposta del negozio e quale assistente l'ha fatta. Per consultarla, chiedila al tuo assistente ("mostrami le ultime modifiche nel mio negozio") oppure usa GET /v1/platform-changes nell'API. Non conserva il valore precedente: se ti serve sapere com'era un prodotto prima della modifica, il tuo assistente deve leggerlo prima di modificarlo. Quando un prodotto viene eliminato, la risposta registrata include il prodotto eliminato. Consultare questo registro costa 1 credito per riga restituita, come il registro delle modifiche pubblicitarie.

Una modifica costa quanto una consultazione: 5 crediti più 1 per KB di risposta, anche se il negozio la rifiuta per un dato non valido. Una che Epinium blocca prima di inviarla non costa nulla.

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.

Usare il tuo negozio dai workflow ​

Oltre al tuo assistente, un workflow può consultare e modificare il tuo negozio con il nodo Richiesta al negozio: ad esempio, per crearvi i prodotti che vendi su Amazon. Può modificare le stesse cose del tuo assistente, le modifiche si applicano direttamente e finiscono nello stesso registro, con il workflow come origine. Scrivere da un workflow è incluso a partire dal piano Business.

Se il tuo negozio ha una vecchia chiave in sola lettura ​

I negozi collegati prima che Epinium potesse scrivere hanno una chiave in sola lettura. Continuano a funzionare per consultare, ma se il tuo assistente prova a modificare qualcosa riceve un avviso che spiega che la chiave non permette di scrivere. Per risolvere:

  1. In Configurazione → Connessioni, fai clic su Aggiungi connessione, scegli WooCommerce e scrivi lo stesso indirizzo del tuo negozio.
  2. Ripeti la procedura: il passo 1 e il passo 2, oppure l'alternativa con una chiave (con il permesso "Leggi/Scrivi").
  3. Epinium aggiorna la stessa connessione con la chiave nuova. La chiave vecchia resta attiva nel tuo negozio: revocala come spiegato di seguito.

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 e scrittura.

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 "Leggi/Scrivi". 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.

Il mio assistente dice che la chiave del negozio non permette di scrivere ​

Causa: il negozio è collegato con una chiave in sola lettura, oppure il negozio ha rifiutato la chiave durante la scrittura.

Soluzione: ricollega il negozio in modo che Epinium usi una chiave di lettura e scrittura, come spiegato in Se il tuo negozio ha una vecchia chiave in sola lettura. Nel frattempo la lettura continua a funzionare e riprovare non serve a nulla.

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