Comment les agents IA lisent et agissent sur vos données WooCommerce Wishlist

De nombreux propriétaires de magasins WooCommerce ont entendu parler de l'IA présentée comme un widget de chat dans le coin d'une page produit. Ainsi, lorsqu'un client demande ce que l'IA peut faire avec les données du magasin, la réponse honnête a généralement été « pas grand-chose ».

Cela change. WordPress 6.9 a ajouté l'API des capacités au cœur du système. C'est une norme qui permet à un plugin de publier des actions nommées que d'autres logiciels peuvent découvrir et appeler. SaveTo Wishlist Pro en enregistre 15, à commencer par la version qui a introduit la prise en charge de l'API des capacités.

Ce guide couvre l'accès aux données de liste de souhaits de l'agent WooCommerce AI du côté du propriétaire de la boutique, pas du développeur. Vous verrez ce qu'est une capacité, quelles données de liste de souhaits un agent peut lire et ce qu'il peut modifier. Je couvrirai également le modèle d'autorisation, comment connecter un client et où cela s'arrête.

Aller à :

---

Ce qu'est réellement l'API des capacités WordPress

L'API Abilities de WordPress est un moyen standard pour un plugin de publier les éléments nommés qu'il peut faire. Les logiciels externes à WordPress peuvent alors trouver ces actions et les exécuter sans intégration personnalisée.

Considérez cela comme un menu de restaurant. Sans lui, chaque client devrait entrer dans la cuisine et expliquer ce qu'il voulait. Un menu liste les plats et ce qui les accompagne, et laisse la cuisine en charge de qui est servi. Les capacités font ce travail pour votre site.

Où MCP intervient

Chaque capacité a un nom, une entrée définie, une sortie définie et une vérification d'autorisation. Cette structure est importante en raison d'un deuxième standard, le Model Context Protocol, généralement abrégé en MCP. MCP est un format partagé que les clients IA utilisent pour trouver les outils disponibles et les appeler.

Cependant, WordPress ne parle pas MCP par lui-même. Un plugin passerelle tel que l'adaptateur MCP officiel transforme les capacités en outils qu'un client MCP peut lister. Notre plugin sœur StoreAgent exécute également un serveur MCP, avec des paramètres pour parcourir les capacités que vos plugins enregistrent.

La séquence ressemble à ceci :

1. Le plugin enregistre ses capacités. Cela se produit sur votre site, dans le code, lorsque le plugin se charge.
2. Un client se connecte via la passerelle et demande ce qui est disponible. Il reçoit une liste structurée d'actions nommées, pas un mur de documentation.
3. Vous posez une question en langage naturel. Quelque chose comme « quels produits les gens sauvegardent-ils le plus ce mois-ci ? »
4. Le client choisit une capacité correspondante et l'appelle. La réponse provient des données de votre boutique en direct.

Il n'y a pas d'exportation, pas de feuille de calcul, et pas de connecteur personnalisé pour chaque outil IA. Votre boutique publie le menu une fois, et tout client qui parle MCP peut le commander une fois que vous l'avez connecté.

---

À quoi ressemble une capacité en pratique

Une capacité est une action nommée avec une entrée fixe, une sortie fixe et une vérification d'autorisation qui s'exécute en premier. Elle est délibérément petite, de sorte qu'une capacité fait un travail de la même manière à chaque fois.

SaveTo Wishlist Pro enregistre ses capacités sous le préfixe saveto-wishlist/, dans une catégorie de capacités appelée saveto-wishlist. Par conséquent, chaque nom de capacité vous indique de quel plugin il provient.

D'autres plugins Rymera utilisent la même API. Advanced Coupons, par exemple, vous permet de gérer les coupons WooCommerce avec l'IA.

Prenez get-product-insights. Il est en lecture seule, donc son appel ne change rien. Par exemple, demandez à un assistant quels produits les clients enregistrent le plus, et il vous retournera vos produits les plus populaires, tendance et récemment ajoutés. Une question de suivi sur les catégories mènera à get-category-insights, qui regroupe l'activité de la liste de souhaits par catégorie et par marque.

