Hoe AI-agenten uw WooCommerce Wishlist-gegevens lezen en ernaar handelen

Veel WooCommerce-winkeleigenaren hebben "AI" horen pitchen als een chatwidget in de hoek van een productpagina. Dus wanneer een klant vraagt wat AI met winkelgegevens kan doen, was het eerlijke antwoord meestal "niet veel."

Dat verandert. WordPress 6.9 heeft de Abilities API aan de kern toegevoegd. Het is een standaard waarmee een plugin benoemde acties kan publiceren die andere software kan ontdekken en aanroepen. SaveTo Wishlist Pro registreert er 15, te beginnen met de release die ondersteuning voor de Abilities API introduceerde.

Deze handleiding behandelt de toegang tot WooCommerce AI agent wishlist data vanuit de winkelier, niet vanuit de ontwikkelaar. Je ziet wat een mogelijkheid is, welke wishlist data een agent kan lezen en wat deze kan wijzigen. Ik behandel ook het machtigingsmodel, hoe je een client verbindt en waar het allemaal tekortschiet.

Spring naar:

---

Wat de WordPress Abilities API werkelijk is

De WordPress Abilities API is een standaardmanier voor een plugin om de benoemde dingen die het kan doen te publiceren. Software buiten WordPress kan die acties dan vinden en uitvoeren zonder aangepaste integratie.

Zie het als een restaurantmenu. Zonder een menu zou elke diner naar de keuken moeten lopen en uitleggen wat hij wilde. Een menu somt de gerechten op en wat erbij komt, en laat de keuken bepalen wie er bediend wordt. Abilities doen dat werk voor je site.

Waar MCP in past

Elke mogelijkheid heeft een naam, een gedefinieerde invoer, een gedefinieerde uitvoer en een machtigingscontrole. Die structuur is belangrijk vanwege een tweede standaard, het Model Context Protocol, meestal afgekort tot MCP. MCP is een gedeeld formaat dat AI-clients gebruiken om beschikbare tools te vinden en aan te roepen.

WordPress spreekt MCP echter niet vanzelf. Een bridge plugin zoals de officiële MCP Adapter zet abilities om in tools die een MCP-client kan weergeven. Onze zusterplugin StoreAgent draait ook een MCP-server, met instellingen voor het doorbladeren van de abilities die je plugins registreren.

De reeks ziet er als volgt uit:

1. De plugin registreert zijn abilities. Dit gebeurt op je site, in code, wanneer de plugin wordt geladen.
2. Een client maakt verbinding via de bridge en vraagt wat er beschikbaar is. Het krijgt een gestructureerde lijst met benoemde acties terug, geen muur van documentatie.
3. Je stelt een vraag in normale taal. Iets als "welke producten worden deze maand het meest opgeslagen?"
4. De client kiest een passende ability en roept deze aan. Het antwoord komt terug uit je live winkelgegevens.

Er is geen export, geen spreadsheet en geen aangepaste connector voor elke AI-tool. Je winkel publiceert het menu eenmalig, en elke client die MCP spreekt, kan het bestellen zodra je het verbindt.

---

Hoe een mogelijkheid er in de praktijk uitziet

Een ability is één benoemde actie met een vaste invoer, een vaste uitvoer en een machtigingscontrole die eerst wordt uitgevoerd. Het is bewust klein, zodat één ability één taak op dezelfde manier uitvoert, elke keer weer.

SaveTo Wishlist Pro registreert zijn abilities onder de prefix saveto-wishlist/, binnen één ability-categorie genaamd saveto-wishlist. Hierdoor vertelt elke ability-naam je uit welke plugin deze afkomstig is.

Andere Rymera-plugins gebruiken dezelfde API. Advanced Coupons laat je bijvoorbeeld toe om WooCommerce-coupons te beheren met AI.

Gebruik get-product-insights. Het is alleen-lezen, dus aanroepen ervan verandert niets. Vraag bijvoorbeeld een assistent welke producten klanten het meest opslaan, en het retourneert je meest populaire, trending en recent toegevoegde producten. Een vervolgvraag over categorieën gaat naar get-category-insights, dat winkelwagenactiviteit groepeert per categorie en merk.

