1. Accueil
  2. Base de connaissances
  3. Advanced Coupons
  4. Intégrations
  5. Comment utiliser l'API WordPress Abilities avec Advanced Coupons

Comment utiliser l'API WordPress Abilities avec Advanced Coupons

La gestion des coupons implique généralement de cliquer dans l'administration WooCommerce, une page à la fois. Si vous travaillez avec un assistant IA comme Claude ou ChatGPT, Advanced Coupons peut recevoir ces instructions directement via l'API WordPress Abilities, ajoutée dans la version 4.7.4, vous permettant ainsi de demander à votre assistant de lister, créer, mettre à jour, planifier ou supprimer des coupons.

Qu'est-ce que l'API WordPress Abilities ?

L'API WordPress Abilities est une norme, disponible dans les versions actuelles de WordPress, qui permet aux plugins de décrire leurs fonctionnalités dans un format lisible par logiciel. Au lieu que chaque outil IA nécessite une intégration personnalisée pour votre boutique, un plugin enregistre ses capacités une fois, et tout outil compatible peut les utiliser.

Ces capacités parviennent à un assistant IA via un connecteur appelé adaptateur MCP. MCP (Model Context Protocol) est le langage commun utilisé par les assistants IA pour communiquer avec des outils externes. Advanced Coupons enregistre un ensemble de capacités de coupons sur cette norme, toutes regroupées sous une seule catégorie Advanced Coupons afin qu'un assistant connecté puisse les trouver ensemble. Selon l'adaptateur que vous utilisez, votre assistant peut lister chaque capacité directement ou les découvrir sur demande.

Les capacités s'enregistrent automatiquement une fois que l'API Abilities est présente, ce qui est le cas sur WordPress 7.0 et versions ultérieures. Sur les versions antérieures de WordPress, elles ne s'enregistrent que si le plugin de fonctionnalité séparé Abilities API est actif.

Ce que vous pouvez faire avec

Advanced Coupons enregistre huit capacités. Trois sont en lecture seule, et cinq modifient vos coupons. Celles qui modifient les données sont marquées afin que votre assistant IA vous demande confirmation avant de les exécuter.

CapacitéCe qu'elle faitModifie les données ?
Lister les couponsRetourne une liste filtrée de coupons (par type, statut, nombre d'utilisations ou date d'expiration).Non
Obtenir un couponRetourne la configuration complète d'un seul coupon, y compris les conditions du panier, la configuration BOGO, les restrictions de rôle, le déclencheur d'URL et la planification.Non
Obtenir le résumé des couponsRetourne les totaux d'utilisation et de remise des coupons pour une période donnée, ainsi que vos codes les plus performants.Non
Créer un couponCrée un nouveau coupon avec les paramètres Advanced Coupons optionnels.Oui
Mettre à jour un couponMet à jour un coupon existant. Seuls les champs que vous fournissez sont modifiés.Oui
Supprimer un couponDéplace un coupon vers la corbeille.Oui
Définir le déclencheur d'URL du couponActive ou désactive le déclencheur d'URL du coupon et définit ses options associées.Oui
Définir la planification du couponActive ou désactive la planification de la période de validité d'un coupon et définit ses dates de début et de fin.Oui

En pratique, cela signifie que vous pouvez demander à votre assistant des choses comme « montre-moi tous les coupons qui expirent ce mois-ci », « crée un coupon de réduction de 15 % appelé SPRING15 qui expire dans 30 jours », ou « quels cinq coupons ont généré le plus de remises au dernier trimestre ? » et il utilisera la capacité correspondante pour répondre ou agir.