Maintenant, prenez share-wishlist-by-link. Il écrit, donc il est marqué comme destructeur. Il est également marqué comme idempotent, il est donc sûr de réessayer. En d'autres termes, l'appeler deux fois avec la même entrée aboutit au même état.

Si vous écrivez vous-même du code pour la boutique, l'API REST est toujours le bon outil. Le guide du développeur de l'API REST de la liste de souhaits couvre ces points d'accès. Cela dit, les deux sont faciles à confondre. Les points d'accès REST conviennent aux logiciels que vous construisez et contrôlez, tandis que les capacités conviennent aux logiciels que vous n'avez pas construits, comme un client IA.

---

Le modèle d'autorisation et ce qu'un agent est autorisé à faire

Chaque capacité exécute un rappel de permission avant de faire quoi que ce soit, et cette vérification est au cœur de l'histoire de la sécurité. En bref, un client IA qui demande poliment n'élargit pas ce qu'un utilisateur est autorisé à faire.

SaveTo Wishlist Pro utilise deux rappels, mais ils fixent la même barre :

• Capacités destructrices : tout ce qui écrit ou modifie des données s'exécute derrière un rappel can_manage_woocommerce. C'est le territoire du gestionnaire de boutique, pas celui du visiteur général.
• Capacités de lecture seule : celles-ci utilisent un rappel can_view_data distinct, mais il vérifie la même capacité manage_woocommerce. La lecture nécessite le même compte que l'écriture.

Chaque capacité porte également des annotations MCP construites à partir de ses indicateurs destructeurs et idempotents. Ces annotations indiquent à un client, avant qu'il n'appelle quoi que ce soit, si un outil modifie des données et si une nouvelle tentative est sûre.

Une autre décision de conception est plus importante que tout ce qui précède. Chaque capacité destructrice passe à la même couche de service que celle utilisée par les écrans d'administration, sans chemin de code distinct réservé à l'IA. Ainsi, lorsqu'un agent envoie une liste de souhaits par e-mail, les mêmes actions WordPress et WooCommerce se déclenchent que lorsque vous le faites. Les mêmes e-mails sont envoyés et les mêmes hooks s'exécutent.

Cela peut ressembler à une note de bas de page architecturale sèche. En pratique, cela signifie qu'un agent n'a pas de raccourci pour contourner votre journalisation, vos intégrations ou vos notifications client. C'est ce qui rend la fonctionnalité auditable.

❗️🔍️ Ce qu'il faut vérifier : certains outils ajoutent un chemin de code distinct pour l'accès automatisé. Les événements qui se déclenchent lors d'un clic humain peuvent alors ne jamais se déclencher lors d'un clic automatisé. Lorsque cela se produit, un CRM peut cesser de recevoir des enregistrements sans que personne ne s'en aperçoive. Quoi que vous connectiez, demandez si son chemin automatisé exécute le même code que ses écrans d'administration.

---

Ce que SaveTo Wishlist Pro expose aux agents IA

SaveTo Wishlist Pro enregistre une catégorie de capacités et 15 capacités sous le préfixe saveto-wishlist/. Elles sont arrivées dans la version Pro 1.0.2, publiée le 30 juin 2026.

Ces capacités rendent compte des données que vos clients créent chaque jour. Par exemple, un acheteur clique sur le bouton de la liste de souhaits, et ce clic devient un enregistrement qu'une capacité d'analyse peut compter plus tard. Dans le plugin gratuit SaveTo Wishlist Lite, le bouton s'affiche sur les pages de la boutique dès l'installation. Une fois qu'un produit est enregistré, son libellé passe à « Supprimer de la liste de souhaits ».

Quatre capacités pour commencer

Voici quatre capacités que vous utiliserez probablement en premier :

Groupe de capacités	Capacité d'exemple	Modifie les données ?
Partage	Partager la liste par lien	Oui, sans risque de réessayer
Analyse de produit	Obtenir les aperçus des produits	Non
Analyse de catégorie	Obtenir les aperçus des catégories	Non
Tendances	Obtenir les tendances temporelles	Non

La liste complète de 15 suit cette section. Chacune de ces quatre capacités répond à un type de question différent :

