Zum Hauptinhalt springen

WordPress-Chatbot-Plugin

Verwenden Sie das offizielle ChattyBox-WordPress-Plugin, wenn Sie eine Installation ohne Code wünschen, die das gehostete Widget lädt, ohne Theme-Dateien zu bearbeiten. Diese Anleitung behandelt die operative Einrichtung. Die WordPress-KI-Chatbot-Seite erklärt die Content- und Crawl-Strategie, während die WordPress-Plugin-Landingpage einen Überblick über das Produkt gibt.

Kann ich ChattyBox auf WordPress ohne Branding verwenden?​

Ja. Das offizielle Plugin lädt das gehostete ChattyBox-Widget auf Ihrer WordPress-Website. Im Free-Tarif bleibt die Fußzeile „Powered by ChattyBox“ sichtbar. Mit Starter, Pro und Business können Sie sie unter Anpassen → Erscheinungsbild → ChattyBox-Branding entfernen, indem Sie ChattyBox-Branding anzeigen ausschalten. Die Einstellung finden Sie unter Widget-Anpassung, die Tarife unter Preise.

Vor der Installation​

Schließen Sie zuerst den Ablauf Erste Schritte ab: Verbinden Sie Ihre öffentliche WordPress-URL, überprüfen Sie indexierte Seiten und verifizieren Sie repräsentative Antworten unter Chatbot testen. Prüfen Sie unter Installieren → Schlüssel und Domains die Herkunftseinstellungen Ihres öffentlichen Widget-Schlüssels oder erstellen Sie einen Schlüssel. Ein für eine Website vorbereiteter Schlüssel kann bereits auf deren Origin beschränkt sein. Wählen Sie unter Installieren → Installation auf der Website einen passenden Schlüssel aus und kopieren Sie ihn aus dem Installations-Snippet.

Plugin installieren​

Das Plugin hat keine Abhängigkeit von Composer, npm oder einem Build-Schritt. Es wird derzeit aus dem öffentlichen ChattyBox-GitHub-Repository verteilt, nicht aus dem WordPress.org Plugin Directory. Verwenden Sie daher den WordPress-Ablauf Upload Plugin statt der Verzeichnissuche. Von einem Verzeichnis verwaltete automatische Updates sind noch nicht verfügbar.

Das festgepinnte Paket 0.2.0 deklariert WordPress 5.8+ und PHP 7.4+ und nennt Tests bis WordPress 6.8. Testen Sie die tatsächliche WordPress-/PHP-Version und das Theme; diese Metadaten sind keine Kompatibilitätsgarantie für neuere Releases.

  1. Laden Sie das an Version 0.2.0 gebundene ChattyBox-WordPress-Plugin-ZIP herunter oder sehen Sie sich das öffentliche Quell-Repository an.
  2. Öffnen Sie in WordPress Plugins > Add New > Upload Plugin, laden Sie das ZIP hoch und aktivieren Sie ChattyBox AI Chatbot. Für eine manuelle Serverinstallation kopieren Sie zuerst das Plugin-Verzeichnis nach wp-content/plugins/.
  3. Öffnen Sie Settings > ChattyBox.
  4. Fügen Sie den öffentlichen Widget-API-Schlüssel aus dem Installations-Snippet ein.
  5. Aktivieren Sie den Chatbot und speichern Sie die Einstellungen.

Das Plugin speichert den öffentlichen Widget-Schlüssel und die Anzeigeeinstellungen in den WordPress-Optionen. Fügen Sie niemals Verwaltungszugangsdaten von ChattyBox in das Plugin ein.

Laden konfigurieren​

Die Produktionsstandards sind:

  • Widget-Skript: https://chattybox.ai/widget.js
  • API-Endpunkt: automatisch vom Plugin konfiguriert
  • Aktiviert: aus, bis Sie den Chatbot mit einem nicht leeren öffentlichen Schlüssel aktivieren
  • Locale-Override: leer; das Widget folgt der Projekt-Policy (standardmäßig Auto)

Im aktuellen Quellcode des gehosteten Widgets versucht der Auto-Modus zuerst eine unterstützte Sprache aus dem Seitenattribut <html lang>, dann unterstützte Browsersprachen, die konfigurierte Standard-Locale und Englisch. Der Fixed-Modus verwendet die Standard-Locale des Projekts. Der optionale Sprach-Override des Plugins wird zu data-locale und gilt nur, wenn das Projekt Script-Overrides zulässt. Verwenden Sie einen unterstützten Locale-Code in Kleinbuchstaben; benutzerdefinierte Header- und Begrüßungstexte werden nicht automatisch übersetzt. Prüfen Sie die separat bereitgestellte Loader-Version, wenn Sie sich auf dieses Verhalten verlassen.

Der API-Endpunkt ist in dieser Plugin-Version fest integriert und wird nicht aus dem Schlüssel abgeleitet. Eine Änderung von Widget script URL ändert diesen Endpunkt nicht. Wenn das Installations-Snippet für die Website auf ein anderes API-Deployment verweist, verwenden Sie stattdessen die manuelle Skriptintegration. Remote-Loader-URLs müssen HTTPS verwenden (HTTP ist nur für lokale Entwicklungs-Hosts zulässig).

