# Chat-Widget in WordPress einbinden

> Bring deinen intoCHAT-Agenten mit dem offiziellen Plugin auf WordPress: installieren, Agenten-ID unter Einstellungen einfügen, Shortcode für einzelne Seiten.

Das offizielle intoCHAT-Plugin bringt die Chat-Bubble auf deine WordPress-Website, ohne dass du Theme-Dateien bearbeitest. Es ist kostenlos, Open Source unter der GPL und im Plugin-Verzeichnis von WordPress.org als [intochat.ai](https://wordpress.org/plugins/intochat-ai-embed/) zu finden.

## Bevor du startest

- Ein gespeicherter intoCHAT-Agent. Öffne seinen Tab **Share** und klicke auf der Karte **WordPress Plugin** auf **Copy ID**.
- Ein WordPress-Konto, das Plugins installieren darf.

## Plugin installieren

1. Gehe im WordPress-Admin zu **Plugins → Installieren** (in neueren Versionen **Neues Plugin hinzufügen**).
2. Suche nach **intochat.ai**, installiere und aktiviere das Plugin.
3. Gehe zu **Einstellungen → intochat.ai**, füge deine Agenten-ID ein und speichere.
4. Öffne deine Website. Die Chat-Bubble erscheint auf jeder Seite, mit den Farben und der Position aus dem Tab [Appearance](/de/docs/appearance).

Das Plugin verbindet nur deine Website mit dem Agenten. Training, Anweisungen, Aussehen und Lead-Einstellungen verwaltest du weiter im intoCHAT-Dashboard. Änderungen dort landen auf deiner Website, ohne dass du das Plugin erneut anfasst.

## Chat nur auf bestimmten Seiten zeigen

Standardmäßig erscheint die Bubble auf jeder Seite. In den Plugin-Einstellungen kannst du stattdessen festlegen, dass sie nur dort erscheint, wo du den Shortcode `[intochat]` einsetzt, zum Beispiel in einem Shortcode-Block auf deiner Kontakt- oder Hilfeseite.

## Ohne Plugin

Möchtest du kein Plugin installieren, füge das Script-Tag aus dem Tab **Share** in den Footer deines Themes ein, direkt vor `</body>`. Nutze ein Child-Theme, damit ein Theme-Update den Code nicht entfernt. Mehr dazu unter [Per Script-Tag einbinden](/de/docs/script-tag).

## Agenten mit deinen WordPress-Inhalten trainieren

Gib im Tab **Knowledge** (Wissen) die Adresse deiner Website ein. Der Crawl findet deine Seiten und Beiträge über Sitemap und Links, und du wählst aus, welche dazugehören. Eine automatische Synchronisierung gibt es nicht: Änderst du eine Seite, klicke bei ihrer Quelle auf **Refresh from website** (von der Website aktualisieren), damit sie neu gelesen wird. Siehe [Website-Crawl](/de/docs/website-crawl).

## WooCommerce-Shops

Auf WooCommerce funktioniert das Plugin genauso. Damit der Agent auch deine Produkte durchsucht:

1. Öffne den Tab **Actions** (Aktionen) und wähle **Connect your website**.
2. Füge die Adresse deines Shops ein, samt Ordner, falls WordPress in einem Unterordner wie `/shop` liegt.
3. intoCHAT prüft die WooCommerce Store API und legt die Aktionen **Search products** und **Get product details** an.

Die Produktsuche liest öffentliche Produktdaten unter `/wp-json/`. Nutzt du ein Sicherheits-Plugin wie Wordfence, achte darauf, dass es diesen Pfad nicht blockiert. Siehe [Shop verbinden](/de/docs/connect-your-store) und den [WooCommerce-Ratgeber](/de/integrationen/woocommerce).

## Fehlerbehebung

- **Keine Bubble.** Prüfe, ob die ID unter **Einstellungen → intochat.ai** mit der im Tab **Share** übereinstimmt.
- **Immer noch keine Bubble nach dem Speichern.** Leere den Cache deines Caching-Plugins oder Hosters. Fasst ein Optimierungs-Plugin JavaScript zusammen oder verzögert es, nimm `embed.js` davon aus.
- **Testen im eingeloggten Zustand.** Für die Sicht deiner Besucher öffnest du die Website in einem privaten Fenster. Bist du eingeloggt, öffnet sich der Chat auf dem Smartphone im Vollbild unterhalb der WordPress-Adminleiste.

Weitere Fälle findest du unter [Fehlerbehebung](/de/docs/troubleshooting). Einen Überblick, was der Agent auf WordPress kann, gibt die [WordPress-Integrationsseite](/de/integrationen/wordpress).