WordPress-Chatbot installieren und einrichten

Voraussetzungen

• WordPress 6.2 oder neuer und PHP 7.4 oder neuer.
• Die Website muss sich selbst per HTTP erreichen können, damit das Plugin Seiten so abrufen kann wie ein Besucher. Klappt das nicht, fällt es auf den the_content-Filter zurück. Ob der Abruf funktioniert, steht vorab unter Inhalte trainieren.
• Eine XML-Sitemap, zum Beispiel die von WordPress (/wp-sitemap.xml) oder die Deines SEO-Plugins. Das Plugin findet sie über die robots.txt.
• cURL für den Tippeffekt der Antworten. Ohne cURL erscheint die Antwort auf einmal.
• HTTPS, wenn Du die Spracheingabe nutzen willst.

1 Konto, Projekt und API-Schlüssel

Jede Website bekommt ein eigenes Projekt. Die Inhalte eines Projekts sind von allen anderen getrennt: Ein Chatbot antwortet nie aus den Inhalten eines fremden Projekts.

1. Öffne das Portal, registriere Dich und bestätige Deine E-Mail-Adresse.
2. Lege ein Projekt an, etwa mit dem Namen Deiner Website.
3. Wechsle im Projekt zu API-Keys und erzeuge einen Schlüssel.
4. Kopiere den Schlüssel sofort und bewahre ihn sicher auf. Er wird nur einmal vollständig angezeigt und gehört wie ein Passwort behandelt.

2 Plugin installieren

Das Plugin gibt es derzeit als ZIP-Datei auf GitHub. Die Aufnahme in das Plugin-Verzeichnis von wordpress.org ist eingereicht und wird geprüft.

Variante A: ZIP hochladen

1. Lade das ZIP der Version 1.3.3 herunter.
2. Öffne in WordPress Plugins → Installieren → Plugin hochladen, wähle die Datei und installiere sie.
3. Klicke auf Plugin aktivieren.

Variante B: WP-CLI

Konsolewp plugin install https://github.com/BlueBranch-GmbH/chatbot-wordpress/archive/refs/tags/1.3.3.zip --activate

Nach dem Aktivieren steht BlueBranch Chatbot als eigener Punkt im Menü, mit den Seiten Erste Schritte, Trainierte Inhalte, Inhalte trainieren, Zusatzinhalte, Fragen & Feedback und Einstellungen.

3 API-Schlüssel hinterlegen

Der bequemste Weg ist BlueBranch Chatbot → Erste Schritte: Dort prüft das Plugin den Schlüssel, bevor es ihn übernimmt. Ein abgelehnter Schlüssel ersetzt den alten nicht. Alternativ trägst Du ihn unter Einstellungen → API-Zugang → API-Schlüssel ein.

Ein hinterlegter Schlüssel erscheint nie im Formular, sondern nur als Punkte, auch nicht im Quelltext der Seite. Lässt Du die Punkte stehen, bleibt der Schlüssel. Ein leeres Feld löscht ihn, alles andere gilt als neuer Schlüssel.

Der Browser spricht nur mit WordPress, WordPress spricht mit der API. Deshalb ist der Schlüssel für Besucher nie sichtbar.

4 Inhalte trainieren

Öffne BlueBranch Chatbot → Inhalte trainieren und klicke auf Jetzt trainieren. Das Plugin geht jeden infrage kommenden Beitrag in kleinen Stapeln durch. Übergeben werden nur Inhalte, die

• veröffentlicht und öffentlich sichtbar sind,
• kein Passwort tragen,
• zu einem der gewählten Inhaltstypen gehören,
• nicht über Yoast SEO, Rank Math oder SEOPress auf noindex stehen,
• und nicht manuell ausgeschlossen wurden.

