Passer au contenu principal
Votre assistant recherche des produits avec leur prix et leur stock, indique aux appelants le statut de leur commande et transmet les demandes d’annulation et de retour à votre équipe sous forme de notes de commande privées. Les commandes téléphoniques sont facultatives. L’assistant n’annule jamais lui-même une commande et ne déplace aucun argent.

Connecter votre boutique

  1. Votre boutique doit avoir une adresse HTTPS. Dans WordPress, ouvrez Réglages → Permaliens et choisissez n’importe quelle option sauf Simple (Plain).
  2. 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.
  3. Copiez la consumer key (elle commence par ck_) et le consumer secret (il commence par cs_). WooCommerce n’affiche le secret qu’une seule fois.
  4. Ouvrez Agent Tools → Marketplace → WooCommerce. Saisissez l’adresse de la boutique, la consumer key et le consumer secret.
  5. 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.
Pour modifier plus tard l’adresse de la boutique ou les clés, supprimez l’outil et reconnectez-le.

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.
Facultatif, à choisir sous Modifier :
  • 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.
Si les informations ne correspondent pas, l’assistant ne révèle rien, pas même si la commande existe. Après trois réponses erronées dans une conversation, il cesse de vérifier pendant une heure. Avec un numéro masqué, l’assistant demande toujours l’adresse e-mail ou le code postal. L’assistant ne lit jamais à voix haute les adresses, les adresses e-mail, les numéros de téléphone, les notes client ni les remboursements.

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.
L’assistant ne modifie rien dans la commande, ne crée ni remboursement ni étiquette de retour et ne promet rien : votre équipe décide. Une demande est possible par commande et par type ; une deuxième demande pour la même commande n’est pas écrite à nouveau. Le titre de la note affiche la marque de votre espace de travail.

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.
Activez l’e-mail Note client sous WooCommerce → Réglages → E-mails, sinon aucun lien n’arrive chez le client. Si la note ne peut pas être envoyée, l’assistant dit que la boutique enverra les informations de paiement.

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.
Pour les modifier, modifiez la connexion sous Automatisations → Connexions ou reconnectez-vous. La sélection des outils (demandes, commandes téléphoniques) se change directement sur l’outil.

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.
Champs facultatifs : 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.
Documentation de l’API REST de WooCommerce