Intégration WooCommerce

Accès depuis : Paramètres → Connexions

Une fois votre boutique WooCommerce connectée, votre assistant IA peut consulter le catalogue de la boutique via le MCP d'Epinium. La connexion est en lecture seule : votre assistant consulte, mais Epinium ne modifie rien dans votre boutique.

Vous n'avez aucune app à créer. La boutique génère elle-même une clé d'accès en lecture seule, et vous approuvez, depuis votre tableau de bord WordPress, qu'Epinium l'utilise. Le processus compte deux étapes et prend quelques minutes.

Les menus de WordPress, dans votre langue

Ce guide nomme les menus de WordPress et de WooCommerce tels qu'ils apparaissent en français. Votre tableau de bord les affichera dans la langue de votre WordPress, et certains noms peuvent varier légèrement selon la version.

Avant de commencer

• Votre boutique doit utiliser une connexion sécurisée. Son adresse doit commencer par https:// et s'ouvrir dans le navigateur sans avertissement de sécurité.
• Les permaliens de WordPress ne peuvent pas être réglés sur « Simple ». Vous les modifiez dans votre tableau de bord WordPress, sous Réglages → Permaliens : n'importe quelle autre option convient.
• L'API REST de votre boutique doit être accessible. C'est le canal par lequel WooCommerce partage des données avec d'autres applications, et certains plugins de sécurité la bloquent.
• Vous devez vous connecter à WordPress en tant qu'administrateur de la boutique. Si quelqu'un d'autre l'administre, gardez-le sous la main : c'est cette personne qui devra se connecter et approuver l'accès.

Étape 1 : vérifiez votre boutique

1. Allez dans Paramètres → Connexions et cliquez sur Ajouter une connexion.
2. Choisissez WooCommerce.
3. Dans Adresse de votre boutique, saisissez l'adresse que vos clients utilisent pour accéder à votre boutique, par exemple maboutique.com. Vous pouvez la saisir avec ou sans https://.
4. Cliquez sur « Vérifier la boutique ».

Epinium vérifie qu'il y a à cette adresse une boutique WooCommerce qui remplit les prérequis. S'il en manque un, il vous le dit tout de suite, avant d'ouvrir quoi que ce soit dans votre boutique (les messages et ce qu'il faut faire pour chacun se trouvent dans Problèmes fréquents).

Si tout va bien, vous verrez le message « Nous avons trouvé votre boutique », avec l'adresse qui va être connectée. Elle peut différer légèrement de celle que vous avez saisie : si votre boutique utilise www. ou est installée dans un dossier (maboutique.com/boutique), Epinium utilise l'adresse que déclare la boutique elle-même.

Étape 2 : approuvez l'accès dans votre boutique

1. Cliquez sur « Approuver dans ma boutique ». Une fenêtre de votre boutique s'ouvre.
2. Connectez-vous à WordPress en tant qu'administrateur, si ce n'était pas déjà le cas.
3. WooCommerce vous indique que Epinium - nom de votre compte souhaite se connecter à votre boutique avec un accès en lecture. Cliquez sur « Approuver ».
4. La fenêtre se ferme et Epinium vous confirme que la boutique est connectée. Cliquez sur « Finaliser ».

Sur cet écran, WooCommerce énumère tout ce qu'une clé en lecture permet de voir en général : coupons, clients, commandes et rapports de ventes, et produits. C'est son texte standard pour toute application qui demande un accès en lecture. Epinium ne laisse votre assistant consulter que ce qui est détaillé dans Ce que votre assistant peut lire et ce qu'il ne peut pas lire.

Si vous laissez passer quelques minutes entre l'étape 1 et l'étape 2, Epinium vous demandera de vérifier à nouveau la boutique avant de continuer.

Pourquoi le nom de votre compte apparaît

WooCommerce affiche le nom de celui qui demande l'accès. Epinium ajoute le nom de votre compte pour que la personne qui approuve sache exactement qui le demande. WooCommerce l'enregistre aussi dans la description de la clé, ce qui vous permettra de la reconnaître plus tard dans votre boutique sous le nom Epinium - nom de votre compte - API (date). Si vous êtes une agence et que vous connectez la boutique d'un client, c'est le nom de ce client dans Epinium qui apparaît. Si la personne qui approuve ne reconnaît pas le nom, elle ne doit pas approuver.

Alternative : se connecter avec une clé

Si la fenêtre de votre boutique ne s'ouvre pas, ou si après l'approbation WordPress affiche une page d'erreur et la fenêtre ne revient pas vers Epinium, vous pouvez vous connecter en créant vous-même la clé dans la boutique et en la collant dans Epinium.

Dans votre boutique : créez la clé