• Partage : share-wishlist-by-link crée ou actualise un lien partageable pour une liste de souhaits. Comme elle est idempotente, un agent peut la réessayer en toute sécurité après une connexion interrompue.
• Analyse de produit : get-product-insights répond à la question de la marchandisation. Quels articles les gens enregistrent-ils et lesquels sont en vogue ?
• Analyse de catégorie : get-category-insights regroupe l'activité de la liste de souhaits par catégorie et par marque, vous permettant de voir la demande sur une gamme, pas sur un seul SKU.
• Tendances : get-time-based-trends couvre les ajouts au fil du temps et les modèles de jour de la semaine. C'est la différence entre savoir qu'un produit est populaire et savoir quand les gens décident qu'ils le veulent.

De plus, Pro affiche ce reporting dans ses écrans d'analyses de liste de souhaits. Les capacités sont une voie supplémentaire vers les mêmes données, pas la seule.

Quel plan vous faut-il

Voici quel produit fait quoi. SaveTo Wishlist Lite est le plugin gratuit, et il reste gratuit. SaveTo Wishlist Pro est le plugin payant qui enregistre les capacités, et il est inclus dans les trois plans tarifaires.

Growth est à 49,50 $ pour la première année et se renouvelle à 99 $. Plus est à 99,50 $ pour la première année et se renouvelle à 199 $. Business est à 199,50 $ pour la première année et se renouvelle à 399 $. Le module complémentaire de liste de cadeaux est inclus avec Plus et Business uniquement, pas avec Growth.

---

Les 15 capacités et ce que chacune peut changer

Neuf des 15 capacités ne font que lire. Les six autres modifient quelque chose, et deux d'entre elles peuvent envoyer des e-mails. Voici l'ensemble complet :

Capacité	Ce qu'il fait	Modifie les données ?
Partager la liste par lien	Crée ou actualise un lien partageable pour une liste de souhaits. Aucun e-mail n'est envoyé.	Oui, sans risque de réessayer
Partager la liste par e-mail	Envoie par e-mail une liste de souhaits à une liste d'adresses, avec un message facultatif.	Oui
Lister les listes partagées	Liste les listes de souhaits partagées et leurs destinataires.	Non
Lister les automatisations	Liste vos automatisations, filtrées par statut, déclencheur ou action si vous le demandez.	Non
Obtenir une automatisation	Retourne la configuration complète d'une automatisation.	Non
Créer une automatisation	Crée une nouvelle automatisation à partir d'un déclencheur et d'une action.	Oui
Mettre à jour une automatisation	Modifie une automatisation existante.	Oui, sans risque de réessayer
Activer/désactiver une automatisation	Active ou désactive une automatisation. Sans statut spécifié, elle inverse l'état actuel.	Oui, sans risque de réessayer
Lister les clients de la liste	Liste les clients ayant des listes de souhaits actives, les plus actives en premier.	Non
Obtenir le résumé de la liste du client	Résume les listes de souhaits, les articles, la valeur et la dernière activité d'un client.	Non
Déclencher une notification manuelle	Exécute l'action d'une automatisation pour un client, immédiatement.	Oui
Obtenir les aperçus généraux	Chiffres clés, y compris le taux de conversion et la tendance par rapport à la période précédente.	Non
Obtenir les aperçus des produits	Produits les plus populaires, tendances et récemment ajoutés.	Non
Obtenir les aperçus des catégories	Activité de la liste de souhaits regroupée par catégorie et par marque.	Non
Obtenir les tendances temporelles	Ajouts au fil du temps et modèles de jours de la semaine.	Non

Détails qui changent ce que vous devriez demander

Quelques détails dans ce tableau façonnent ce que vous devriez demander à un agent :