Gebruik nu share-wishlist-by-link. Het schrijft, dus het is gemarkeerd als destructief. Het is ook gemarkeerd als idempotent, dus het is veilig om opnieuw te proberen. Met andere woorden, het tweemaal aanroepen met dezelfde invoer resulteert in dezelfde staat.

Als je zelf code schrijft tegen de winkel, is de REST API nog steeds het juiste hulpmiddel. De wishlist REST API ontwikkelaarsgids behandelt die endpoints. Dat gezegd hebbende, de twee zijn gemakkelijk te vervagen. REST-endpoints zijn geschikt voor software die je bouwt en controleert, terwijl mogelijkheden geschikt zijn voor software die je niet hebt gebouwd, zoals een AI-client.

---

Het permissiemodel en wat een agent mag doen

Elke mogelijkheid voert een permissie-callback uit voordat het iets doet, en die controle is de kern van het veiligheidsverhaal. Kortom, een AI-client die beleefd vraagt, vergroot niet wat een gebruiker mag doen.

SaveTo Wishlist Pro gebruikt twee callbacks, maar ze stellen dezelfde norm:

• Destructieve mogelijkheden: alles wat gegevens schrijft of wijzigt, wordt uitgevoerd achter een can_manage_woocommerce callback. Dat is het terrein van de winkelmanager, niet van de algemene bezoeker.
• Alleen-lezen mogelijkheden: deze gebruiken een aparte can_view_data callback, maar deze controleert dezelfde manage_woocommerce-capaciteit. Lezen vereist dezelfde account als schrijven.

Elke mogelijkheid draagt ook MCP-annotaties die zijn opgebouwd uit zijn destructieve en idempotente vlaggen. Die annotaties vertellen een client, voordat deze iets aanroept, of een hulpmiddel gegevens wijzigt en of een herhaling veilig is.

Nog een ontwerpbeslissing is belangrijker dan al het bovenstaande. Elke destructieve mogelijkheid delegeert naar dezelfde service-laag die de admin-schermen gebruiken, zonder een apart AI-only code-pad. Dus wanneer een agent een verlanglijst e-mailt, worden dezelfde WordPress- en WooCommerce-acties geactiveerd als wanneer jij het doet. Dezelfde e-mails worden verzonden en dezelfde hooks worden uitgevoerd.

Dat kan klinken als een droge architecturale voetnoot. In de praktijk betekent het dat een agent geen omweg heeft rond je logging, je integraties, of je klantmeldingen. Dat is wat de functie iets maakt dat je kunt auditen.

❗️🔍️ Wat te controleren: sommige tools voegen een apart code-pad toe voor geautomatiseerde toegang. Gebeurtenissen die plaatsvinden bij een menselijke klik, worden dan mogelijk nooit geactiveerd bij een geautomatiseerde. Wanneer dat gebeurt, kan een CRM stoppen met het ontvangen van records zonder dat iemand het merkt. Wat je ook verbindt, vraag of het geautomatiseerde pad dezelfde code uitvoert als de admin-schermen.

---

Wat SaveTo Wishlist Pro blootstelt aan AI-agenten

SaveTo Wishlist Pro registreert één mogelijkheidscategorie en 15 mogelijkheden onder het saveto-wishlist/-voorvoegsel. Ze kwamen aan in Pro-versie 1.0.2, uitgebracht op 30 juni 2026.

Deze functionaliteiten rapporteren over gegevens die uw klanten dagelijks aanmaken. Een shopper klikt bijvoorbeeld op de verlanglijstknop en die klik wordt een record dat een inzichtfunctionaliteit later kan tellen. In de gratis SaveTo Wishlist Lite plugin toont de knop standaard op winkelpagina's. Zodra een product is opgeslagen, verandert het label in “Verwijderen van verlanglijst”.

Vier functionaliteiten om mee te beginnen

Hier zijn vier die u waarschijnlijk eerst zult gebruiken:

Functionaliteitengroep	Voorbeeldfunctionaliteit	Wijzigt gegevens?
Delen	Verlanglijst delen via link	Ja, veilig om opnieuw te proberen
Productinzicht	Productinzichten ophalen	Nee
Categorie-inzicht	Categorie-inzichten ophalen	Nee
Trends	Tijdgebonden trends ophalen	Nee

De volledige lijst van 15 volgt na deze sectie. Elk van deze vier beantwoordt een ander soort vraag:

