---
title: Comment installer l'agent sur WordPress et WooCommerce
description: Trois manières d'insérer le code sur WordPress, comment l'agent lit le catalogue WooCommerce, la gestion des plugins de cache et la connexion du chat au panier.
section: platforms
keywords: WordPress, WooCommerce, installer agent WordPress, widget chat WordPress, chat e-commerce, agent conversationnel WooCommerce, footer.php, plugin code WordPress, intégrer code WordPress, agent IA e-commerce, chatbot WordPress, assistant virtuel e-commerce, connecter chat panier, gestion cache WordPress
updated: 2026-09-06
---
Le code s'insère de trois manières sur WordPress. Choisissez en fonction de votre aisance à modifier les fichiers de thème.

## Méthode 1 : plugin d'insertion de code (recommandé)

C'est l'option la plus sûre : la modification ne sera pas perdue lors de la mise à jour du thème.

1.  Installez n'importe quel plugin d'insertion de scripts : WPCode, Insert Headers and Footers, Code Snippets.
2.  Ouvrez les réglages du plugin et trouvez le champ pour le code dans le pied de page — il est généralement appelé **Footer** ou **Body (before closing tag)**.
3.  Insérez la ligne depuis votre espace client et enregistrez.

## Méthode 2 : fichier de thème

1.  **Apparence → Éditeur de fichiers de thème**.
2.  Ouvrez `footer.php`.
3.  Insérez le code avant `</body>`.
4.  Mettez à jour le fichier.

Important : modifiez un thème enfant. Lors de la mise à jour du thème parent, le fichier sera écrasé avec votre code.

## Méthode 3 : via functions.php

Pour ceux qui sont plus à l'aise avec le code. Dans le `functions.php` d'un thème enfant :

```php
add_action('wp_footer', function () {
`echo '<script src="https://comag.vibevox.pro/widget.js" data-slug="votre-slug" async></script>';`
});
```

Prenez la ligne de script exacte dans votre espace client, via le bouton « Copier le code ».

## Catalogue WooCommerce

Indiquez l'adresse de votre site dans les réglages et lancez l'analyse. Le robot lit les produits WooCommerce via les données structurées des pages : nom, prix, disponibilité, description, photos, catégories.

Ce qu'il faut savoir :

-   Les **produits variables** apparaissent dans la fiche avec une fourchette de prix et leurs caractéristiques.
-   Les **produits cachés et les brouillons** ne sont pas lus — c'est normal.
-   L'agent ne verra pas les **produits réservés aux utilisateurs connectés** : il navigue sur le site comme un visiteur ordinaire.
-   Si vous disposez d'une exportation de produits au format CSV, vous pouvez la télécharger dans la section « Catalogue » — c'est parfois plus rapide et plus précis que le parcours automatique.

## Panier et paiement

Sur WooCommerce, le paiement dans le chat n'est généralement pas activé : la boutique dispose de sa propre caisse avec livraison, taxes et coupons.

Indiquez le lien vers le panier dans les réglages, le plus souvent `https://votre-domaine/cart` ou `/panier`. L'agent y guidera l'acheteur.

Pour voir quels dialogues se transforment en commandes, ajoutez un fragment du pixel d'achat sur la page « Merci pour votre commande ». Sur WooCommerce, il s'agit du modèle `checkout/thankyou.php` ou du même plugin d'insertion de code avec une condition sur la page de commande.

## Le bouton dans le chat ajoute le produit au panier WooCommerce

Les fiches produits dans les réponses de l'agent ne sont pas de simples images décoratives. Chacune contient un lien vers la page du produit dans votre boutique, et l'agent sait utiliser le mécanisme standard de WooCommerce pour ajouter au panier : une adresse de type `?add-to-cart=123`.

L'acheteur clique sur le bouton dans le chat, le produit est ajouté au panier, puis votre caisse fonctionne avec tous les plugins de livraison, de coupons et de taxes. Aucune intégration ni clé n'est nécessaire pour cela : le mécanisme est intégré à WooCommerce depuis sa création.

Si le lien mène à la page d'un produit variable, l'agent l'ouvre — l'acheteur doit choisir lui-même la taille et la couleur, et c'est juste : substituer une option à sa place est risqué.

Autre chose à savoir : l'agent voit la page sur laquelle le chat est ouvert. Il lit le balisage du produit — nom, référence, prix — et répond dans le contexte. Si un visiteur est sur une fiche produit et demande « y a-t-il moins cher ? », l'agent comprend avec quoi comparer et propose une alternative de votre catalogue, plutôt qu'un conseil abstrait.

La principale raison pour laquelle « le widget n'est pas apparu » sur WordPress est le cache. Après l'insertion du code :

1.  Videz le cache du plugin : WP Rocket, W3 Total Cache, LiteSpeed ou celui que vous utilisez.
2.  Videz le cache CDN, si vous utilisez Cloudflare.
3.  Vérifiez le site en mode navigation privée.

Si l'« agrégation et le chargement différé des scripts » sont activés dans le plugin, ajoutez notre script aux exclusions : la fusion de scripts tiers peut parfois interrompre le chargement.

## Thème clair et sombre

Le widget gère les deux. Dans les réglages, vous choisissez un thème clair, sombre ou « comme le visiteur » — ce dernier suit les paramètres système de l'appareil et est activé par défaut.

C'est pratique si votre thème WordPress dispose d'un sélecteur jour/nuit : laissez « comme le visiteur », et le chat correspondra à ce que la personne a déjà choisi.

## Plugins de cache

## Vérification

-   Le bouton de chat apparaît dans le coin inférieur droit sur n'importe quelle page du site.
-   Une question sur un produit affiche une fiche avec son prix.
-   Le bouton de commande mène au panier WooCommerce.
-   Sur mobile, le bouton ne chevauche pas le menu et le panier.

## Questions fréquentes

### Faut-il un plugin Commerce Agents séparé ?

Non. Une ligne de code suffit, un plugin séparé n'est ni requis ni installé.

### Le widget n'est pas apparu, que vérifier en premier ?

Le cache : plugin de mise en cache et CDN. Ensuite, assurez-vous que le code est inséré dans le pied de page et non dans un widget de colonne latérale arbitraire, et que le thème affiche bien `wp_footer()`.

### L'agent connaîtra-t-il les réductions et les coupons ?

Concernant les coupons, non : ils sont appliqués dans le panier WooCommerce. L'agent affiche les prix tels qu'ils étaient lors du parcours automatique, y compris le prix réduit s'il est affiché sur la page du produit.

### Cela ralentira-t-il le site ?

Le script est asynchrone, léger et ne bloque pas le rendu de la page. L'impact sur PageSpeed est minimal.

### Est-il possible d'afficher le widget uniquement dans la boutique et non dans le blog ?

Oui, si vous insérez le code via un plugin avec des conditions d'affichage ou dans `functions.php` avec une vérification `is_woocommerce()`. Dans le cas simple, l'agent sur toutes les pages ne gêne pas : il répond aussi aux questions sur la livraison depuis le blog.