Ce dont vous aurez besoin

  • WordPress 7.0 ou version ultérieure (l'API Abilities est intégrée), ou une version antérieure avec le plugin de fonctionnalité API Abilities activé.
  • WooCommerce actif, avec Advanced Coupons 4.7.4 ou version ultérieure installé et en cours d'exécution (l'intégration de l'API Abilities a été ajoutée dans la version 4.7.4).
  • Un plugin adaptateur MCP qui relie WordPress à votre assistant IA (voir le guide de l'adaptateur MCP pour WordPress). Advanced Coupons enregistre les capacités ; il n'inclut pas l'adaptateur lui-même.
  • Un compte utilisateur capable de gérer WooCommerce (un responsable de boutique ou un administrateur). Votre assistant agit en tant qu'utilisateur connecté.

Connectez votre assistant IA

Les étapes exactes dépendent de l'adaptateur MCP que vous utilisez, mais le processus est le même :

  1. Confirmez que vous utilisez WordPress 7.0 ou une version ultérieure, avec WooCommerce et Advanced Coupons actifs.
  2. Installez et configurez un plugin adaptateur MCP, et connectez-le à votre assistant IA en suivant les instructions de cet adaptateur.
  3. Authentifiez-vous en tant qu'utilisateur capable de gérer WooCommerce, afin que les capacités de coupon soient disponibles.
  4. Dans votre assistant IA, demandez ce qu'il peut faire avec vos coupons, afin qu'il découvre les capacités Advanced Coupons disponibles.
  5. Commencez par une requête en lecture seule telle que « lister mes coupons actifs » pour confirmer que la connexion fonctionne avant d'apporter des modifications.

Permissions et sécurité

Chacune des huit capacités, y compris celles en lecture seule, nécessite un utilisateur capable de gérer WooCommerce. Les données des coupons telles que les codes, les montants des remises, les limites d'utilisation et les résumés des revenus sont des informations du propriétaire de la boutique, donc un compte client ou abonné ne peut exécuter aucune de ces capacités.

Les cinq capacités qui modifient les données sont marquées comme destructrices. Un assistant IA bien conçu vous affiche une invite de confirmation avant de les exécuter, de sorte que rien ne soit créé, modifié ou supprimé sans votre autorisation.

Lorsque votre assistant crée ou met à jour un coupon, il passe par le même processus d'enregistrement que l'écran de modification d'Advanced Coupons. Il n'y a pas de chemin « IA » distinct, donc les coupons créés de cette manière se comportent de manière identique à ceux que vous créez manuellement, et les intégrations connectées continuent de fonctionner normalement.

Deux capacités dépendent de leur fonctionnalité activée. Définir le déclencheur d'URL de coupon ne fonctionne que lorsque la fonctionnalité Coupons par URL (Comment appliquer un coupon avec une URL) est activée, et Définir la planification des coupons ne fonctionne que lorsque la fonctionnalité Planificateur (Comment planifier des coupons) est activée. Si la fonctionnalité est désactivée, la capacité renvoie un message clair au lieu d'apporter une modification.

Désactiver les capacités (pour les développeurs)

Si vous préférez qu'Advanced Coupons n'enregistre aucune capacité, vous pouvez les désactiver dans le code. Définissez cette constante (par exemple dans wp-config.php) :

define( 'ACFWF_DISABLE_ABILITIES', true );

Ou utilisez le filtre :

add_filter( 'acfwf_disable_abilities', '__return_true' );

Foire aux questions

Avec quels assistants IA cela fonctionne-t-il ?
Tout assistant prenant en charge MCP, tel que Claude Desktop ou l'application de bureau ChatGPT, une fois que vous l'avez connecté à votre site via un adaptateur MCP. Advanced Coupons ne favorise aucun assistant particulier.

Mon assistant IA peut-il voir les données clients ou de commande via ceci ?
Non. Ces capacités couvrent uniquement les coupons et les résumés d’utilisation des coupons. Elles nécessitent également un utilisateur capable de gérer WooCommerce, elles ne peuvent donc pas être exécutées par des comptes clients.

Les coupons que mon assistant crée se comporteront-ils différemment de ceux que je crée manuellement ?
Non. Ils sont enregistrés via le même processus que l’écran de modification des coupons, ils se comportent donc exactement de la même manière.

Dois-je écrire du code pour utiliser ceci ?
Non. L’utilisation des capacités nécessite uniquement WordPress 7.0, WooCommerce et un adaptateur MCP. Du code n’est impliqué que si vous souhaitez désactiver les capacités.

Besoin d'aide ?

Si vous avez une question ou rencontrez des problèmes, nous sommes là pour vous aider.

Cet article vous a-t-il été utile ?

Articles similaires

Finaliser votre achat