• Delen: share-wishlist-by-link maakt of vernieuwt een deelbare link voor een verlanglijst. Omdat het idempotent is, kan een agent het veilig opnieuw proberen na een verbroken verbinding.
• Productinzicht: get-product-insights beantwoordt de vraag over merchandising. Welke items slaan mensen op en welke zijn trending?
• Categorie-inzicht: get-category-insights groepeert verlanglijstactiviteit per categorie en merk, zodat u de vraag over een reeks ziet, niet één SKU.
• Trends: get-time-based-trends behandelt toevoegingen in de tijd en patronen van de dag van de week. Dat is het verschil tussen weten dat een product populair is en weten wanneer mensen besluiten dat ze het willen.

Bovendien toont Pro deze rapportage in zijn verlanglijstanalyseschermen. De functionaliteiten zijn een extra route naar dezelfde gegevens, niet de enige.

Welk plan u nodig heeft

Hier is welk product wat doet. SaveTo Wishlist Lite is de gratis plugin en blijft gratis. SaveTo Wishlist Pro is de betaalde plugin die de functionaliteiten registreert, en deze is inbegrepen in alle drie de prijsplannen.

Growth is €49,50 voor het eerste jaar en wordt verlengd voor €99. Plus is €99,50 voor het eerste jaar en wordt verlengd voor €199. Business is €199,50 voor het eerste jaar en wordt verlengd voor €399. De Cadeau-register Addon wordt alleen meegeleverd met Plus en Business, niet met Growth.

---

Alle 15 mogelijkheden en wat elk ervan kan veranderen

Negen van de 15 functionaliteiten lezen alleen. De andere zes veranderen iets, en twee daarvan kunnen e-mail verzenden. Hier is de volledige set:

Mogelijkheid	Wat het doet	Wijzigt gegevens?
Verlanglijst delen via link	Maakt of vernieuwt een deelbare link voor één verlanglijst. Er worden geen e-mails verzonden.	Ja, veilig om opnieuw te proberen
Verlanglijst delen via e-mail	Verzendt een verlanglijst naar een lijst met adressen, met een optioneel bericht.	Ja
Gedeelde verlanglijsten weergeven	Lijst gedeelde verlanglijsten en hun ontvangers op.	Nee
Automatiseringen weergeven	Lijst uw automatiseringen op, gefilterd op status, trigger of actie indien gevraagd.	Nee
Automatisering ophalen	Geeft de volledige configuratie van één automatisering terug.	Nee
Automatisering aanmaken	Maakt een nieuwe automatisering aan op basis van een trigger en een actie.	Ja
Automatisering bijwerken	Wijzigt een bestaande automatisering.	Ja, veilig om opnieuw te proberen
Automatisering in-/uitschakelen	Schakelt een automatisering in of uit. Zonder opgegeven status wordt de huidige status omgedraaid.	Ja, veilig om opnieuw te proberen
Klanten van verlanglijsten weergeven	Toont klanten met actieve verlanglijsten, de meest actieve eerst.	Nee
Samenvatting verlanglijst klant ophalen	Vat de verlanglijsten, items, waarde en laatste activiteit van één klant samen.	Nee
Handmatige melding activeren	Voert de actie van een automatisering voor één klant uit, nu meteen.	Ja
Overzicht inzichten ophalen	Koptekstcijfers, inclusief conversieratio en de trend ten opzichte van de vorige periode.	Nee
Productinzichten ophalen	Meest populaire, trending en recent toegevoegde producten.	Nee
Categorie-inzichten ophalen	Verlanglijstactiviteit gegroepeerd per categorie en merk.	Nee
Tijdgebonden trends ophalen	Toevoegingen in de tijd en patronen per dag van de week.	Nee

Details die veranderen wat je moet vragen

Een paar details in die tabel bepalen wat je een agent moet vragen:

• Lezingen kunnen nog steeds persoonlijke gegevens retourneren. list-wishlist-customers en get-customer-wishlist-summary retourneren klantnamen, e-mails en totale uitgaven. Automatisatieconfiguraties kunnen webhook-autorisatieheaders bevatten. Behandel het verbonden account als elke personeelslogin.
• Producttrends kijken 7 dagen terug, tenzij je om 30 vraagt. get-product-insights accepteert alleen die twee periodes. get-time-based-trends gebruikt standaard 30 dagen en accepteert ook 7, 90 of 365. Vraag om iets anders en het gebruikt stilletjes de standaard.
• Sommige antwoorden zijn beperkt. Productinzichten retourneren de top 10 populaire en 10 trending producten, plus 8 recente toevoegingen. Klantlijsten standaard op 15 en gedeelde lijsten op 100. Geen van beide gaat verder dan 200.
• trigger-manual-notification verzendt echt. Het voert de actie van een bestaande automatisering uit voor één klant: een e-mail, een webhook-aanroep of een update van gebruikersmeta. Productgebaseerde automatiseringen weigeren te draaien zonder product-ID, dus oningevulde placeholders worden nooit verzonden.

---

Hoe u een AI-client verbindt met uw winkel

Het registreren van mogelijkheden verbindt op zichzelf niets. De verbinding loopt via de MCP Adapter-plugin, met één extra stap die gemakkelijk te missen is.

De standaardserver van de adapter toont alleen mogelijkheden die als openbaar zijn gemarkeerd, en SaveTo Wishlist Pro markeert zijn mogelijkheden niet op die manier. Hierdoor zal een client die op de standaardserver is gericht ze niet vinden. In plaats daarvan registreer je een eigen kleine server, waarmee je ook kunt kiezen welke mogelijkheden deze aanbiedt.

Stel het stap voor stap in

Hier is de installatie, van begin tot eind:

1. Installeer MCP Adapter. Het is de officiële, gratis WordPress-plugin voor MCP, geïnstalleerd vanaf de GitHub-releasespagina. Het vereist WordPress 6.9 of hoger.
2. Kies het account dat de agent zal gebruiken. Elke mogelijkheid controleert op de manage_woocommerce-mogelijkheid, die WooCommerce beheerders en winkelmanagers geeft. Een toegewijde winkelmanager-gebruiker houdt de activiteit van de agent gescheiden van je eigen login.
3. Maak een toepassingswachtwoord aan voor die gebruiker. Ga naar Gebruikers, bewerk de gebruiker en scrol naar Toepassingswachtwoorden. Typ een label in Naam nieuw toepassingswachtwoord en klik vervolgens op Toepassingswachtwoord toevoegen. Kopieer het meteen, want WordPress zal het niet opnieuw laten zien.
4. Registreer een server die de gewenste mogelijkheden vermeldt. Voeg het onderstaande codefragment toe aan een site-specifieke plugin of een plugin voor codefragmenten.
5. Wijs uw client naar de server. De meeste desktopclients maken verbinding via de @automattic/mcp-wordpress-remote proxy, die uw server-URL, gebruikersnaam en toepassingswachtwoord gebruikt.

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',
        )
    );
} );

Dat codefragment toont alleen de negen alleen-lezen mogelijkheden. Om de agent te laten handelen, voegt u schrijf-mogelijkheden toe uit de bovenstaande tabel één voor één. Met de hier gebruikte ID's is het eindpunt https://yourstore.com/wp-json/stw-agent/mcp.

Hoe toegang te blokkeren

Houd er rekening mee dat een toepassingswachtwoord de volledige machtigingen van de gebruiker heeft voor de REST API, niet alleen deze mogelijkheden. Door op Intrekken ernaast op hetzelfde scherm te klikken, wordt de agent onmiddellijk geblokkeerd.

Als u StoreAgent uitvoert, heeft deze zijn eigen handleiding voor het verbinden van Claude en ChatGPT met uw winkel.

Hoe u kunt zien dat het werkte

Vraag de client om zijn tools weer te geven. Elke mogelijkheid verschijnt met zijn schuine streep vervangen door een koppelteken, zoals saveto-wishlist-get-overview-insights. Probeer vervolgens een vraag alleen-lezen, zoals hoe uw conversieratio van de verlanglijst presteert.

Twee resultaten wijzen op specifieke oplossingen:

• Geen SaveTo Wishlist tools in de lijst. De client is waarschijnlijk nog steeds gericht op de standaardserver, dus controleer of de URL eindigt op /stw-agent/mcp. Bevestig ook dat niemand de registratie heeft uitgeschakeld.
• Een permissiefout bij elke aanroep. De verbonden gebruiker mist manage_woocommerce. Schakel de client over naar een account van Winkelbeheerder of Administrator.

---

