Intégration WooCommerce

L'intégration WooCommerce de Deskwoot affiche dans la barre latérale de la conversation l'historique des commandes du client, les produits achetés et les informations de son compte, pour que les agents et le bot IA répondent aux questions sur les commandes avec tout le contexte. La configuration utilise une clé API WooCommerce que vous créez dans l'administration de votre boutique. Votre équipe support a tout le contexte sans changer d'onglet, et votre bot IA peut s'appuyer sur les informations de commande pour répondre aux clients. Ce guide vous accompagne dans la configuration, vous montre ce qui se passe une fois la boutique connectée et vous aide à résoudre les problèmes courants.

Créer les clés API dans WooCommerce

1. Dans l'admin WordPress, allez dans WooCommerce > Settings > Advanced > REST API.
2. Cliquez sur Add Key.
3. Saisissez une description (par exemple Deskwoot Integration), choisissez un utilisateur avec des droits d'administrateur et réglez les autorisations sur Read/Write si votre équipe doit pouvoir rembourser et annuler des commandes depuis Deskwoot, ou sur Read si vous voulez seulement voir les commandes.
4. Cliquez sur Generate API Key.
5. Copiez tout de suite la Consumer Key et le Consumer Secret. Ils ne s'affichent qu'une seule fois.

Astuce : Gardez les clés en lieu sûr avant de fermer la page. Si vous les perdez, vous devrez créer une nouvelle paire.

Connecter dans Deskwoot

1. Dans Deskwoot, allez dans Paramètres > Intégrations > WooCommerce.
2. Saisissez l'URL de votre site WooCommerce (par exemple https://yourstore.com), la Consumer Key et le Consumer Secret.
3. Cliquez sur Connecter.

Deskwoot vérifie la connexion en envoyant une requête de test à votre boutique. Une fois la connexion vérifiée, les données des commandes et des clients commencent à apparaître dans votre espace de travail.

Historique des commandes dans les conversations

Une fois la boutique connectée, la section Commandes de l'onglet Détails de la conversation affiche les 10 commandes les plus récentes du client, avec le numéro de commande, le statut, le montant total et la date. Cliquez sur une commande pour voir les articles, l'adresse de livraison et les informations de suivi (le suivi nécessite l'extension gratuite WooCommerce Shipment Tracking). Les commandes sont retrouvées grâce à l'adresse e-mail du client. Avec une clé Read/Write, la section propose aussi Rembourser, Annuler la commande et Marquer comme expédiée.

Synchronisation des données clients

Deskwoot importe vos clients WooCommerce comme contacts au moment de la connexion, puis une fois par jour, avec le nom, l'e-mail, le téléphone, l'entreprise, la ville et le pays, et le total dépensé. Ces données complètent les profils des contacts et aident les agents à offrir un support personnalisé.

Contexte pour le bot IA

Quand le bot IA est activé, il reçoit automatiquement le contexte des commandes du client en cours. Il peut ainsi répondre à des questions comme « Où est ma commande ? » ou « Qu'est-ce que j'ai commandé la dernière fois ? » sans qu'un agent intervienne.

Quand un visiteur non vérifié demande où en est une commande, Fynn lui demande le numéro de commande et le code postal de l'adresse de livraison (ou de l'adresse de facturation si la commande n'en a pas). Cela fonctionne pour toutes les commandes de votre boutique, y compris celles passées avant la connexion : une commande que Deskwoot n'a pas encore enregistrée est consultée en direct dans WooCommerce. Si le numéro et le code postal ne correspondent pas, Fynn demande au client de vérifier les deux, puis lui propose de les vérifier plutôt par e-mail. Fynn a besoin de l'option Commandes et transactions (via Shopify/Stripe/WooCommerce) activée sous Accès aux données dans les paramètres des bots (Paramètres > Bots).

Résolution des problèmes

• La connexion échoue lors de la vérification : Vérifiez que l'URL de votre site contient bien https:// et ne se termine pas par une barre oblique. Assurez-vous que la REST API est accessible et qu'elle n'est pas bloquée par une extension de sécurité ou une règle de pare-feu.
• Aucune commande n'apparaît dans la barre latérale : Vérifiez que l'adresse e-mail du client dans la conversation est la même que celle de son compte WooCommerce. Les commandes sont retrouvées par e-mail : si les adresses diffèrent, des données manqueront.
• Erreurs d'autorisation : Vérifiez que la clé API a été créée avec un utilisateur qui a des droits d'administrateur. Pour rembourser et annuler depuis Deskwoot, les autorisations doivent être réglées sur Read/Write.

Bonnes pratiques

• Utilisez un compte utilisateur WordPress réservé à la clé API, pour pouvoir retirer l'accès sans toucher aux autres intégrations.
• Choisissez Read si vous voulez seulement voir les commandes dans Deskwoot. Choisissez Read/Write uniquement si votre équipe doit pouvoir rembourser, annuler ou marquer des commandes comme expédiées depuis Deskwoot.
• Passez régulièrement en revue vos clés REST API WooCommerce et supprimez celles qui ne servent plus.

Questions fréquentes