1. Dans votre tableau de bord WordPress, allez dans WooCommerce → Réglages → Avancé → API REST et cliquez sur « Ajouter une clé ».
2. Donnez-lui une description qui vous aidera à la reconnaître plus tard, par exemple « Epinium ».
3. Choisissez un utilisateur administrateur.
4. Choisissez l'autorisation « Lecture » : ainsi, la clé permet uniquement de consulter.
5. Cliquez sur « Générer la clé API ». WooCommerce vous affiche la clé client (elle commence par ck_) et le secret client (il commence par cs_). Copiez-les maintenant : WooCommerce ne les affiche que sur cet écran.

Dans Epinium : collez la clé

1. Sur l'écran WooCommerce d'Epinium, saisissez l'Adresse de votre boutique, comme à l'étape 1.
2. Ouvrez le panneau « La fenêtre ne s'ouvre pas ou affiche une erreur ? Connectez-vous avec une clé ».
3. Collez la clé dans Clé client (consumer key) et le secret dans Secret client (consumer secret).
4. Cliquez sur « Se connecter avec la clé ».

Epinium teste la clé auprès de votre boutique avant de l'enregistrer. Si elle ne fonctionne pas, la connexion n'est pas créée et l'écran vous indique pourquoi.

Si vous venez d'une tentative d'approbation qui n'a pas abouti, Epinium vous propose le bouton « Se connecter avec une clé », qui vous amène directement à ce formulaire.

Ce que votre assistant peut lire et ce qu'il ne peut pas lire

Votre assistant peut consulter :

• Le catalogue : produits et leurs variations, catégories, étiquettes, marques et attributs.
• Les rapports de ventes, les produits les plus vendus et les totaux de la boutique (combien de commandes, produits, clients, coupons ou avis il y a, sans en voir aucun en particulier).
• Les données de référence : pays, continents et devises.

Votre assistant ne peut pas consulter :

• Les commandes, les clients, les coupons ni les avis, car ils contiennent des noms, des e-mails ou des adresses de personnes.
• La configuration de la boutique : réglages, taxes, expédition ou moyens de paiement.
• Les champs que les plugins ajoutent aux produits. Certains plugins y enregistrent des données personnelles, c'est pourquoi Epinium ne les transmet jamais, même si la clé permet techniquement de les lire.

Epinium n'écrit rien dans votre boutique : la clé est en lecture seule, c'est donc la boutique elle-même qui empêche toute modification.

Vos données et le modèle d'IA

Epinium ne conserve pas les données de votre boutique WooCommerce et ne les envoie à aucun modèle d'IA qui lui serait propre. Votre assistant consulte la boutique au moment où il en a besoin, et c'est vous qui choisissez et payez le modèle d'IA de votre choix, en le connectant vous-même.

Déconnecter et révoquer l'accès