Hoe u agenttoegang in- of uitschakelt

Mogelijkheidsregistratie is standaard ingeschakeld en wordt geleverd met drie uitschakelaars. Twee daarvan zijn aan u om te gebruiken.

1. De functie ontbreekt. Als wp_register_ability() niet beschikbaar is op de site, slaat SaveTo Wishlist Pro de registratie volledig over. Niets geeft een foutmelding, niets wordt gedeeltelijk geregistreerd en de plugin gaat door met zijn normale werk.

2. Een constante. Het instellen van STWPRO_DISABLE_ABILITIES op een waarheidswaarde slaat ook de registratie over. Definieer het ergens dat laadt vóór plugins, wat in de praktijk betekent wp-config.php of een must-use plugin:

define( 'STWPRO_DISABLE_ABILITIES', true );

3. Een filter. Het retourneren van true van het stwpro_disable_abilities filter heeft hetzelfde effect. Het is geschikt voor sites die dit soort beslissingen binnen een site-specifieke plugin bewaren:

add_filter( 'stwpro_disable_abilities', '__return_true' );

Elk van de drie betekent dat er geen mogelijkheid is geregistreerd, dus geen enkele client kan deze ontdekken of aanroepen. Er is geen gedeeltelijke status om over na te denken, wat geschikt is voor een schakelaar die u mogelijk haastig moet omzetten.

---

Wat dit nog niet doet

AI-dekking slaat vaak de limieten over, dus hier zijn de echte limieten.

• Geen autonome aankopen. Geen van de 15 functionaliteiten laat een agent een bestelling plaatsen, geld uitgeven of afrekenen namens een shopper.
• Geen omzeiling van het machtigingsmodel. Een account dat WooCommerce niet kan beheren, kan deze functionaliteiten niet aanroepen door een assistent te vragen het in plaats daarvan te doen.
• Een vast menu, geen open toegang. Van SaveTo Wishlist zijn de 15 benoemde functionaliteiten de volledige lijst. Een agent kan geen zestiende bedenken, willekeurige tabellen bevragen of functies bereiken die niemand heeft geregistreerd.
• Een client moet nog steeds verbinding maken. Het registreren van een functionaliteit publiceert niets naar het open internet. Een client moet verbinding maken via een MCP-server, met inloggegevens die de machtigingscontroles doorstaan.
• Het leest alleen wat de winkel bevat. De opgeslagen items van een gast blijven in hun browser totdat ze inloggen of zich registreren. Op dat punt verplaatsen de items zich naar hun account en worden ze gegevens waarop een functionaliteit kan worden gerapporteerd.

Over het algemeen zijn de meeste hiervan opzettelijk, geen nalatigheden die wachten op een patch. Het is het machtigingsmodel dat zijn werk doet, wat beter is dan een functie die stilletjes meer toekent dan je verwacht.

---

Veelgestelde Vragen

---

Maak uw WooCommerce Wishlist-gegevens klaar voor agenten

Het interessante is niet dat een assistent een vraag over je winkel kan beantwoorden. Het is dat niemand eerst een connector hoefde te bouwen voor die specifieke assistent. In plaats daarvan deed een gedeelde standaard de introducties, en je verlanglijstgegevens waren klaar omdat ze al gestructureerd, geautoriseerd en benoemd waren.

Dit is wat je ermee kunt doen:

• Maak kennis met de WordPress Abilities API voordat je iets met je winkel verbindt.
• Controleer het toestemmingsmodel van elke plugin die je verbindt, vooral of geautomatiseerde aanroepen dezelfde code uitvoeren als beheerdersschermen.
• Bepaal welke inzichten je een agent wilt laten beantwoorden, en koppel ze vervolgens aan de abilities die ze retourneren.
• Verbind een client via je eigen server, beginnend met de negen read-only abilities.
• Noteer nu de uitschakelaars, zodat de beslissing al genomen is als je deze snel nodig hebt.
• Stel verwachtingen in bij je team over wat een agent hier niet kan doen.

Verlanglijstbesparingen zijn een van de vroegste intentiesignalen die je winkel ontvangt. Daarom zijn ze de moeite waard om te gebruiken voor herstel van winkelwagenverlating en de moeite waard om met een groep te delen. Het leesbaar maken van die gegevens voor AI-agenten is een praktische eerste stap naar agentic commerce.