Chatbot WooCommerce: un agente AI per il tuo negozio WordPress
Orygo AI si collega a WooCommerce in due parti. Le chiavi REST API del negozio, consumer key e consumer secret, danno all’agente AI catalogo, ordini e clienti. Il plugin WordPress orygo-conversion marca il carrello e comunica a Orygo AI gli ordini pagati, così ogni vendita nata in chat resta collegata alla sua conversazione. Con il negozio collegato l’agente cerca prodotti, mostra varianti e disponibilità, aggiunge al carrello WooCommerce dalla chat e risponde sullo stato degli ordini dopo aver verificato l’email del cliente.
4
azioni WooCommerce, attivabili una per una: ricerca, prodotto, ordine, cliente
2
componenti: chiavi REST API per i dati, plugin orygo-conversion per le vendite
1-20
prodotti restituiti per ricerca, 10 di default
6 canali
sito, WhatsApp, Instagram, Messenger, email e Amazon con lo stesso agente
Di Davide Petruzzi, founder di Orygo AI · Aggiornato il
Cosa fa il chatbot di Orygo AI su WooCommerce?
Su WooCommerce l’agente AI di Orygo vende e assiste con i dati veri del negozio. Prima dell’acquisto cerca nel catalogo, apre la scheda con variazioni e attributi, mostra i prodotti come card e li aggiunge al carrello. Dopo l’acquisto legge stato dell’ordine e numero di tracking, e riconosce il cliente dal suo storico ordini.
Pre-vendita
La ricerca di Orygo AI su WooCommerce è una ricerca per parole chiave su nomi e descrizioni dei prodotti. L’agente trasforma la domanda del cliente nei termini da cercare: da “mi serve qualcosa per la pelle secca, senza profumo” ricava le parole giuste, legge i risultati e propone solo quelli coerenti con quanto il cliente ha detto. Poi apre il prodotto scelto e risponde con i dati della scheda.
Variazioni e attributi
Taglie, colori e attributi del prodotto variabile, con la disponibilità di magazzino: l’agente vede quali variazioni ci sono e quali no.
Card prodotto in chat
I risultati compaiono come schede con immagine, prezzo e SKU, dentro il widget sul dominio del tuo negozio.
Aggiunta al carrello
Il cliente sceglie la variazione e aggiunge il prodotto al carrello WooCommerce senza lasciare la conversazione.
Post-vendita
Per un ordine Orygo AI chiede due dati: numero d’ordine ed email. L’email deve essere quella dell’ordine; se non combacia, la risposta è “ordine non trovato”, così nessuno legge l’ordine di un altro. Con l’ordine aperto l’agente comunica stato, numero di tracking e dettagli dell’acquisto. Dal profilo cliente, cercato per email, vede ordini recenti con articoli e spedizioni, numero di ordini e totale speso. Resi e cambi seguono le tue procedure e arrivano al team pronti da gestire nell’helpdesk.
Come si collega a WooCommerce: serve un plugin o bastano le API?
Servono entrambi, con compiti diversi. Le API REST di WooCommerce bastano per i dati: ricerca prodotti, schede, ordini e clienti. Il plugin WordPress orygo-conversion serve per le vendite: marca il carrello quando il cliente chatta e comunica a Orygo AI gli ordini pagati. Senza plugin l’agente risponde, ma le vendite non vengono collegate alle conversazioni.
| Componente | Dove si crea o si installa | A cosa serve |
|---|---|---|
| Chiavi REST API (ck_… e cs_…) | WooCommerce › Impostazioni › Avanzate › REST API | Ricerca prodotti, scheda prodotto, lettura ordine, profilo cliente |
| Plugin orygo-conversion | Plugin di WordPress | Marca il carrello e comunica gli ordini pagati, per le vendite attribuite e il test A/B del widget |
I passi del collegamento
[01]
Controlli i permalink di WordPressIn Impostazioni › Permalink deve essere scelta un’opzione diversa da “Semplice”, come richiede la documentazione di WooCommerce per le chiavi REST API.[02]
Generi le chiaviIn WooCommerce › Impostazioni › Avanzate › REST API, scegliendo descrizione, utente e permessi. Il consumer secret si vede una sola volta: va copiato subito.[03]
Inserisci in Orygo AIL’URL del sito WordPress, la consumer key e il consumer secret, nell’agente che userà il negozio. Le credenziali appartengono solo a quell’agente.[04]
Installi il plugin orygo-conversionPer collegare gli ordini pagati alle conversazioni.[05]
Accendi le azioniChe ti servono e provi l’agente nel playground prima della messa online.
Il lavoro lo segue il tuo AI engineer dedicato, dentro i 2-3 giorni lavorativi di messa online: come si va live.
Quali dati legge da WooCommerce e quali azioni esegue?
Orygo AI esegue su WooCommerce quattro azioni, tutte in sola lettura: cerca prodotti, apre un prodotto, legge un ordine e recupera il profilo del cliente. Nessuna crea o modifica ordini, prodotti o clienti. Ogni azione si accende o si spegne da sola, quindi puoi partire dalla pre-vendita e aggiungere gli ordini in un secondo momento.
| Azione | Cosa serve | Cosa riceve l’agente |
|---|---|---|
| Cerca prodotti | Parole da cercare in nomi e descrizioni | Nomi, descrizioni brevi, prezzi, immagini, SKU, disponibilità |
| Apri prodotto | Lo slug, cioè l’ultima parte dell’URL: /product/felpa-blu diventa felpa-blu | Immagini, descrizione, prezzi, variazioni (taglie e colori), magazzino, attributi |
| Leggi ordine | Numero d’ordine ed email del cliente | Stato, numero di tracking, dettagli dell’ordine |
| Profilo cliente | Nome, telefono, indirizzi di fatturazione e spedizione, numero di ordini, totale speso, data di registrazione, ordini recenti con articoli, spedizione e tracking |
I risultati della ricerca sono testo semplice, con la descrizione tagliata a circa 280 caratteri; la descrizione completa arriva quando l’agente apre il prodotto. Nell’helpdesk di Orygo AI il profilo WooCommerce compare accanto alla chat come scheda con la tabella degli ordini recenti.
Un esempio di procedura su WooCommerce
Le azioni si usano dentro procedure scritte in italiano. Ecco una procedura per i prodotti variabili; nomi delle azioni e regole sono di esempio.
Scelta della taglia
- 1Quando il cliente chiede se un prodotto c’è nella sua taglia, apri il prodotto con @Apri prodotto.
- 2Controlla le variazioni: se la taglia è disponibile, mostra la card e proponi di aggiungerla al carrello.
- 3Se la taglia è esaurita, cerca con @Cerca prodotti un modello simile e proponi al massimo 2 alternative disponibili.
- 4Se il cliente è indeciso fra due taglie, usa la guida taglie della knowledge base e consiglia quella più vicina alle sue misure.
Come si scrivono le procedure: procedure in linguaggio naturale. Tutte le azioni disponibili, comprese quelle custom via webhook verso altri plugin o gestionali: azioni e strumenti AI.
Orygo AI pesa sulle prestazioni di WordPress?
Il modello AI di Orygo non gira sul tuo hosting. Il sito WordPress riceve una chiamata alla REST API solo quando l’agente cerca un prodotto, apre una scheda, legge un ordine o un profilo, cioè quando un cliente lo chiede in chat. Sul sito si carica il widget della chat, e il plugin orygo-conversion lavora su carrello e ordini pagati.
| Momento | Lavoro richiesto al sito |
|---|---|
| Visitatore che non apre la chat | Caricamento del widget |
| Domanda su un prodotto | Una ricerca o una lettura di prodotto via REST API |
| Domanda su un ordine | Una lettura dell’ordine via REST API, dopo numero d’ordine ed email |
| Prodotto aggiunto dalla chat | Un’aggiunta al carrello WooCommerce |
| Ordine pagato | Il plugin comunica l’ordine a Orygo AI |
Due controlli prima della messa online. Se usi un firewall o un plugin di sicurezza, verifica che non blocchi le chiamate autenticate alla REST API di WooCommerce. E misura le pagine principali con e senza widget, per esempio con PageSpeed Insights, così il confronto lo fai sui tuoi dati.
Sul fronte sicurezza, Orygo AI ferma bot, flood di messaggi e prompt injection prima che arrivino ai dati del negozio: sicurezza dell’agente AI.
Plugin chatbot WordPress o agente AI collegato a WooCommerce: che differenza c’è?
Un plugin chatbot per WordPress vive dentro il sito e spesso si limita a pagine e FAQ, oppure chiede una chiave del modello AI da gestire in proprio. Orygo AI è un agente esterno che legge WooCommerce via API, risponde anche fuori dal sito con lo stesso addestramento e usa il plugin solo per misurare le vendite.
| Plugin chatbot WordPress generico | Orygo AI su WooCommerce | |
|---|---|---|
| Dove lavora l’AI | Dipende dal plugin: sul tuo server o con una chiave AI tua | Sui server di Orygo AI; WordPress risponde solo alle chiamate REST API |
| Ordini | Spesso solo nelle versioni a pagamento, o con estensioni | Lettura ordine inclusa, con verifica dell’email |
| Carrello | Dipende dal plugin | Aggiunta al carrello WooCommerce dalla chat, con la variazione scelta |
| Canali | Di solito solo il sito | Sito, WhatsApp, Instagram, Messenger, email e Amazon |
| Vendite misurate | Raramente collegate alla conversazione | Ogni ordine pagato collegato alla chat che lo ha preceduto |
| Configurazione | La fai tu | La fa un AI engineer dedicato |
Tutto quello che fa l’agente nella chat del sito, dal messaggio di benvenuto alle card prodotto, è nella pagina dell’assistente AI per il sito web.
Cosa cambia fra WooCommerce e Shopify in Orygo AI?
Su WooCommerce Orygo AI ha le stesse quattro azioni, le card prodotto, il carrello in chat e le vendite attribuite di Shopify. Cambiano due cose: la ricerca è per parole chiave invece che con la ricerca del negozio online, e le missioni WhatsApp di recupero checkout e riordino oggi esistono solo su Shopify.
| WooCommerce | Shopify | |
|---|---|---|
| Collegamento | Chiavi REST API più plugin orygo-conversion | Dominio, client ID e client secret |
| Ricerca prodotti | Parole chiave su nomi e descrizioni | Ricerca del negozio online, con contesto del cliente |
| Scheda, ordine, profilo cliente | Sì | Sì |
| Card prodotto e carrello in chat | Sì | Sì |
| Vendite attribuite alla chat | Sì, con il plugin | Sì |
| Recupero checkout e riordino su WhatsApp | No | Sì |
Per ricontattare i clienti WooCommerce su WhatsApp puoi usare un broadcast con un template approvato da Meta e una lista CSV: riattivazione dei clienti inattivi.
Domande frequenti su Orygo AI e WooCommerce
Serve installare un plugin?
Sì, uno: il plugin WordPress orygo-conversion, che marca il carrello e comunica a Orygo AI gli ordini pagati, per collegare le vendite alle conversazioni. Catalogo, ordini e clienti invece arrivano dalle chiavi REST API di WooCommerce, senza altri plugin.
Funziona con qualsiasi tema WordPress?
Il collegamento ai dati non dipende dal tema: Orygo AI legge prodotti, ordini e clienti dalla REST API di WooCommerce, qualunque tema tu usi. Widget e aggiunta al carrello lavorano sul carrello di WooCommerce: se il tuo tema o un plugin sostituiscono il carrello standard, conviene provarli insieme nel playground prima della messa online.
Che permessi devono avere le chiavi REST API?
Le quattro azioni WooCommerce di Orygo AI leggono soltanto: cercano prodotti, aprono una scheda, leggono un ordine e un profilo cliente. Il permesso da scegliere quando generi le chiavi lo conferma il tuo AI engineer durante il collegamento.
Il chatbot funziona su un sito WordPress senza WooCommerce?
Le azioni su catalogo, ordini e clienti richiedono WooCommerce, perché leggono i dati dalla sua REST API. Il plugin orygo-conversion serve a collegare gli ordini WooCommerce alle conversazioni, quindi senza un negozio WooCommerce non ha ordini da collegare.
Il recupero dei carrelli abbandonati su WhatsApp funziona con WooCommerce?
No, oggi no. Le missioni WhatsApp di Orygo AI, recupero checkout e riordino, partono da eventi di Shopify. Su WooCommerce l’agente vende e assiste in chat e sugli altri canali, e i clienti si possono ricontattare con un broadcast WhatsApp da lista CSV.
Come verifica Orygo AI chi chiede un ordine WooCommerce?
Con numero d’ordine ed email insieme. Se l’email non è quella registrata sull’ordine, Orygo AI risponde che l’ordine non è stato trovato, senza dire se esiste. Dell’ordine l’agente non mostra mai l’indirizzo completo.
Collega Orygo AI a Shopify: ricerca nel catalogo, carrello in chat, ordini e recupero carrelli su WhatsApp gestiti dall’agente AI. Live in 2-3 giorni.
Scopri shopifyIntegra Orygo AI con PrestaShop: l’agente AI consiglia prodotti, aggiunge al carrello e risponde su ordini e spedizioni. Live in 2-3 giorni. Prenota una demo.
Scopri PrestaShopOrygo AI si integra con Magento 2 e Adobe Commerce: l’agente AI cerca per nome o SKU, aggiunge al carrello e risponde sugli ordini. Scopri l’integrazione.
Scopri magentoCollega Orygo AI a BigCommerce: l’agente AI cerca nel catalogo, legge ordini e clienti e aggiunge al carrello in chat. Live in 2-3 giorni. Prenota una demo.
Scopri BigCommerceOrygo AI si integra con Salesforce Commerce Cloud: un agente AI per brand enterprise che legge catalogo, ordini e clienti, in sola lettura. Scopri come.
Scopri Salesforce Commerce CloudVuoi vedere Orygo AI sul tuo negozio WooCommerce?
Prenota una demo: colleghiamo l’agente al tuo catalogo, ti mostriamo una ricerca, un prodotto variabile aggiunto al carrello dalla chat e una domanda su un ordine. Tutte le piattaforme collegate sono nelle integrazioni di Orygo AI.