1. Dans Paramètres → Connexions, repérez votre boutique dans la liste et choisissez « Supprimer » dans ses actions.
2. Confirmez. Epinium supprime immédiatement la connexion et les clés qu'il conservait.
3. Pour que la clé disparaisse aussi de votre boutique, allez dans WooCommerce → Réglages → Avancé → API REST dans votre tableau de bord WordPress, repérez la clé Epinium - nom de votre compte - API (date) (ou la description que vous lui avez donnée, si vous l'avez créée vous-même) et révoquez-la.

Epinium ne peut pas révoquer la clé à votre place : WooCommerce ne le permet que depuis le tableau de bord de la boutique. Tant que vous ne l'avez pas révoquée, la clé existe toujours dans votre boutique, même si Epinium ne l'utilise plus.

Si vous reconnectez la même boutique

Lorsque vous reconnectez une boutique qui était déjà connectée, Epinium commence à utiliser une nouvelle clé et l'ancienne reste active dans votre boutique. Vous pouvez révoquer l'ancienne de la même façon.

Problèmes fréquents

Les permaliens de ma boutique sont réglés sur « Simple »

Cause : votre WordPress utilise l'option « Simple » pour les permaliens, et avec elle WooCommerce ne peut pas terminer l'approbation.

Solution : dans votre tableau de bord WordPress, allez dans Réglages → Permaliens, choisissez n'importe quelle autre option, enregistrez les modifications et cliquez à nouveau sur « Vérifier la boutique ». Ce réglage change le format des adresses de vos pages : si quelqu'un d'autre gère votre site, prévenez-le avant.

---

« Votre boutique doit utiliser une connexion sécurisée (https) »

Cause : votre boutique s'ouvre en http:// au lieu de https://, ou l'adresse que déclare la boutique elle-même n'est pas sécurisée.

Solution : activez la connexion sécurisée (le certificat SSL) depuis le panneau de votre hébergeur, ou demandez à votre fournisseur de l'activer. Une fois que votre boutique s'ouvre en https://, vérifiez-la à nouveau.

---

« Nous n'avons pas pu joindre votre boutique »

Cause : l'adresse est mal saisie, le site ne fonctionne pas ou ne répond pas à temps, ou son certificat de sécurité n'est pas valide.

Solution : ouvrez l'adresse dans votre navigateur et vérifiez que votre boutique se charge sans avertissement de sécurité. Corrigez-la si nécessaire et réessayez.

---

« Nous n'avons pas trouvé WooCommerce à cette adresse »

Cause : WooCommerce n'est pas actif sur ce site, ou un plugin de sécurité (ou le pare-feu de votre hébergeur) bloque l'API REST de la boutique.

Solution : vérifiez dans Extensions que WooCommerce est actif. S'il l'est, revoyez la configuration de vos plugins de sécurité et autorisez l'accès à l'API REST, ou renseignez-vous auprès de votre hébergeur.

---

Mon navigateur bloque la fenêtre de la boutique

Cause : votre navigateur n'autorise pas Epinium à ouvrir des fenêtres pop-up.

Solution : autorisez les fenêtres pop-up pour Epinium dans votre navigateur et cliquez à nouveau sur « Approuver dans ma boutique ».

---

WordPress affiche une erreur après l'approbation et la fenêtre ne revient pas vers Epinium

Cause : la boutique n'a pas pu terminer de transmettre la clé à Epinium. C'est généralement dû à un plugin de sécurité qui bloque l'API REST ou à un hébergeur qui ne détecte pas correctement la connexion sécurisée. Dans ce cas, WooCommerce supprime la clé et affiche sa propre page d'erreur au lieu de revenir vers Epinium : aucune clé à moitié créée ne reste donc dans votre boutique.

Solution : fermez la fenêtre de la boutique et, dans Epinium, cliquez sur « Annuler ». Vous verrez le bouton « Se connecter avec une clé » : utilisez-le et suivez l'alternative avec une clé.

---

« Votre boutique a refusé la clé » alors que la clé est correcte

Cause la plus fréquente : la clé n'a pas été copiée en entier, elle appartient à un utilisateur qui n'est pas administrateur, ou elle n'a pas l'autorisation de lecture.

Autre cause : votre boutique se trouve derrière un CDN ou un proxy (par exemple, un service comme Cloudflare) qui reçoit la connexion sécurisée mais ne la transmet pas à WordPress. WordPress croit alors que la connexion n'est pas sécurisée et refuse la clé, même si l'adresse de votre boutique commence par https://.

Solution : vérifiez d'abord la clé, l'utilisateur et l'autorisation « Lecture ». Si tout est correct et que vous utilisez un CDN ou un proxy, demandez à la personne qui gère votre hébergement de faire en sorte que WordPress reconnaisse la connexion sécurisée qui lui arrive par ce service, puis réessayez.

---

J'ai annulé l'accès dans ma boutique

Cause : sur l'écran de WooCommerce, l'accès a été refusé au lieu d'être approuvé. Epinium l'indique avec le message « Vous avez annulé l'accès dans votre boutique ».

Solution : si c'était par erreur, cliquez à nouveau sur « Vérifier la boutique » puis sur « Approuver dans ma boutique », et cette fois cliquez sur « Approuver ».

---

La connexion apparaît comme « Hors ligne » avec le bouton « Renouveler »

Cause : votre boutique n'accepte plus la clé d'Epinium. Cela arrive lorsque quelqu'un la révoque dans WooCommerce → Réglages → Avancé → API REST, ou lorsque l'utilisateur WordPress auquel elle appartient perd son rôle d'administrateur ou est supprimé.

Solution : dans Paramètres → Connexions, cliquez sur « Renouveler » sur cette boutique et refaites la connexion : l'étape 1 et l'étape 2, ou l'alternative avec une clé. Renouveler met à jour la même connexion : cela ne compte pas comme une nouvelle boutique dans votre forfait.

---

« Votre forfait n'autorise pas plus de connexions »

Cause : chaque boutique WooCommerce compte comme une connexion de votre forfait, et vous avez déjà utilisé toutes celles qu'il inclut.

Solution : passez à un forfait supérieur depuis l'avis qui s'affiche à l'écran, puis réessayez. Renouveler une boutique déjà connectée n'est pas bloqué par cette limite.

---

Besoin d'aide supplémentaire ?

Si le problème persiste après avoir suivi ces étapes, contactez l'équipe support d'Epinium via le chat de la plateforme ou à support@epinium.com.