Fehlerbehebung: häufige Probleme und Lösungen

Die meisten Probleme haben nur wenige Ursachen. Geh den Abschnitt durch, der zu dem passt, was du siehst. Die Entwicklerkonsole deines Browsers (F12) nennt die Ursache oft direkt.

Die Chat-Bubble erscheint nicht

• Das Script ist nicht auf der Seite. Öffne den Seitenquelltext und suche nach embed.js. Viele Website-Baukästen fügen eigenen Code nur auf der veröffentlichten Website ein, nicht in der Editor-Vorschau. Das Script funktioniert im Head und im Body; empfohlen ist der Platz direkt vor </body>. Siehe Mit einem Script-Tag installieren.
• Falsche Agent-ID. Die Konsole zeigt Chatbot not found. Kopiere das Snippet noch einmal aus dem Tab Share.
• Die Website steht nicht in den erlaubten Domains. Die Konsole zeigt intoCHAT: this website is not in the allowed domains of this agent, so the chat is not shown. Der Agent ist auf andere Websites beschränkt. Trag die Domain dieser Website im Tab Share unter Where this agent can appear ein, oder leere die Liste, um jede Website zu erlauben. Bis eine neue Domain im Chatfenster ankommt, kann es bis zu einer Minute dauern. Siehe Erlaubte Domains.
• Der Agent ist privat. Die Konsole zeigt intoCHAT: this agent is private, so the chat is not shown. Schalte im Tab Share die Option Private agent aus und klicke auf Save.
• Google Tag Manager. GTM entfernt das Attribut data-chatbot-id aus Script-Tags in benutzerdefinierten HTML-Tags, das Widget weiß dann nicht, welchen Agenten es laden soll. Die Konsole zeigt „The embed script needs a data-chatbot-id attribute.“ Verwende das Snippet aus der Anleitung für Google Tag Manager.
• Content Security Policy. Sendet deine Website einen CSP-Header, erlaube https://www.intochat.ai in script-src, connect-src und frame-src.
• Script-Optimierer. Das Script liest die Agent-ID aus seinem eigenen Tag. Fasst ein Plugin Scripts zusammen oder schreibt sie um, nimm embed.js davon aus.
• Werbe- oder Tracking-Blocker. Manche Browser-Erweiterungen blockieren Chat-Scripts von Drittanbietern. Teste in einem privaten Fenster ohne Erweiterungen.
• Die Bubble erscheint, aber der Agent antwortet nicht mehr. Besucher sehen „Message limit reached“, wenn dein Monatskontingent aufgebraucht ist, siehe Pläne und Limits.

Ein iframe oder der Direktlink zeigt keinen Chat

• Das iframe bleibt leer oder zeigt einen Browserfehler. Die Website steht nicht in den erlaubten Domains des Agenten, oder der Agent ist privat. Der Browser lädt den Chat dann nicht im iframe, und die Konsole nennt frame-ancestors. Trag die Domain der Website im Tab Share unter Where this agent can appear ein.
• „This agent is private.“ Schalte im Tab Share die Option Private agent aus. Solange sie an ist, kannst nur du mit dem Agenten chatten, im Playground.
• „This agent doesn't exist anymore.“ Die Agenten-ID in der Adresse stimmt nicht, oder der Agent wurde gelöscht. Kopiere den Code erneut aus dem Tab Share.
• „The chat couldn't load. Please try again later.“ Die Einstellungen des Agenten ließen sich nicht laden. Lade die Seite neu.

Ein Website-Crawl findet keine Seiten

• „No pages found“: intoCHAT konnte auf der Website keine Seiten finden. Prüfe die Adresse oder schalte Single page mode ein und füge die wichtigen Seiten einzeln hinzu.
• Alles herausgefiltert: Prüfe Exclude URLs containing. Ein Muster wie / trifft auf jede Seite zu.
• „The page answered with an error (403)“ oder Ähnliches: Die Website sperrt automatisierte Besucher. Bitte den Betreiber, den Zugriff zu erlauben, oder lade den Inhalt als Datei hoch bzw. füge ihn als Text ein.
• „No meaningful content found“: Die Seite enthält kaum lesbaren Text.
• „Monthly crawl limit reached“: Warte auf den monatlichen Neustart der Zählung oder upgrade. Dateien, Text und Q&A funktionieren weiter.

Siehe Website crawlen und Dateien.

Antworten sind falsch, vage oder veraltet

1. Stell die Frage im Playground.
2. Nutze im Tab Knowledge bei der Quelle, die die Antwort enthalten sollte, Preview the text. Fehlt der Text dort, wurde die Seite nicht so gelesen, wie du erwartet hast.
3. Leg für häufige Fragen ein Q&A-Paar an. Q&A-Antworten haben Vorrang.
4. Klicke bei der verlässlichsten Quelle auf den Stern (Mark as priority). Sie rangiert dann vor anderem passendem Wissen und setzt sich bei Widersprüchen durch, ohne neues Training.
5. Hat sich eine Seite deiner Website geändert, klicke bei ihrer Quelle auf Refresh from website (von der Website aktualisieren). Die Seite wird neu gelesen und neu trainiert, wenn sich der Text geändert hat. Bei einer geänderten Datei lädst du die neue Version unter demselben Namen hoch und trainierst. Quellen aktualisieren sich nicht von selbst.
6. Lösch veraltete Quellen, die den aktuellen widersprechen, und prüfe deine Instructions.

Findet der Agent nichts Passendes, sagt er, dass er es nicht weiß, statt zu raten. Das ist so gewollt: Ergänze die fehlenden Inhalte. Siehe Quellen verwalten.

Das Lead-Formular erscheint nicht

• Enable lead collection ist an, und du hast auf Save lead settings geklickt.
• Im Modus Manual (visitor asks) erscheint das Formular nur, wenn der Besucher um Kontakt bittet.
• Stichwort-Regeln prüfen nur die letzte Nachricht des Besuchers.
• Das Formular erscheint höchstens dreimal pro Gespräch und nicht mehr, sobald der Besucher in dieser Sitzung Daten genannt hat. Für einen neuen Test öffne ein neues privates Fenster.
• In temporären Chats erscheint es nie.

Siehe Lead-Erfassung.

Eine Aktion schlägt fehl

• Öffne die Aktion und klicke in 2. Try it auf Send test request, um Status und Antwort zu sehen.
• „URL points to a blocked or internal host“: Private und interne Adressen werden abgelehnt. Verwende eine öffentliche URL.
• „This address redirects somewhere else“: Klicke auf Use this address.
• „Request timed out after 30s“: Der Endpunkt ist zu langsam.
• Der Agent ruft sie nie auf: Prüfe, ob die Aktion aktiviert ist und ob When to use die passenden Fragen beschreibt.
• Client-seitige Aktionen laufen nur auf einer Seite mit installiertem Widget vollständig und schlagen in einer Inline-Einbettung per iframe fehl. Siehe Client-seitige Aktionen.

Kommst du nicht weiter? Schreib an support@intochat.ai und gib deine Agent-ID an.