Come gli agenti AI leggono e agiscono sui dati della tua WooCommerce Wishlist

Molti proprietari di negozi WooCommerce hanno sentito "AI" proposto come un widget di chat nell'angolo di una pagina prodotto. Quindi, quando un cliente chiede cosa può fare l'AI con i dati del negozio, la risposta onesta è stata solitamente "non molto".

Le cose stanno cambiando. WordPress 6.9 ha aggiunto l'API Abilities al core. È uno standard che consente a un plugin di pubblicare azioni nominate che altri software possono scoprire e chiamare. SaveTo Wishlist Pro ne registra 15, a partire da il rilascio che ha introdotto il supporto per l'API Abilities.

Questa guida copre l'accesso ai dati della wishlist dell'agente WooCommerce AI dal lato del proprietario del negozio, non dello sviluppatore. Vedrai cos'è un'abilità, quali dati della wishlist un agente può leggere e cosa può modificare. Tratterò anche il modello di autorizzazione, come connettere un client e dove tutto si ferma.

Salta a:

---

Cos'è realmente l'API WordPress Abilities

L'API Abilities di WordPress è un modo standard per un plugin di pubblicare le cose nominate che può fare. Il software esterno a WordPress può quindi trovare quelle azioni ed eseguirle senza un'integrazione personalizzata.

Pensala come un menu di un ristorante. Senza di esso, ogni cliente dovrebbe entrare in cucina e spiegare cosa voleva. Un menu elenca i piatti e cosa viene fornito con ciascuno, e lascia la cucina responsabile di chi viene servito. Le abilità svolgono quel compito per il tuo sito.

Dove si inserisce MCP

Ogni abilità ha un nome, un input definito, un output definito e un controllo dei permessi. Questa struttura è importante a causa di un secondo standard, il Model Context Protocol, solitamente abbreviato in MCP. MCP è un formato condiviso che i client AI utilizzano per trovare gli strumenti disponibili e chiamarli.

Tuttavia, WordPress non parla MCP da solo. Un plugin bridge come l'adattatore MCP ufficiale trasforma le abilità in strumenti che un client MCP può elencare. Anche il nostro plugin gemello StoreAgent esegue un server MCP, con impostazioni per sfogliare le abilità registrate dai tuoi plugin.

La sequenza è la seguente:

1. Il plugin registra le sue abilità. Questo avviene sul tuo sito, nel codice, quando il plugin viene caricato.
2. Un client si connette tramite il bridge e chiede cosa è disponibile. Riceve un elenco strutturato di azioni nominate, non un muro di documentazione.
3. Fai una domanda in linguaggio normale. Qualcosa come "quali prodotti le persone salvano di più questo mese?"
4. Il client sceglie un'abilità corrispondente e la chiama. La risposta proviene dai dati del tuo negozio live.

Non c'è esportazione, nessun foglio di calcolo e nessun connettore personalizzato per ogni strumento AI. Il tuo negozio pubblica il menu una volta, e qualsiasi client che parla MCP può ordinarlo una volta che lo hai connesso.

---

Come appare una funzionalità in pratica

Un'abilità è un'azione nominata con un input fisso, un output fisso e un controllo dei permessi che viene eseguito per primo. È deliberatamente piccola, in modo che un'abilità faccia un lavoro nello stesso modo ogni volta.

SaveTo Wishlist Pro registra le sue abilità sotto il prefisso saveto-wishlist/, all'interno di una categoria di abilità chiamata saveto-wishlist. Di conseguenza, ogni nome di abilità ti dice da quale plugin proviene.

Altri plugin Rymera utilizzano la stessa API. Advanced Coupons, ad esempio, ti consente di gestire i coupon WooCommerce con l'AI.

Prendi get-product-insights. È di sola lettura, quindi chiamarlo non cambia nulla. Ad esempio, chiedi a un assistente quali prodotti i clienti salvano di più, e ti restituirà i tuoi prodotti più popolari, di tendenza e aggiunti di recente. Un approfondimento sulle categorie va a get-category-insights, che raggruppa l'attività della wishlist per categoria e marca.

Ora prendi share-wishlist-by-link. Scrive, quindi è contrassegnato come distruttivo. È anche contrassegnato come idempotente, quindi è sicuro riprovare. In altre parole, chiamarlo due volte con lo stesso input termina nello stesso stato.

