# Installer le widget de chat sur WordPress

> Ajoutez votre agent intoCHAT à WordPress avec l'extension officielle : installez-la, collez l'identifiant de l'agent dans les réglages et utilisez le shortcode.

L'extension officielle intoCHAT ajoute la bulle de chat à votre site WordPress sans modifier les fichiers du thème. Elle est gratuite, open source sous licence GPL et disponible dans le répertoire des extensions de WordPress.org sous le nom [intochat.ai](https://wordpress.org/plugins/intochat-ai-embed/).

## Avant de commencer

- Un agent intoCHAT enregistré. Ouvrez son onglet **Share** et, dans le bloc **WordPress Plugin**, cliquez sur **Copy ID**.
- Un compte WordPress autorisé à installer des extensions.

## Installer l'extension

1. Dans l'administration WordPress, allez dans **Extensions → Ajouter** (**Ajouter une extension** dans les versions récentes).
2. Recherchez **intochat.ai**, puis installez et activez l'extension.
3. Allez dans **Réglages → intochat.ai**, collez l'identifiant de votre agent et enregistrez.
4. Ouvrez votre site. La bulle de chat apparaît sur chaque page, avec les couleurs et la position de l'onglet [Appearance](/fr/docs/appearance).

L'extension se contente de relier votre site à l'agent. L'entraînement, les instructions, l'apparence et les réglages des leads restent dans le tableau de bord intoCHAT, et les modifications faites là-bas arrivent sur votre site sans toucher à l'extension.

## Afficher le chat sur certaines pages seulement

Par défaut, la bulle apparaît sur chaque page. Dans les réglages de l'extension, vous pouvez choisir de ne l'afficher que là où vous placez le shortcode `[intochat]`, par exemple dans un bloc Code court sur votre page de contact ou d'aide.

## Sans l'extension

Si vous préférez ne pas installer d'extension, collez la balise script de l'onglet **Share** dans le pied de page de votre thème, juste avant `</body>`. Utilisez un thème enfant pour qu'une mise à jour du thème ne la supprime pas. Voir [Installer avec une balise script](/fr/docs/script-tag).

## Entraîner l'agent sur vos contenus WordPress

Dans l'onglet **Knowledge** (Connaissances), saisissez l'adresse de votre site. Le crawl trouve vos pages et articles via le sitemap et les liens, et vous choisissez ceux à inclure. Il n'y a pas de synchronisation automatique : quand vous modifiez une page, cliquez sur **Refresh from website** (actualiser depuis le site) sur sa source pour la relire. Voir [Crawl du site](/fr/docs/website-crawl).

## Boutiques WooCommerce

Sur WooCommerce, l'extension fonctionne de la même façon. Pour que l'agent recherche aussi vos produits :

1. Ouvrez l'onglet **Actions** et choisissez **Connect your website**.
2. Collez l'adresse de votre boutique, avec le dossier si WordPress est installé dans un sous-dossier comme `/shop`.
3. intoCHAT vérifie la WooCommerce Store API et ajoute les actions **Search products** et **Get product details**.

La recherche de produits lit les données produit publiques sous `/wp-json/`. Si vous utilisez une extension de sécurité comme Wordfence, vérifiez qu'elle ne bloque pas ce chemin. Voir [Connecter votre boutique](/fr/docs/connect-your-store) et le [guide WooCommerce](/fr/integrations/woocommerce).

## Dépannage

- **Pas de bulle.** Vérifiez que l'identifiant dans **Réglages → intochat.ai** correspond à celui de l'onglet **Share**.
- **Toujours pas de bulle après l'enregistrement.** Videz le cache de votre extension de cache ou de votre hébergeur. Si une extension d'optimisation combine ou retarde le JavaScript, excluez-en `embed.js`.
- **Tester en étant connecté.** Pour voir le site comme un visiteur, ouvrez-le dans une fenêtre privée. Si vous êtes connecté, sur mobile le chat s'ouvre en plein écran sous la barre d'administration de WordPress.

D'autres cas sont traités dans [Dépannage](/fr/docs/troubleshooting). Pour un aperçu de ce que l'agent fait sur WordPress, voir la [page d'intégration WordPress](/fr/integrations/wordpress).