Danach übernimmt das Speichern: Jeder veröffentlichte oder geänderte Beitrag wird kurz darauf per WP-Cron trainiert. Auf der Trainingsseite steht hinterher, wie viele Seiten trainiert, unverändert, zurückgezogen oder übersprungen wurden. URLs ohne Beitrag dahinter, etwa Kategorie-Archive, werden gezählt und genannt, aber nicht trainiert.

Mit Eine Seite prüfen siehst Du für jede Adresse, was nach dem Entfernen von Header, Footer und wiederkehrenden Blöcken tatsächlich übrig bleibt. Wer den Bestand komplett neu schreiben will, hakt Alles erneut senden an.

5 Chat anzeigen

Du hast drei Möglichkeiten, die sich kombinieren lassen:

1. Auf allen Seiten: Einstellungen → Chat-Button auf allen Seiten anzeigen einschalten.
2. Gezielt per Block: im Block-Editor Chatbot Widget oder Chatbot Suchantwort einfügen.
3. Gezielt per Shortcode: [bluebranch_chatbot_widget] oder [bluebranch_chatbot_search].

Die KI-Antwort über den Suchergebnissen schaltest Du mit Antwort über den Suchergebnissen ein. Die Blöcke folgen den globalen Einstellungen. Für einzelne Seiten gibt es Shortcode-Attribute:

Shortcodes[bluebranch_chatbot_widget position="bottom-left" color="#c8102e" name="KI-Assistent"
    suggestions="Was macht ihr?|Wo sitzt ihr?" hide_disclaimer="yes"]

[bluebranch_chatbot_search questions="Wie erreiche ich euch?|Was kostet das?"
    button="Los" placeholder="Was möchten Sie wissen?"]

[bluebranch_chatbot_search form="no" param="s"]

form="no" lässt das eigene Feld weg und ist für Ergebnisseiten gedacht, auf denen das Theme schon eines hat. autostart="no" verhindert, dass ein Begriff aus der URL sofort beantwortet wird.

6 Antworten prüfen

1. Stelle in Erste Schritte eine Testfrage. Sie läuft über dieselbe Route wie die Frage eines Besuchers.
2. Prüfe unter Trainierte Inhalte, was die Wissensbasis wirklich enthält: Titel, URL, Abschnitte, Sprache und Datum. Einträge lassen sich dort einzeln oder komplett löschen.
3. Rufe Deine Website in einem Privatfenster auf und stelle dem Chat eine Frage, deren Antwort Du kennst. Die Quellen stehen als Links unter der Antwort.
4. Oben auf der Übersicht steht Deine Nutzungsstufe samt Verbrauch im laufenden Monat.

Feinschliff

• Aussehen: Akzentfarbe, Position und Chat-Name unter Einstellungen. Alle Farben und Größen liegen als CSS-Variablen auf .chatbot-widget.
• Fragen-Vorschläge erscheinen als anklickbare Pills unter dem Fragefeld. Getippte Fragen werden als animierter Platzhalter geschrieben. Wer „Bewegung reduzieren“ eingestellt hat, sieht die erste Frage unbewegt.
• Beschriftung von Button und Platzhalter lässt sich unter Einstellungen frei texten.
• Spracheingabe schaltest Du unter Einstellungen → Spracheingabe → Spracheingabe anbieten ein. Sie ist standardmäßig aus. Eine gesprochene Frage zählt doppelt zum Kontingent.
• Fragen & Feedback: Speichern und Bewertung per 👍/👎 sind standardmäßig aus. Gespeichert wird ohne IP-Adresse, E-Mail-Adressen, Telefonnummern und IBANs werden maskiert, die Aufbewahrung ist einstellbar (Standard 180 Tage).
• KI-Hinweis: Nenne den Chat ausdrücklich „KI-Assistent“ und weise in der Begrüßung darauf hin. Warum, steht im Beitrag AI Act und Chatbots.

Inhalte ausschließen