Se stai scrivendo codice contro lo store da solo, l'API REST è ancora lo strumento giusto. La guida per sviluppatori dell'API REST della wishlist copre tali endpoint. Detto questo, i due sono facili da confondere. Gli endpoint REST sono adatti al software che stai costruendo e controllando, mentre le abilità sono adatte al software che non hai costruito, come un client AI.

---

Il modello di autorizzazione e cosa è consentito fare a un agente

Ogni abilità esegue una callback di autorizzazione prima di fare qualsiasi cosa, e quel controllo è il nucleo della storia della sicurezza. In breve, un client AI che chiede educatamente non amplia ciò che un utente è autorizzato a fare.

SaveTo Wishlist Pro utilizza due callback, ma stabiliscono lo stesso standard:

• Abilità distruttive: qualsiasi cosa che scrive o modifica dati viene eseguita dietro una callback can_manage_woocommerce. Quello è il territorio del gestore del negozio, non del visitatore generico.
• Abilità di sola lettura: queste utilizzano una callback separata can_view_data, ma controlla la stessa capacità manage_woocommerce. La lettura richiede lo stesso account della scrittura.

Ogni abilità porta anche annotazioni MCP costruite dalle sue flag distruttive e idempotenti. Quelle annotazioni dicono a un client, prima che chiami qualsiasi cosa, se uno strumento modifica i dati e se un nuovo tentativo è sicuro.

Un'altra decisione di progettazione è più importante di quanto sopra. Ogni abilità distruttiva passa allo stesso livello di servizio che utilizzano le schermate di amministrazione, senza un percorso di codice separato solo per l'AI. Quindi, quando un agente invia via email una wishlist, le stesse azioni di WordPress e WooCommerce vengono attivate come quando lo fai tu. Le stesse email vengono inviate e gli stessi hook vengono eseguiti.

Ciò può sembrare una nota a piè di pagina architettonica arida. In pratica, significa che un agente non ha scorciatoie per aggirare la tua registrazione, le tue integrazioni o le tue notifiche ai clienti. Questo è ciò che rende la funzionalità qualcosa che puoi controllare.

❗️🔍️ Cosa controllare: alcuni strumenti aggiungono un percorso di codice separato per l'accesso automatizzato. Gli eventi che si attivano con un clic umano potrebbero quindi non attivarsi mai con uno automatizzato. Quando ciò accade, un CRM può smettere di ricevere record senza che nessuno se ne accorga. Qualunque cosa tu colleghi, chiedi se il suo percorso automatizzato esegue lo stesso codice delle sue schermate di amministrazione.

---

Cosa espone SaveTo Wishlist Pro agli agenti AI

SaveTo Wishlist Pro registra una categoria di abilità e 15 abilità sotto il prefisso saveto-wishlist/. Sono arrivate nella versione Pro 1.0.2, rilasciata il 30 giugno 2026.

Queste capacità segnalano i dati che i tuoi clienti creano ogni giorno. Ad esempio, un acquirente fa clic sul pulsante della wishlist e quel clic diventa un record che una capacità di analisi può contare in seguito. Nel plugin gratuito SaveTo Wishlist Lite, il pulsante viene visualizzato nelle pagine del negozio "out of the box". Una volta salvato un prodotto, la sua etichetta cambia in "Rimuovi dalla Wishlist".

Quattro capacità per iniziare

Ecco quattro che probabilmente userai per prime:

Gruppo di capacità	Capacità di esempio	Modifica dati?
Condivisione	condividi la wishlist tramite link	Sì, è sicuro riprovare
Analisi prodotto	ottieni approfondimenti sui prodotti	No
Analisi categoria	ottieni approfondimenti sulle categorie	No
Tendenze	ottieni tendenze basate sul tempo	No

La lista completa di 15 segue questa sezione. Ciascuna di queste quattro risponde a un diverso tipo di domanda:

• Condivisione: share-wishlist-by-link crea o aggiorna un link condivisibile per una wishlist. Poiché è idempotente, un agente può riprovarlo in sicurezza dopo una connessione interrotta.
• Analisi prodotto: get-product-insights risponde alla domanda di merchandising. Quali articoli le persone stanno salvando e quali sono di tendenza?
• Analisi categoria: get-category-insights raggruppa l'attività della wishlist per categoria e marchio, in modo da vedere la domanda su un intervallo, non su un singolo SKU.
• Tendenze: get-time-based-trends copre le aggiunte nel tempo e i modelli del giorno della settimana. Questa è la differenza tra sapere che un prodotto è popolare e sapere quando le persone decidono che lo vogliono.

Inoltre, Pro mostra questi report nelle sue schermate di analisi della wishlist. Le capacità sono un percorso aggiuntivo agli stessi dati, non l'unico.

Quale piano ti serve

Ecco quale prodotto fa cosa. SaveTo Wishlist Lite è il plugin gratuito e rimane gratuito. SaveTo Wishlist Pro è il plugin a pagamento che registra le capacità ed è incluso in tutti e tre i piani tariffari.

Growth costa $49,50 per il primo anno e si rinnova a $99. Plus costa $99,50 per il primo anno e si rinnova a $199. Business costa $199,50 per il primo anno e si rinnova a $399. The Gift Registry Addon è incluso solo con Plus e Business, non con Growth.

---

Tutte le 15 funzionalità e cosa può cambiare ciascuna

Nove delle 15 capacità leggono soltanto. Le altre sei cambiano qualcosa e due di esse possono inviare email. Ecco l'insieme completo:

Capacità	Cosa fa	Modifica dati?
condividi la wishlist tramite link	Crea o aggiorna un link condivisibile per una wishlist. Non vengono inviate email.	Sì, è sicuro riprovare
condividi la wishlist via email	Invia una wishlist a un elenco di indirizzi, con un messaggio opzionale.	Sì
elenco wishlist condivise	Elenca le wishlist condivise e i loro destinatari.	No
elenco automazioni	Elenca le tue automazioni, filtrate per stato, trigger o azione, se lo chiedi.	No
ottieni automazione	Restituisce la configurazione completa di un'automazione.	No
crea automazione	Crea una nuova automazione da un trigger e un'azione.	Sì
aggiorna automazione	Modifica un'automazione esistente.	Sì, è sicuro riprovare
attiva/disattiva automazione	Attiva o disattiva un'automazione. Senza uno stato specificato, inverte quello corrente.	Sì, è sicuro riprovare
elenco clienti wishlist	Elenca i clienti con wishlist attive, i più attivi per primi.	No
ottieni riepilogo wishlist cliente	Riassume le wishlist, gli articoli, il valore e l'ultima attività di un cliente.	No
invia notifica manuale	Esegue ora l'azione di un'automazione per un cliente.	Sì
ottieni approfondimenti generali	Numeri principali, inclusi tasso di conversione e trend rispetto al periodo precedente.	No
ottieni approfondimenti sui prodotti	Prodotti più popolari, di tendenza e aggiunti di recente.	No
ottieni approfondimenti sulle categorie	Attività della wishlist raggruppata per categoria e marchio.	No
ottieni tendenze basate sul tempo	Aggiunte nel tempo e schemi giornalieri.	No

Dettagli che cambiano ciò che dovresti chiedere

Alcuni dettagli in quella tabella modellano ciò che dovresti chiedere a un agente:

• Le letture possono ancora restituire dati personali. list-wishlist-customers e get-customer-wishlist-summary restituiscono nomi, email e spesa totale dei clienti. Le configurazioni di automazione possono includere intestazioni di autenticazione webhook. Tratta l'account connesso come qualsiasi accesso dello staff.
• I trend dei prodotti guardano indietro di 7 giorni a meno che tu non chieda 30. get-product-insights accetta solo questi due periodi. get-time-based-trends utilizza per impostazione predefinita 30 giorni e accetta anche 7, 90 o 365. Chiedi qualsiasi altra cosa e utilizzerà silenziosamente l'impostazione predefinita.
• Alcune risposte sono limitate. Gli insight sui prodotti restituiscono i primi 10 prodotti popolari e 10 di tendenza, più 8 aggiunte recenti. Le liste clienti predefiniscono 15 e le liste condivise 100. Nessuna va oltre 200.
• trigger-manual-notification invia realmente. Esegue l'azione di un'automazione esistente per un cliente: un'email, una chiamata webhook o un aggiornamento dei metadati utente. Le automazioni basate sui prodotti rifiutano di essere eseguite senza un ID prodotto, quindi i segnaposto non compilati non vengono mai inviati.

