DocsWordPress & WooCommerce

WordPress & WooCommerce

WooCommerce läuft auf WordPress — und für Alpheris ist WooCommerce genau das: eine WordPress-Seite. Du hast zwei Wege, das Widget einzubinden: die One-Click-Verknüpfung über das Dashboard oder das normale Skript-Snippet. Hier erfährst du, wie beide funktionieren und was beim Verbinden automatisch synchronisiert wird.

WooCommerce ist ein WordPress-Plugin. Es gibt deshalb keinen eigenen „WooCommerce-Connector" — du verbindest deine WordPress-Seite, und dein Shop ist damit abgedeckt. Wenn du keine WordPress-Seite betreibst, sondern Shopify nutzt, lies stattdessen die Seite Shopify.

Zwei Wege zur Einbindung

Beide Wege landen am selben Ziel: das Alpheris-Widget erscheint unten rechts auf deiner Seite und beantwortet Kundenfragen gegroundet aus deiner Wissensbasis. Wähle nach Bequemlichkeit:

One-Click verbinden

URL eintragen, im Dashboard bestätigen. Domain wird automatisch verifiziert und die Wissensbasis befüllt.

Skript-Snippet

Eine Skript-Zeile im Theme-Header oder per Plugin einfügen. Funktioniert auf jeder WordPress-Installation.

Weg 1 — One-Click verbinden

Der schnellste Weg. Du gibst im Dashboard deine Website-URL ein, wirst kurz weitergeleitet und bist verbunden. Die Domain wird dabei automatisch als verifiziert hinterlegt, eine eindeutige Install-ID erzeugt und die Wissensbasis-Synchronisation angestoßen.

Install-Seite öffnen

Im Dashboard unter Einbindung die Methode WordPress wählen.

Website-URL eintragen

Die Adresse deines Shops eingeben, z. B. https://dein-shop.de. Mit oder ohne www funktioniert — die www.-Variante wird automatisch mit angelegt.

Verbindung bestätigen

Auf „Mit WordPress verbinden" klicken. Du wirst kurz weitergeleitet; bist du noch nicht eingeloggt, fragt Alpheris zuerst nach deinem Login und kehrt danach automatisch zurück.

Fertig

Domain ist verifiziert, Install-ID erzeugt, Wissensbasis-Sync läuft an. Das Widget ist auf deiner Seite aktiv, sobald die Skript-Zeile geladen wird (siehe Weg 2 für die Platzierung).

Beim One-Click-Flow wird deine Domain ohne zusätzlichen DNS- oder Datei-Nachweis als verifiziert markiert, weil die Verknüpfung aus deinem eingeloggten Dashboard heraus erfolgt. Die Install-ID wird fest an diese Domain gebunden.

Weg 2 — Skript-Snippet

Das Snippet ist der universelle Weg und funktioniert auf jeder WordPress-Installation, unabhängig vom Theme oder Page-Builder. Du findest deinen persönlichen Code im Dashboard unter Einbindung → Code. Er sieht so aus:

HTML

<!-- Alpheris Chat Widget -->
<script src="https://alpheris.com/widget.js" data-alpheris-key="INSTALL_ID" crossorigin="anonymous" async></script>
<!-- End Alpheris Chat Widget -->

Ersetze INSTALL_ID nicht von Hand — kopiere den fertigen Code aus dem Dashboard, dort ist deine echte Install-ID bereits eingesetzt. Das Attribut heißt data-alpheris-key und verbindet das Widget mit deinem Shop.

Wo das Snippet auf WordPress hingehört

Das Snippet muss auf jeder Seite geladen werden — am sichersten ist es daher kurz vor dem schließenden </body> oder im globalen Header. Übliche Wege in WordPress:

Theme-Customizer / Header-&-Footer-Plugin: Viele Themes und Plugins (z. B. „Insert Headers and Footers"-artige Erweiterungen) bieten ein Feld für globalen Footer- oder Header-Code. Das Snippet dort einfügen und speichern.
Theme-Datei footer.php: In einem Child-Theme das Snippet direkt vor </body> einsetzen. Nur empfehlenswert, wenn du mit Child-Themes vertraut bist, sonst geht die Änderung beim Theme-Update verloren.
Block-Editor / Custom-HTML-Block: Nicht empfohlen für die seitenweite Einbindung — das Snippet würde nur auf der jeweiligen Seite laden.

WordPress- und WooCommerce-Seiten cachen aggressiv (Caching-Plugins, Server-Cache, CDN). Wenn das Widget nach dem Einfügen nicht erscheint, leere den Seiten-Cache und lade die Seite neu. Mehr dazu auf der Seite Fehlerbehebung.

Was synchronisiert wird

Sobald das Widget zum ersten Mal real auf deiner Seite geladen wird (kein Vorschau-Modus, gültige Install-ID), stößt Alpheris bei einer WordPress-Verbindung einen Embed-Sync an. Dieser zieht den öffentlichen Inhalt deiner Seite über die WordPress-REST-API ein:

Quelle	Endpunkt	Wird übernommen
Seiten	`/wp-json/wp/v2/pages`	Titel und Textinhalt jeder veröffentlichten Seite
Beiträge	`/wp-json/wp/v2/posts`	Titel und Textinhalt jedes veröffentlichten Beitrags

Der Inhalt wird zu durchsuchbarem Wissen verarbeitet und als Quelle vom Typ wordpress_api_full in deiner Wissensbasis gespeichert. Aus diesem Wissen beantwortet der Chatbot anschließend Kundenfragen gegroundet. Welche Inhalte landen, wie du sie ergänzt und Dateien hochlädst, steht unter Datenquellen & Wissensbasis.

Voraussetzung: erreichbare REST-API

Der Sync funktioniert nur, wenn deine WordPress-REST-API öffentlich erreichbar ist. Alpheris prüft das vorab über /wp-json/. Liefert deine Seite hier 401, 403 oder 404 (z. B. weil ein Sicherheits-Plugin die REST-API blockt), wird der Embed-Sync mit einem entsprechenden Fehler abgebrochen.

Sitzt deine Seite hinter Cloudflare oder einer Firewall, die Bots blockiert? Dann hilft die Seite Crawl hinter Cloudflare. Schlägt der Wissens-Aufbau ganz fehl, ist Crawl fehlgeschlagen der richtige Anlaufpunkt.

WooCommerce-Produkte

Wichtig zu verstehen: Der Embed-Sync zieht Seiten und Beiträge über die WordPress-REST-API ein — er liest nicht den WooCommerce-Produktkatalog über eine separate WooCommerce-API aus. Es gibt keinen nativen, bidirektionalen WooCommerce-Produkt- oder Bestell-Connector wie bei Shopify.

Deine WooCommerce-Produktseiten werden trotzdem erfasst — als ganz normale Inhaltsseiten deiner Website. Über die Texte, Beschreibungen und FAQ-Inhalte auf diesen Seiten kann der Chatbot also durchaus zu Produkten Auskunft geben. Was er nicht tut: Live-Lagerbestände, Echtzeit-Preise oder Bestellstatus aus der WooCommerce-Datenbank ziehen.

Verlass dich bei WooCommerce nicht auf Echtzeit-Bestand oder -Preise im Chat. Was nicht als Text auf einer öffentlichen Seite steht, kennt der Chatbot nicht. Halte produktrelevante Infos in deinen Seiteninhalten aktuell — oder lade Produktlisten als Datei hoch (siehe Datenquellen).

Domain & Sicherheit

Beim Verbinden bindet Alpheris die Install-ID an die verifizierte Domain deiner Seite. Standardmäßig ist der Strict-Domain-Modus aktiv: Widget- und Chat-Anfragen werden gegen den Host der Einbettung geprüft. Dadurch kann dein Schlüssel nicht einfach auf einer fremden Domain missbraucht werden.

Die www.-Variante deiner Domain wird automatisch mitverifiziert.
Weitere Domains kannst du im Dashboard ergänzen — Details unter Domains.
Datenschutz-Hinweis und optionale Einwilligung pro Shop konfigurierst du unter Sicherheit & Datenschutz.

Schnelltest nach der Einbindung

Seite im privaten Fenster öffnen

Ein Inkognito-/Privatfenster umgeht den Browser-Cache. Das Widget sollte unten rechts erscheinen.

Eine echte Frage stellen

Frag etwas, das auf deinen Seiten steht (z. B. Versand, Rückgabe, ein Produkt). Kommt eine passende Antwort, ist die Wissensbasis befüllt.

Kein Widget? Cache leeren

Caching-Plugin, Server-Cache und CDN leeren, dann erneut prüfen. Bleibt es leer, hilft die Fehlerbehebung.

Antwortet das Widget noch dünn oder ungenau? Der Wissens-Aufbau läuft beim ersten Embed im Hintergrund und braucht je nach Seitenumfang etwas Zeit. Feinschliff des Tons und der Antwortlänge nimmst du unter KI-Agent vor.