Connecter votre boutique
- Votre boutique doit avoir une adresse HTTPS. Dans WordPress, ouvrez Réglages → Permaliens et choisissez n’importe quelle option sauf Simple (Plain).
- Dans WooCommerce, ouvrez Réglages → Avancé → API REST → Ajouter une clé. Choisissez un utilisateur avec le rôle de gestionnaire de boutique et l’autorisation Lecture pour les questions, ou Lecture/Écriture pour les notes de demande et les commandes téléphoniques.
- Copiez la consumer key (elle commence par
ck_) et le consumer secret (il commence parcs_). WooCommerce n’affiche le secret qu’une seule fois. - Ouvrez Agent Tools → Marketplace → WooCommerce. Saisissez l’adresse de la boutique, la consumer key et le consumer secret.
- Choisissez Ajouter. La connexion est vérifiée avant l’enregistrement : la clé doit pouvoir lire les produits et les commandes. Associez ensuite la connexion à votre assistant.
Ce que l’assistant peut faire
Activé par défaut :- Rechercher des produits par nom ou par catégorie, avec prix, stock et variantes. Seuls les produits publiés et visibles dans le catalogue apparaissent. L’assistant n’invente jamais un prix.
- Indiquer le statut, le contenu et le total d’une commande, et retrouver les dernières commandes d’un appelant.
- Laisser une demande d’annulation pour votre équipe.
- Laisser une demande de retour ou d’échange pour votre équipe.
- Les commandes téléphoniques.
Confidentialité des commandes
Le numéro de commande seul ne suffit jamais. L’assistant affiche une commande lorsque l’une de ces conditions est remplie :- Le numéro de l’appelant correspond au numéro de téléphone de la commande, et aucun autre client (autre adresse e-mail) n’utilise ce numéro.
- L’appelant donne l’adresse e-mail de la commande ou le code postal de livraison.
Demandes d’annulation, de retour et d’échange
Une demande est une note de commande privée pour votre équipe (jamais visible par le client). Elle contient un titre, le motif, la vérification réussie, un numéro de rappel et une courte référence. Exemple :- Les demandes d’annulation sont possibles tant que la commande attend le paiement, est en attente ou est en préparation.
- Les demandes de retour et d’échange sont possibles pour les commandes terminées. La note indique les produits et le motif.
Commandes téléphoniques
Les commandes téléphoniques sont désactivées par défaut. Activez-les sous Modifier. L’assistant recueille jusqu’à cinq produits simples différents en stock, ainsi que le nom, l’adresse e-mail et l’adresse de livraison. Il relit tout et ne crée la commande qu’après le « oui » de l’appelant. Les produits avec variantes ne sont pas pris en charge.- La commande démarre impayée (En attente de paiement). Rien n’est réservé avant le paiement.
- WooCommerce envoie au client le lien de paiement par e-mail, sous forme de note client, dans le design de votre boutique. L’assistant ne lit jamais le lien et ne recueille aucune donnée de carte ni bancaire.
- L’assistant annonce les prix des produits tels qu’ils figurent dans votre boutique, hors livraison. La page de paiement affiche le montant final.
- La même commande pour la même adresse e-mail le même jour n’est créée qu’une seule fois.
Réglages
Trois réglages font partie de la connexion :- Produits par réponse : 3, 5 ou 10 produits (3 par défaut).
- Mentionner les produits en rupture de stock : indique si les produits épuisés apparaissent dans les réponses (oui par défaut).
- Transférer les commandes téléphoniques au-delà de : la valeur de la commande, dans la devise de votre boutique, au-delà de laquelle l’assistant propose de transférer l’appelant à votre équipe. 0 signifie aucune limite.
Reconnaître les appelants
Lorsque le canal fournit le numéro de l’appelant, l’assistant reçoit avant la conversation un court résumé : le prénom, le dernier numéro de commande avec son statut et sa date, et le nombre de commandes ouvertes. Cela n’arrive que si un seul client utilise ce numéro. L’assistant n’y reçoit ni adresse e-mail, ni numéro de téléphone, ni adresse, ni total. Votre boutique dispose d’environ 2,5 secondes pour cette requête. Une boutique lente l’ignore, et l’assistant demande alors le numéro de commande.Tester sans risque
Les demandes écrivent de vraies notes sur de vraies commandes, et les commandes téléphoniques créent de vraies commandes impayées et envoient un vrai e-mail. Testez avec un produit de test, votre propre numéro et votre propre adresse e-mail, puis supprimez la commande de test.Canaux
Téléphone, chat web, WhatsApp, Messenger et e-mail utilisent les mêmes outils. Un numéro d’appelant correspondant ne confirme une commande que là où le canal fournit le numéro. Partout ailleurs, et avec un numéro masqué, l’assistant demande l’adresse e-mail ou le code postal.Automatisations
Connectez WooCommerce dans Automatisations → Connexions, ou importez sa connexion Agent Tools. Chaque outil est disponible comme action. Une automatisation déclenchée par un appel ou une conversation par texte (SMS, WhatsApp) connaît le numéro de l’interlocuteur grâce à cet appel lui-même. Les autres exécutions (webhook, planification) n’ont pas d’appelant : Statut de la commande y exige une adresse e-mail ou un code postal, et Dernières commandes de l’appelant signale qu’aucun numéro n’est disponible. Les actions de demande et de commande téléphonique exigent une valeur Confirmé par l’appelant, qui n’est vraie qu’après le « oui » de l’appelant.API, MCP, CLI & SDK
POST /api/v1/tools/integrations/woocommerce · MCP connect_integration · CLI famulor connect-integration woocommerce · SDK client.api.connectIntegration.
products_per_answer, mention_out_of_stock et phone_order_limit.
Dépannage
- « Cette adresse ne mène pas à l’API REST de WooCommerce » : vérifiez l’adresse de la boutique. Des permaliens WordPress réglés sur Simple provoquent aussi ce message ; choisissez une autre option sous Réglages → Permaliens.
- « La boutique a répondu par une page web au lieu de données » : un plugin de sécurité ou un pare-feu bloque les requêtes d’API. Autorisez les requêtes vers
/wp-json/wc/v3/depuis l’extérieur. - « WooCommerce a refusé la consumer key ou le secret » : la clé a été révoquée, son utilisateur a été supprimé, ou la clé ne peut pas lire les commandes. Créez une nouvelle clé pour un gestionnaire de boutique.
- Les demandes échouent et le journal indique que la clé ne peut que lire : une note de demande exige l’autorisation Lecture/Écriture.
- La vérification de la connexion échoue alors que les clés sont correctes : certains hébergeurs suppriment l’en-tête Authorization. Demandez à votre hébergeur de le laisser passer. La connexion tente aussi une solution de repli par elle-même.
- Le numéro d’un appelant ne trouve aucune commande : la recherche de la boutique compare les 8 derniers chiffres du numéro. Si votre boutique enregistre les numéros avec des espaces, demandez plutôt le numéro de commande.