Im Beitrags-Editor steht rechts die Box BlueBranch Chatbot mit dem Feld Aus den KI-Antworten ausschließen. Dort steht auch, ob der Beitrag gerade in der Wissensbasis ist und seit wann. Bei hierarchischen Inhaltstypen vererbt sich die Einstellung auf alle Unterseiten, und die betroffenen Seiten verschwinden sofort aus der Wissensbasis.

Einen Abschnitt innerhalb einer Seite nimmst Du mit dem Shortcode aus, zum Beispiel für einen Hinweis, der in jedem Beitrag steht:

Shortcode[bluebranch_chatbot_exclude]
Dieser Abschnitt bleibt auf der Seite, wird aber nie trainiert.
[/bluebranch_chatbot_exclude]

Fehlersuche

Es wird nichts trainiert

Prüfe, ob WP-Cron läuft (siehe Schritt 4), ob der Inhaltstyp unter Einstellungen ausgewählt ist und ob die Beiträge veröffentlicht, ohne Passwort und nicht auf noindex gesetzt sind. Unter Inhalte trainieren steht außerdem, ob der Selbstabruf der Website funktioniert.

Die Sitemap wird nicht gefunden

Das Plugin liest zuerst die robots.txt, in der jedes SEO-Plugin seine Sitemap ankündigt, und probiert erst danach die üblichen Dateinamen. Steht dort keine, ergänze eine Zeile Sitemap: https://deine-domain.de/wp-sitemap.xml oder passe die Adressen mit dem Filter bluebranch_chatbot_sitemap_urls an.

Etwas aus dem Footer taucht in den Antworten auf

Nutze Eine Seite prüfen, um zu sehen, was übrig bleibt. Meist hilft es, den Block mit [bluebranch_chatbot_exclude] zu umschließen oder die Markierung im Theme zu ergänzen.

Die Antwort kommt auf einmal statt Wort für Wort

Ein Reverse Proxy oder CDN puffert. Bei nginx schaltest Du proxy_buffering off für die Routen unter /wp-json/bluebranch-chatbot/ ab. Das Plugin sendet X-Accel-Buffering: no bereits mit.

Alle Besucher teilen sich ein Limit

Hinter einem Proxy oder CDN kommen alle Besucher mit dessen Adresse an. Liefere die echte Adresse über den Filter bluebranch_chatbot_client_ip, aber nur aus einem Header, den der Proxy selbst setzt und überschreibt.

„Bitte später erneut versuchen“

Die API meldet mit HTTP 429, dass das Minutenlimit (rate_limit) oder das Monatskontingent (monthly_quota) erreicht ist. Besucher lesen nur einen neutralen Hinweis, der genaue Grund steht im Log und auf den Admin-Seiten. Ein pausiertes Projekt (HTTP 403, project_paused) zeigt „Der Chat steht im Moment nicht zur Verfügung“; welche Projekte aktiv bleiben, wählst Du im Portal.

Datenschutz auf Deiner Website

Das Plugin setzt keine eigenen Cookies und speichert keine IP-Adressen. Trotzdem gehört der Chatbot in Deine Datenschutzerklärung, und mit uns brauchst Du einen Auftragsverarbeitungsvertrag. Das Wichtigste dazu steht auf der Seite DSGVO & AVV, Textbausteine im Beitrag Datenschutzerklärung für den Chatbot.

Aktualisieren und Deinstallieren

Spiele neue Versionen wie jedes andere Plugin ein und leere danach den Seiten-Cache, sonst laden zwischengespeicherte Seiten das alte Skript. Der Versionslog zeigt, was sich geändert hat. Deaktivieren lässt Einstellungen und Wissensbasis unberührt. Löschen entfernt Optionen, Transients, Cron-Ereignisse, Beitrags-Metadaten und die beiden eigenen Tabellen. Die trainierten Inhalte bei der API bleiben bestehen; wer sie loswerden will, nutzt vorher Alle Inhalte löschen.

Zum Versionslog