Zum Inhalt

Fehlerbehebung

Häufige Probleme und deren Lösungen. Beginnen Sie bei jedem Problem mit dem ersten Lösungsvorschlag – dies ist in der Regel die wahrscheinlichste Ursache.

Widget erscheint nicht auf meiner Website

  1. Dashboard prüfen — Öffnen Sie Ihre Dashboard-URL direkt. Wenn diese nicht lädt, ist der Server möglicherweise offline – kontaktieren Sie Ihren Account Manager.
  2. data-bot-id überprüfen — Die Bot-ID in Ihrem Embed-Code muss mit Ihrem tatsächlichen Bot-Slug übereinstimmen. Prüfen Sie dies unter Dashboard → Embed.
  3. data-backend-url überprüfen — Muss das Protokoll (https://) und die korrekte Domain enthalten.
  4. Browser-Konsole prüfen — Öffnen Sie die DevTools (F12) → Konsole, um nach JavaScript-Fehlern zu suchen.

Widget erscheint, aber der Bot antwortet nicht

  1. LLM-Statusanzeige prüfen — Wenn diese rot ist, ist die Verbindung zu OpenRouter unterbrochen. Gehen Sie zu Settings → AI Engine und stellen Sie die Verbindung wieder her.
  2. Modellauswahl prüfen — Im Dropdown-Menü muss ein KI-Modell ausgewählt sein.
  3. Knowledge Base prüfen — Wenn diese leer ist, antwortet der Bot möglicherweise generisch oder gar nicht. Fügen Sie Inhalte in der Knowledge Base hinzu.

Chat-Verlauf wird beim Neuladen der Seite nicht gespeichert

  1. LocalStorage muss aktiviert sein — Das Widget speichert Sitzungsdaten im LocalStorage des Browsers. Der private Modus oder Inkognito-Modus kann dies blockieren.
  2. Bot-ID muss konsistent sein — Wenn die data-bot-id auf verschiedenen Seiten unterschiedlich ist, behandelt das Widget diese als separate Bots mit jeweils eigenem Verlauf.

Custom Domain funktioniert nicht

  1. DNS-Propagierung abwarten — Änderungen können 5–30 Minuten dauern.
  2. A-Record überprüfen — Prüfen Sie im Control Panel Ihres DNS-Anbieters, ob der A-Record auf die IP-Adresse Ihres Servers zeigt.
  3. SSL erneuern — Gehen Sie zu Settings → Custom Domain → Renew SSL.
  4. Cloudflare-Nutzer — Stellen Sie sicher, dass der SSL-Modus auf Full (Strict) eingestellt ist.
  5. Account Manager kontaktieren, falls das Problem nach der DNS-Propagierung weiterhin besteht.

Einstellungen werden nicht gespeichert

  1. DB-Statusanzeige prüfen — Diese sollte oben auf der Seite grün leuchten.
  2. Seite aktualisieren — Einstellungen werden zwischengespeichert; ein Refresh erzwingt das Neuladen der Daten.
  3. Account Manager kontaktieren, falls die DB-Anzeige rot ist.

Dashboard lädt, zeigt aber keine Daten an

  1. Statusanzeigen prüfen — Wenn DB oder VEC rot sind, muss möglicherweise ein Backend-Dienst überprüft werden.
  2. Seite aktualisieren — Daten wurden beim ersten Aufruf eventuell nicht korrekt geladen.
  3. Account Manager kontaktieren, falls die Anzeigen rot bleiben.

Integrationstest schlägt fehl

  1. Zugangsdaten überprüfen — API-Keys, SMTP-Passwörter und Webhook-URLs müssen aktuell sein.
  2. Activity Logs prüfen — Filtern Sie nach dem Integrations-Modul für detaillierte Fehlermeldungen.
  3. Externen Dienst testen — Bestätigen Sie, dass der Webhook-Endpunkt, der SMTP-Server oder die API erreichbar sind.

Bot antwortet generisch (ignoriert die Knowledge Base)

  1. Sync-Jobs prüfen — Dateien/URLs befinden sich eventuell noch in der Verarbeitung. Warten Sie auf den Status Completed.
  2. Knowledge Base aktualisieren — Gehen Sie zur Knowledge Base und klicken Sie auf Refresh.
  3. System Prompt überprüfen — Widersprüchliche Anweisungen in Settings → Model Behavior können das Abrufen der Knowledge Base überschreiben.
  4. FAQs hinzufügen — Fügen Sie für kritische Fragen ein FAQ mit der exakten Antwort hinzu. FAQs haben Priorität.

WhatsApp-Nachrichten kommen nicht an

  1. WhatsApp-Dienststatus prüfen — Gehen Sie zu Settings → WhatsApp und stellen Sie sicher, dass der Dienst auf Running steht.
  2. API-Statuscheck prüfen — Die Statusanzeige sollte grün sein.
  3. QR-Code-Sitzung überprüfen — Falls die Verbindung getrennt wurde, scannen Sie den QR-Code erneut.
  4. Account Manager kontaktieren, falls der Dienst nicht startet.

Performance ist langsam

  1. Zu einem schnelleren KI-Modell wechseln — Nutzen Sie Gemini Flash oder Claude Haiku für geringere Latenzzeiten. Siehe AI Models.
  2. Max Tokens reduzieren — Begrenzen Sie die Antwortlänge in Settings → Model Behavior.
  3. Knowledge Base entschlacken — Entfernen Sie veraltete Dokumente, um die Suche zu beschleunigen.
  4. FAQs hinzufügen — Häufige Fragen, die über FAQs beantwortet werden, überspringen das KI-Modell vollständig.
  5. Account Manager kontaktieren, falls die Langsamkeit anhält – der Server benötigt eventuell ein Ressourcen-Upgrade.

Immer noch Probleme?

  • Activity Logs im Dashboard auf Fehlermeldungen prüfen.
  • Kontaktieren Sie Ihren Account Manager mit einer Fehlerbeschreibung und eventuellen Fehlermeldungen, die Sie sehen.