• Les lectures peuvent toujours retourner des données personnelles. list-wishlist-customers et get-customer-wishlist-summary retournent les noms des clients, les e-mails et le total des dépenses. Les configurations d'automatisation peuvent inclure des en-têtes d'authentification webhook. Traitez le compte connecté comme n'importe quelle connexion de personnel.
• Les tendances des produits remontent à 7 jours, sauf si vous demandez 30. get-product-insights n'accepte que ces deux périodes. get-time-based-trends utilise par défaut 30 jours et accepte également 7, 90 ou 365. Demandez autre chose et il utilise silencieusement la valeur par défaut.
• Certaines réponses sont limitées. Les insights produits retournent les 10 produits les plus populaires et les 10 produits tendances, plus 8 ajouts récents. Les listes de clients par défaut sont de 15 et les listes partagées de 100. Aucune ne dépasse 200.
• trigger-manual-notification envoie pour de vrai. Il exécute l'action d'une automatisation existante pour un client : un e-mail, un appel webhook ou une mise à jour des métadonnées utilisateur. Les automatisations basées sur les produits refusent de s'exécuter sans ID de produit, donc les espaces réservés non remplis ne sont jamais envoyés.

---

Comment connecter un client IA à votre magasin

L'enregistrement des capacités ne connecte rien par lui-même. La connexion s'effectue via le plugin MCP Adapter, avec une étape supplémentaire facile à manquer.

Le serveur par défaut de l'adaptateur ne liste que les capacités marquées comme publiques, et SaveTo Wishlist Pro ne marque pas ses capacités de cette façon. Par conséquent, un client pointé vers le serveur par défaut ne les trouvera pas. Au lieu de cela, vous enregistrez un petit serveur de votre propre chef, ce qui vous permet également de choisir les capacités qu'il offre.

Configurez-le étape par étape

Voici la configuration, du début à la fin :

1. Installer MCP Adapter. C'est le plugin WordPress officiel et gratuit pour MCP, installé depuis sa page de versions GitHub. Il nécessite WordPress 6.9 ou une version ultérieure.
2. Choisissez le compte que l'agent utilisera. Chaque capacité vérifie la capacité manage_woocommerce, que WooCommerce donne aux Administrateurs et aux Gestionnaires de boutique. Un utilisateur dédié de Gestionnaire de boutique permet de séparer l'activité de l'agent de votre propre connexion.
3. Créez un mot de passe d’application pour cet utilisateur. Allez dans Utilisateurs, modifiez l’utilisateur, et faites défiler jusqu’à Mots de passe d’application. Tapez une étiquette dans Nom du nouveau mot de passe d’application, puis cliquez sur Ajouter un mot de passe d’application. Copiez-le immédiatement, car WordPress ne le montrera plus.
4. Enregistrez une liste de serveurs avec les capacités souhaitées. Ajoutez l’extrait ci-dessous à un plugin spécifique au site ou à un plugin d’extraits de code.
5. Pointez votre client vers le serveur. La plupart des clients de bureau se connectent via le proxy @automattic/mcp-wordpress-remote, qui prend l’URL de votre serveur, votre nom d’utilisateur et votre mot de passe d’application.

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

Cet extrait n’expose que les neuf capacités de lecture seule. Pour permettre à l’agent d’agir, ajoutez les capacités d’écriture du tableau ci-dessus une par une. Avec les identifiants utilisés ici, le point de terminaison est https://votremagasin.com/wp-json/stw-agent/mcp.

Comment couper l’accès

Gardez à l’esprit qu’un mot de passe d’application porte les permissions complètes de son utilisateur sur l’API REST, pas seulement ces capacités. Cliquer sur Révoquer à côté sur le même écran coupe immédiatement l’accès à l’agent.

Si vous exécutez StoreAgent, il a son propre guide pour connecter Claude et ChatGPT à votre magasin.

Comment savoir si cela a fonctionné

Demandez au client de lister ses outils. Chaque capacité apparaît avec sa barre oblique remplacée par un trait d’union, comme saveto-wishlist-get-overview-insights. Essayez ensuite une question en lecture seule, comme l’évolution de votre taux de conversion de liste de souhaits.

Deux résultats indiquent des corrections spécifiques :

• Aucun outil SaveTo Wishlist dans la liste. Le client pointe probablement toujours vers le serveur par défaut, vérifiez donc que son URL se termine par /stw-agent/mcp. Confirmez également que personne n’a désactivé l’enregistrement.
• Une erreur de permission sur chaque appel. L’utilisateur connecté n’a pas les droits manage_woocommerce. Basculez le client vers un compte de Gérant de boutique ou d’Administrateur.

---

Comment activer ou désactiver l'accès des agents

L’enregistrement des capacités est activé par défaut et il est livré avec trois interrupteurs. Deux d’entre eux sont à votre disposition.