---

Come connettere un client AI al tuo negozio

La registrazione delle capacità non collega nulla da sola. La connessione avviene tramite il plugin MCP Adapter, con un passaggio aggiuntivo facile da trascurare.

Il server predefinito dell'adattatore elenca solo le capacità contrassegnate come pubbliche e SaveTo Wishlist Pro non contrassegna le sue capacità in quel modo. Di conseguenza, un client puntato al server predefinito non le troverà. Invece, registri un piccolo server tuo, che ti consente anche di scegliere quali capacità offre.

Configuralo passo dopo passo

Ecco la configurazione, dall'inizio alla fine:

1. Installa MCP Adapter. È il plugin WordPress ufficiale e gratuito per MCP, installato dalla sua pagina delle release di GitHub. Richiede WordPress 6.9 o versioni successive.
2. Scegli l'account che l'agente utilizzerà. Ogni capacità controlla la capacità manage_woocommerce, che WooCommerce concede ad Amministratori e Responsabili del negozio. Un utente Responsabile del negozio dedicato mantiene l'attività dell'agente separata dal tuo accesso.
3. Crea una password per le applicazioni per quell'utente. Vai su Utenti, modifica l'utente e scorri fino a Password per le applicazioni. Digita un'etichetta in Nome nuova password per le applicazioni, quindi fai clic su Aggiungi password per le applicazioni. Copiala subito, perché WordPress non la mostrerà più.
4. Registra un server elencando le capacità che desideri. Aggiungi lo snippet qui sotto a un plugin specifico per il sito o a un plugin di snippet di codice.
5. Indirizza il tuo client al server. La maggior parte dei client desktop si connette tramite il proxy @automattic/mcp-wordpress-remote, che richiede l'URL del tuo server, il nome utente e la password per le applicazioni.

add_action( 'mcp_adapter_init', function ( $adapter ) {
    $adapter->create_server(
        'stw-agent',                  // Server ID
        'stw-agent',                  // REST namespace
        'mcp',                        // REST route
        'SaveTo Wishlist Agent',
        'Read-only SaveTo Wishlist abilities',
        '1.0.0',
        array( \WP\MCP\Transport\HttpTransport::class ),
        \WP\MCP\Infrastructure\ErrorHandling\ErrorLogMcpErrorHandler::class,
        null,
        array(
            'saveto-wishlist/get-overview-insights',
            'saveto-wishlist/get-product-insights',
            'saveto-wishlist/get-category-insights',
            'saveto-wishlist/get-time-based-trends',
            'saveto-wishlist/list-wishlist-customers',
            'saveto-wishlist/get-customer-wishlist-summary',
            'saveto-wishlist/list-shared-wishlists',
            'saveto-wishlist/list-automations',
            'saveto-wishlist/get-automation',
        )
    );
} );

Quello snippet espone solo le nove capacità di sola lettura. Per consentire all'agente di agire, aggiungi le capacità di scrittura dalla tabella sopra una alla volta. Con gli ID utilizzati qui, l'endpoint è https://yourstore.com/wp-json/stw-agent/mcp.

Come interrompere l'accesso

Tieni presente che una password per le applicazioni trasporta le piene autorizzazioni del suo utente tramite l'API REST, non solo queste capacità. Fare clic su Revoca accanto ad essa nella stessa schermata interrompe immediatamente l'agente.

Se esegui StoreAgent, ha la sua guida per collegare Claude e ChatGPT al tuo negozio.

Come dire che ha funzionato

Chiedi al client di elencare i suoi strumenti. Ogni capacità appare con la sua barra sostituita da un trattino, come saveto-wishlist-get-overview-insights. Quindi prova una domanda di sola lettura, come qual è l'andamento del tasso di conversione della tua wishlist.

Due risultati indicano correzioni specifiche:

• Nessuno strumento SaveTo Wishlist nell'elenco. Il client è probabilmente ancora puntato al server predefinito, quindi verifica che il suo URL termini con /stw-agent/mcp. Conferma anche che nessuno abbia disattivato la registrazione.
• Un errore di autorizzazione su ogni chiamata. L'utente connesso non dispone di manage_woocommerce. Cambia il client in un account Shop Manager o Administrator.

