Connecter WooCommerce

À quoi sert cette connexion ?

WooCommerce permet à ELChat de rechercher les produits, renseigner un client, gérer son panier ELChat, préparer une commande et suivre l’après-vente. Les outils d’administration peuvent aussi consulter les ventes et modifier certaines données de la boutique.

Ce dont vous avez besoin

Identifiant	Rôle dans ELChat	Exemple fictif
URL de la boutique	Indique l’API WooCommerce à appeler	https://boutique.exemple.com
Consumer Key	Identifie la clé REST API	ck_xxxxxxxxxxxxxxxxxxxxx
Consumer Secret	Authentifie les appels associés à la clé	cs_xxxxxxxxxxxxxxxxxxxxx

La clé doit disposer des permissions Lecture/Écriture, car le connecteur comprend des consultations et des modifications réelles.

Étape 1 — Créer la clé dans WooCommerce

1. Connectez-vous à l’administration WordPress avec un compte autorisé à gérer WooCommerce.
2. Ouvrez WooCommerce > Réglages > Avancé > API REST.
3. Cliquez sur Ajouter une clé ou Créer une clé API.
4. Saisissez une description reconnaissable, par exemple ELChat.
5. Choisissez un utilisateur dont les droits correspondent aux actions que vous souhaitez permettre.
6. Sélectionnez Lecture/Écriture.
7. Générez la clé.
8. Copiez immédiatement la Consumer Key et le Consumer Secret.

Le Consumer Secret peut ne plus être affiché après avoir quitté l’écran. Conservez-le dans un gestionnaire de secrets.

WooCommerce exige aussi des permaliens WordPress lisibles : le réglage Simple peut empêcher l’API REST de fonctionner. La procédure officielle est disponible dans la documentation WooCommerce REST API.

Étape 2 — Connecter WooCommerce à ELChat

1. Ouvrez Dashboard > votre site > Actions IA > Connecteurs.
2. Sur la carte WooCommerce, cliquez sur Connecter.
3. Renseignez Consumer key.
4. Renseignez Consumer secret.
5. Renseignez l’URL complète de la boutique, avec https:// et sans chemin d’administration.
6. Validez.

Étape 3 — Vérifier la connexion

Vérifiez que la carte affiche Connecté, puis demandez à ELChat de rechercher un produit publié dont vous connaissez le nom. Comparez le nom, le prix et la disponibilité avec WooCommerce. Pour un second contrôle sans modification, demandez un résumé des ventes sur une période connue depuis l’espace administrateur.

Que peut faire ELChat avec WooCommerce ?

Domaine	Capacités réellement disponibles	Type
Catalogue	Rechercher, consulter et recommander des produits ; lire variantes, stock, avis et méthodes de livraison	Lecture
Panier ELChat	Consulter, ajouter, retirer, vider et changer les quantités ; appliquer/retirer un coupon ; calculer le panier	Lecture et état local ELChat
Liste de souhaits	Consulter, ajouter et retirer un produit	État local ELChat
Commande client	Créer une vraie commande en attente et fournir son URL de paiement ; consulter l’état et l’historique ; rechercher par email	Lecture et écriture
Livraison et documents	Estimer les frais, mettre à jour une adresse avec confirmation, suivre commande/colis et fournir une facture disponible	Lecture et écriture confirmée
Client	Rechercher, créer et mettre à jour un client	Lecture et écriture
Après-vente	Annuler une commande avec confirmation ; enregistrer une demande de retour ou de remboursement ; exécuter un remboursement administrateur	Écriture, parfois financière
Administration boutique	Résumé des ventes, meilleures ventes, modification de stock, statut de commande et prix	Lecture et écriture
Avis	Lire et soumettre un avis produit	Lecture et écriture

Points importants

• Le panier, les coupons appliqués et la liste de souhaits sont conservés par ELChat pour la conversation ; ils ne constituent pas le panier natif de la session WordPress du visiteur.
• Générer le paiement crée une vraie commande WooCommerce en attente, mais ne prélève pas le client.
• Une demande de remboursement ne déplace pas d’argent. L’action administrateur exécuter un remboursement a, elle, un impact financier réel.
• Un lien de facture ou de suivi n’est retourné que si la boutique ou ses extensions le fournissent.

Reconnecter ou remplacer la clé

Créez une nouvelle clé WooCommerce, puis déconnectez et reconnectez la carte avec les nouvelles valeurs. Une fois le test réussi, révoquez l’ancienne clé dans WooCommerce > Réglages > Avancé > API REST.

Déconnecter

Cliquez sur Désactiver dans ELChat. Pour révoquer complètement l’accès, supprimez aussi la clé ELChat dans la liste des clés REST API WooCommerce.

Problèmes fréquents

Erreur 401 ou signature invalide

La clé ou le secret est incomplet, révoqué ou associé à un utilisateur sans droits suffisants. Générez une nouvelle paire en Lecture/Écriture et recopiez-la sans espaces.

Erreur 404 sur l’API

Vérifiez l’URL de boutique et les permaliens WordPress. Activez un format de permalien lisible, puis réessayez.

Produits ou commandes absents

Vérifiez que les produits sont publiés, que l’utilisateur de la clé peut les consulter et que vous interrogez la bonne boutique.

Action refusée

Un statut de commande, une extension de paiement ou les règles de la boutique peuvent bloquer une annulation, un remboursement ou une modification d’adresse. Contrôlez la commande directement dans WooCommerce.

Sécurité et limites

Une clé Lecture/Écriture donne un accès étendu aux données de la boutique. Utilisez un utilisateur dédié, protégez les deux secrets et activez la confirmation humaine pour les remboursements et modifications sensibles. Les résultats dépendent des données et extensions réellement exposées par l’API WooCommerce.