1. La fonction est manquante. Si wp_register_ability() n’est pas disponible sur le site, WooCommerce Wishlist Pro saute complètement l’enregistrement. Rien ne génère d’erreur, rien ne s’enregistre partiellement, et le plugin continue son travail normal.

2. Une constante. Définir STWPRO_DISABLE_ABILITIES à une valeur vraie saute également l’enregistrement. Définissez-la quelque part qui se charge avant les plugins, ce qui en pratique signifie wp-config.php ou un plugin indispensable :

define( 'STWPRO_DISABLE_ABILITIES', true );

3. Un filtre. Retourner vrai du filtre stwpro_disable_abilities a le même effet. Il convient aux sites qui gardent ce type de décision dans un plugin spécifique au site :

add_filter( 'stwpro_disable_abilities', '__return_true' );

L’un des trois signifie qu’aucune capacité n’est enregistrée, donc aucun client ne peut en découvrir ou en appeler une. Il n’y a pas d’état partiel à analyser, ce qui convient à un interrupteur que vous pourriez avoir besoin de basculer à la hâte.

---

Ce que cela ne fait pas encore

La couverture de l’IA ignore souvent les limites, voici donc les limites réelles.

• Aucun achat autonome. Aucune des 15 capacités ne permet à un agent de passer une commande, de dépenser de l'argent ou de finaliser un achat à la place d'un client.
• Aucun contournement du modèle d'autorisation. Un compte qui ne peut pas gérer WooCommerce ne peut pas appeler ces capacités en demandant à un assistant de le faire à sa place.
• Un menu fixe, pas un accès libre. À partir de SaveTo Wishlist, les 15 capacités nommées constituent la liste complète. Un agent ne peut pas en inventer une seizième, interroger des tables arbitraires ou accéder à des fonctionnalités que personne n'a enregistrées.
• Un client doit toujours se connecter. L'enregistrement d'une capacité ne publie rien sur l'internet public. Un client doit se connecter via un serveur MCP, avec des identifiants qui réussissent les vérifications d'autorisation.
• Il ne lit que ce que le magasin contient. Les enregistrements d'un visiteur résident dans son navigateur jusqu'à ce qu'il se connecte ou s'inscrive. À ce moment-là, les articles migrent vers son compte et deviennent des données sur lesquelles une capacité peut faire un rapport.

Dans l'ensemble, la plupart d'entre elles sont délibérées, pas des oublis attendant un correctif. C'est le modèle d'autorisation qui fait son travail, ce qui est mieux qu'une fonctionnalité qui accorde discrètement plus que ce que vous attendiez.

---

Questions fréquemment posées

---

Préparez vos données de liste de souhaits WooCommerce pour les agents

La partie intéressante n’est pas qu’un assistant puisse répondre à une question sur votre boutique. C’est que personne n’ait eu à construire un connecteur pour cet assistant spécifique en premier lieu. Au lieu de cela, une norme partagée a fait les présentations, et les données de votre liste de souhaits étaient prêtes car elles étaient déjà structurées, autorisées et nommées.

Voici ce qu'il faut faire avec cela :

• Familiarisez-vous avec l'API WordPress Abilities avant de connecter quoi que ce soit à votre boutique.
• Vérifiez le modèle d'autorisation de tout plugin que vous connectez, en particulier si les appels automatisés exécutent le même code que les écrans d'administration.
• Décidez des informations que vous souhaitez qu'un agent puisse répondre, puis faites-les correspondre aux capacités qui les renvoient.
• Connectez un client via votre propre serveur, en commençant par les neuf capacités de lecture seule.
• Notez les interrupteurs maintenant, afin que la décision soit déjà prise si vous en avez besoin rapidement.
• Définissez les attentes de votre équipe quant à ce qu'un agent ne peut pas faire ici.

Les enregistrements de liste de souhaits sont l'un des premiers signaux d'intention que votre boutique reçoit. C'est pourquoi ils valent la peine d'être utilisés pour la récupération des abandons de navigation et valent la peine d'être partagés avec un groupe. Rendre ces données lisibles par les agents IA est une première étape pratique vers le commerce agentiel.