Das Plugin registriert das Widget bei WordPress-Frontend-Anfragen zum Einreihen von Skripten und überspringt ausdrücklich Feeds, REST- und AJAX-Anfragen. Diese Request-Prüfungen untersuchen nicht jeden Antworttyp und stellen nicht fest, ob jede Frontend-Seite öffentlich ist. Sie erkennen auch nicht bei jeder Frontend-Seite, ob sie privat oder Mitgliedern vorbehalten ist: Schließen Sie Checkout-, Konto-, passwortgeschützte und Mitgliederseiten bei Bedarf ausdrücklich aus. Prüfen Sie außerdem, ob Ihr Theme die WordPress-Footer-Skripte ausgibt. Das Plugin crawlt oder synchronisiert keine Beiträge; Indexierung und Aktualisierungen erfolgen in ChattyBox.

Schlüssel ohne Einschränkungen funktionieren von allen Browser-Origins aus; ein für eine Website vorbereiteter Schlüssel kann bereits auf deren Origin beschränkt sein. Wenn Sie die optionalen Einschränkungen unter Installieren → Schlüssel und Domains aktivieren, müssen Sie für jede gewünschte Origin Schema, Host und Port angeben. Bei einer fehlenden oder nicht zugelassenen effektiven Origin liefert ein eingeschränkter Schlüssel HTTP 401 Invalid API key; fehlt der Origin-Header, kann der Server die Origin aus einem gültigen Referer ableiten. Origin-Einschränkungen sind zusätzliche Absicherung, aber keine Besucherauthentifizierung. Testen Sie die Produktionsseite, nicht nur das Dashboard.

Weitere Routen ausschließen​

Verwenden Sie den Filter chattybox_load_widget in einem standortspezifischen Plugin oder einem Child-Theme, wenn eine öffentliche Route das Widget nicht anzeigen soll:

add_filter(
    'chattybox_load_widget',
    static function ( $should_load ) {
        return $should_load && ! is_page( array( 'checkout', 'account' ) );
    }
);

Lassen Sie zunächst das Standardverhalten des Plugins aktiviert und fügen Sie dann nur die für Ihre Website erforderlichen Routenausschlüsse hinzu. Testen Sie nach der Änderung des Filters sowohl eine ausgeschlossene Route als auch eine normale öffentliche Seite.

Dieser Filter entscheidet für die aktuelle WordPress-Anfrage, ob das Skript geladen wird; er entfernt kein Widget, das bei clientseitiger Navigation in einer SPA bereits initialisiert wurde.

Manueller Skript-Fallback​

Verwenden Sie das Plugin als Standardweg. Wenn Ihr WordPress-Team Skripte bereits über ein Theme, ein Child-Theme, ein Skript-Plugin oder Google Tag Manager verwaltet, können Sie das gehostete Widget stattdessen manuell laden:

<script
  src="https://chattybox.ai/widget.js"
  data-api-key="YOUR_API_KEY"
  data-api-url="YOUR_WIDGET_API_URL"
  async
></script>

Aktivieren Sie nicht gleichzeitig das Plugin und fügen Sie nicht gleichzeitig dasselbe Widget-Snippet hinzu. Wählen Sie einen Loader, damit Besucher keine doppelten Launcher erhalten.

Installation überprüfen​

Nach der Konfiguration des Plugins:

  • Öffnen Sie eine öffentliche WordPress-Seite in einem Inkognito-Fenster.
  • Bestätigen Sie, dass der Launcher einmal erscheint.
  • Stellen Sie eine echte Besucherfrage.
  • Prüfen Sie, dass eine unterstützte Antwort indexierte öffentliche WordPress-Seiten zitiert und eine nicht unterstützte Frage den Fallback zeigt, der keine Quellen haben kann.
  • Prüfen Sie die Browserkonsole auf fehlendes data-api-key, data-api-url oder Schlüssel-Fehler.
  • Testen Sie bei konfiguriertem Ausschluss eine Checkout-, Konto- oder private Route.
  • Leeren Sie nach Änderungen an Einstellungen oder Ausschlüssen relevante WordPress-/CDN-Caches und testen Sie einen neuen Seitenaufruf.
  • Serverseitige Ausschlüsse entfernen kein Widget, das bei clientseitiger Navigation in einer SPA bereits initialisiert wurde. Bauen Sie das Widget auf sensiblen Routen oder nach dem Widerruf der Einwilligung aktiv über eine Integration ab, die vom tatsächlich bereitgestellten Loader unterstützt wird. Das Entfernen eines Skripts oder das Ausblenden per CSS genügt nicht, um das Widget vollständig abzubauen. Eine bereits vom Server verarbeitete Anfrage lässt sich dadurch nicht rückgängig machen.
  • Der automatische Plugin-Loader prüft die Einwilligung der Besucher nicht, bevor er das Widget zum Laden einreiht. Falls eine Einwilligung erforderlich ist, verwenden Sie eine Integration, die das Laden bis zur Erteilung der Einwilligung verhindert, und überprüfen Sie das Verhalten beim Widerruf mit dem bereitgestellten Loader.

Arbeiten Sie vor der Ankündigung des Chatbots die Launch-Checkliste ab. Unter Konversationen → Verlauf können Sie in allen Tarifen Konversationen überprüfen. Mit Pro oder Business können Sie unter Konversationen → Analysen die Analysen und unter Konversationen → Unbeantwortete Fragen die offenen Fragen nutzen, um Verbesserungspotenzial zu erkennen, sobald echte Fragen eingehen.