Anleitungen

Chatbot einrichten: Anleitungen für WordPress und Contao

Beide Systeme nutzen dasselbe Konto, dieselbe API und dieselbe Wissensbasis. Wähle Dein CMS, der Rest ist Schritt für Schritt erklärt, inklusive Fehlersuche und Datenschutz-Hinweisen.

Anleitung wählen

WordPress

Plugin hochladen, Schlüssel hinterlegen, Beiträge über die Sitemap trainieren, Chat per Schalter, Block oder Shortcode anzeigen.

  • WordPress 6.2+, PHP 7.4+
  • Training beim Veröffentlichen per WP-Cron
  • Fehlersuche für Sitemap, Cron und Proxy
WordPress-Anleitung

Contao

Per Contao Manager oder Composer installieren, im Assistenten „Erste Schritte“ verbinden, trainieren und den Chat auf allen Seiten anzeigen.

  • Contao 4.13 und 5.x, PHP 8.0+
  • Training per Klick, Chat ohne Layoutarbeit
  • Updates ohne Stolperfallen
Contao-Anleitung

Grundlagen

Was für beide Systeme gleich ist

Konto und Projekt

Du registrierst Dich einmal im Portal. Jede Website bekommt ein eigenes Projekt, das ist die Datengrenze: Inhalte, Vektoren und Schlüssel gehören immer genau einem Projekt.

API-Schlüssel

Der Schlüssel ordnet jede Anfrage Deinem Projekt zu. Er steht nur in Deinem CMS auf dem Server und wird nie an den Browser geschickt. Behandle ihn wie ein Passwort.

Kontingent

Begrenzt wird nur das Erzeugen von Antworten: je Minute und je Kalendermonat. Die Zahlen kommen zur Laufzeit von der API und stehen in der Übersicht Deiner Erweiterung.

HTTPS

Die Spracheingabe funktioniert nur über HTTPS (oder localhost) und in Browsern mit MediaRecorder. Ohne diese Voraussetzungen bleibt das Mikrofon einfach verborgen.

Datenschutz-Fragen beantwortet die Seite DSGVO & AVV. Dort findest Du auch die Checkliste für Betreiber.

Für Entwickler

Anderes CMS? Nutze die API direkt

Die API ist öffentlich dokumentiert. Mit einem API-Schlüssel stellst Du Fragen aus Deinem eigenen Backend. Rufe sie nie aus dem Browser auf, sonst liegt der Schlüssel offen.

RouteAntwortart
POST …/chatbot-ai/generate/chatChat: kurz und schnell, höchstens drei Sätze
POST …/chatbot-ai/generate/chatbotSuche: ausführlich, mit Quellenangabe

Beide gibt es auch als Stream (Server-Sent Events): zuerst ein Ereignis mit den Quellen, danach die Antwort in Stücken, zum Schluss ein end-Ereignis. Hinter einem Reverse Proxy muss das Puffern abgeschaltet sein.

API-Dokumentation (Swagger)
Beispielcurl -X POST https://api.chatbot.bluebranch.de/api/v1/chatbot-ai/generate/chat \
  -H "x-api-key: DEIN_API_SCHLUESSEL" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Wie erreiche ich euch?", "language": "deutsch"}'

Verbindlich sind die Routen und Felder der API-Dokumentation. Die Nutzlast (prompt, language, chat_context, max_tokens) ist bei beiden Antwortarten gleich.

Jetzt starten

Bereit für einen Chatbot, der Deine Daten schützt?

Registrieren, API-Schlüssel erzeugen, Erweiterung installieren: Die kostenlose Stufe genügt zum Ausprobieren. Den AVV nach Art. 28 DSGVO schicken wir Dir auf Anfrage.

Kostenlos starten AVV anfragen

Antwort in der Regel binnen 24 Stunden · hello@bluebranch.de