---

Come attivare o disattivare l'accesso dell'agente

La registrazione delle capacità è attiva per impostazione predefinita e viene fornita con tre interruttori di spegnimento. Due di questi sono a tua disposizione.

1. La funzione è mancante. Se wp_register_ability() non è disponibile sul sito, SaveTo Wishlist Pro salta completamente la registrazione. Nulla genera errori, nulla viene registrato parzialmente e il plugin continua con il suo normale lavoro.

2. Una costante. Impostare STWPRO_DISABLE_ABILITIES su un valore veritiero salta anche la registrazione. Definiscila in un punto che viene caricato prima dei plugin, il che in pratica significa wp-config.php o un plugin must-use:

define( 'STWPRO_DISABLE_ABILITIES', true );

3. Un filtro. Restituire true dal filtro stwpro_disable_abilities ha lo stesso effetto. È adatto a siti che mantengono questo tipo di decisioni all'interno di un plugin specifico per il sito:

add_filter( 'stwpro_disable_abilities', '__return_true' );

Qualsiasi dei tre significa che nessuna capacità è registrata, quindi nessun client può scoprirne o chiamarne una. Non c'è uno stato parziale su cui ragionare, il che si adatta a un interruttore che potresti dover attivare in fretta.

---

Cosa questo non fa ancora

La copertura dell'IA spesso salta i limiti, quindi ecco quelli reali.

• Nessun acquisto autonomo. Nessuna delle 15 abilità consente a un agente di effettuare un ordine, spendere denaro o completare un acquisto per conto di un cliente.
• Nessuna elusione del modello di autorizzazione. Un account che non può gestire WooCommerce non può chiamare queste abilità chiedendo a un assistente di farlo al posto suo.
• Un menu fisso, non accesso libero. Da SaveTo Wishlist, le 15 abilità nominate sono l'elenco completo. Un agente non può inventarne una sedicesima, interrogare tabelle arbitrarie o raggiungere funzionalità che nessuno ha registrato.
• Un client deve comunque connettersi. La registrazione di un'abilità non pubblica nulla sull'internet aperto. Un client deve connettersi tramite un server MCP, con credenziali che superano i controlli di autorizzazione.
• Legge solo ciò che il negozio contiene. I salvataggi di un ospite rimangono nel loro browser finché non effettuano l'accesso o si registrano. A quel punto, gli articoli si spostano nel loro account e diventano dati su cui un'abilità può riferire.

Nel complesso, la maggior parte di queste sono deliberate, non sviste in attesa di una patch. Sono il modello di autorizzazione che fa il suo lavoro, il che è meglio di una funzionalità che concede silenziosamente più di quanto ti aspettassi.

---

Domande frequenti

---

Rendi i dati della tua WooCommerce Wishlist pronti per gli agenti

La parte interessante non è che un assistente possa rispondere a una domanda sul tuo negozio. È che nessuno ha dovuto prima creare un connettore per quello specifico assistente. Invece, uno standard condiviso ha fatto le presentazioni e i dati della tua wishlist erano pronti perché erano già strutturati, autorizzati e denominati.

Ecco cosa fare con questo:

• Familiarizza con l'API delle abilità di WordPress prima di collegare qualsiasi cosa al tuo negozio.
• Controlla il modello di autorizzazione di qualsiasi plugin che colleghi, in particolare se le chiamate automatizzate eseguono lo stesso codice delle schermate di amministrazione.
• Decidi quali informazioni desideri che un agente possa fornire, quindi abbinale alle abilità che le restituiscono.
• Collega un client tramite il tuo server, iniziando con le nove abilità di sola lettura.
• Prendi nota degli interruttori ora, in modo che la decisione sia già presa se ne avrai mai bisogno rapidamente.
• Stabilisci le aspettative con il tuo team riguardo a ciò che un agente non può fare qui.

I salvataggi nella wishlist sono uno dei primi segnali di intenzione che il tuo negozio riceve. Ecco perché vale la pena usarli per il recupero dell'abbandono della navigazione e vale la pena condividerli con un gruppo. Rendere questi dati leggibili dagli agenti AI è un primo passo pratico verso il commercio agentico.