Zum Hauptinhalt springen

Erste Schritte

Die dokumentierten Kontingente für enthaltene Seiten werden über die Projekte eines Eigentümers geteilt. Unter Preise finden Sie die Plankontingente und unter Konto & Abrechnung im Dashboard die aktuelle Nutzung und das verfügbare Kontingent Ihres Kontos.

Bauen Sie einen nützlichen Chatbot, bevor Sie ihn auf Ihrer Website einsetzen. Die grundlegende Abfolge lautet erstellen → Inhalte hinzufügen → prüfen → testen → anpassen → integrieren.

1. Konto und Projekt erstellen​

Melden Sie sich beim ChattyBox-Dashboard an, wählen Sie Neuer Chatbot und geben Sie dem Projekt einen Namen sowie optional eine Website-URL. Nach der Erstellung öffnet sich der Arbeitsbereich unter Wissensbasis → Importieren und aktualisieren. Wird ein Projekt ohne ausgewählten Tab geöffnet, ist Übersicht der Standard. Durch das Erstellen allein wird kein Import gestartet.

Unter Preise finden Sie die aktuellen Limits für Projekte, Seiten und Nutzung.

2. Inhaltsquelle konfigurieren​

Öffnen Sie Wissensbasis → Importieren und aktualisieren, verbinden Sie die öffentliche Website, prüfen Sie die gefundenen Seiten, passen Sie die empfohlene oder eine eigene Auswahl an und starten Sie den Import oder die Aktualisierung der ausgewählten Seiten. Änderungen an den Quelleinstellungen werden automatisch gespeichert: Prüfen Sie den Speicherstatus und beheben Sie Validierungsfehler oder wiederholen Sie einen fehlgeschlagenen Speichervorgang, bevor Sie fortfahren. Unter den erweiterten Quelleinstellungen gibt es außerdem die separate Aktion Jetzt scrapen, die den konfigurierten Erkennungsmodus verwendet. Ein- und Ausschlussregeln sowie die Crawling-Tiefe sind über Konfiguration als Code verfügbar, nicht über das Dashboard.

ChattyBox extrahiert lesbare HTML-Inhalte und stellt geänderte Inhalte zur Indexierung in eine Warteschlange. Die Erkennung und das automatische Speichern starten keinen Import. JavaScript wird nicht gerendert und robots.txt nicht durchgesetzt. Importieren Sie nur öffentliche Seiten, zu deren Indexierung Sie berechtigt sind, und wählen Sie den Umfang für den Start bewusst aus. Die Dauer hängt von der Erkennung, der Seitenzahl und der Indexierung ab.

Verwenden Sie Inhalte hinzufügen und aktualisieren, wenn Sie Anleitungen zu Sitemaps, manuellen URLs, Crawling, Mehrsprachigkeit oder erneutem Crawling benötigen.

3. Indexierte Inhalte prüfen​

Öffnen Sie Wissensbasis → Seiten und vergleichen Sie die tatsächlich importierten Seiten mit den erwarteten Quellen. Öffnen Sie den Importauftrag, um Anzahl und Teilinhaltswarnungen zu prüfen, und kontrollieren Sie vor der Bewertung der Antworten den separaten Embedding-Auftrag. Ein abgeschlossener Import garantiert nicht, dass jede angeforderte Seite oder jeder Abschnitt indexiert wurde. Weitere Informationen finden Sie unter Fortschritt und Teilindexierung.

4. Antwortqualität testen​

Öffnen Sie Chatbot testen und stellen Sie repräsentative Fragen, die echte Besucher verwenden werden. Prüfen Sie, ob die Antworten:

  • die indexierte Dokumentation statt unbelegter Annahmen verwenden;
  • auf nützliche Quellseiten verweisen;
  • fehlende Informationen mit dem vorgesehenen Fallback behandeln;
  • für wichtige Sprachen und Begriffe funktionieren.

Verbessern Sie bei schwachen Antworten die Quelle oder Auswahl und aktualisieren Sie erneut, sobald die Abkühlzeit des Tarifs es erlaubt: kostenlose Aktualisierungen sind höchstens wöchentlich, kostenpflichtige höchstens täglich möglich. Chatbot testen verbraucht das Nachrichtenkontingent des Eigentümers und speichert Konversationen. Testinteraktionen können in Analysen und – wenn sie als unbeantwortet erkannt werden – unter „Unbeantwortete Fragen“ erscheinen; Abrechnung und Erfassung einer Lücke hängen vom Ergebnis ab. Installieren Sie den Chatbot nicht allein deshalb, weil der erste Import abgeschlossen ist.

5. Benutzererlebnis anpassen​

Wählen Sie unter Anpassen → Verhalten Hilfreicher Assistent, Vertriebsmitarbeiter, Technischer Support, Sarkastischer Bot oder Benutzerdefinierte Persona und bearbeiten Sie die Anweisungen. Änderungen werden automatisch gespeichert; prüfen Sie vor dem Fortfahren den Speicherstatus. Beim Bearbeiten einer Voreinstellung wird daraus eine benutzerdefinierte Persona. Diese Anweisungen ergänzen ChattyBox' integrierte Grounding- und Formatierungsregeln; abgerufene Inhalte werden automatisch ergänzt – kopieren Sie daher nicht Ihre gesamte Wissensbasis in den Prompt. Persona-Text ersetzt nicht den erzwungenen Fallback bei fehlendem Kontext oder einer Inhaltslücke. Die separate Einstellung assistant.fallbackMessage ist nur über Konfiguration als Code verfügbar. Testen Sie nach dem Speichern unterstützte Fragen und das Fallback-Verhalten.

Wenn Sie das gehostete Widget verwenden möchten, können Sie unter Anpassen → Erscheinungsbild Titel, Begrüßung, Farben, Symbol, Position und Sprachverhalten in der Vorschau prüfen. Auch diese Änderungen werden automatisch gespeichert; prüfen Sie den Status. Der feste Modus und Script-Overrides beeinflussen die UI-Sprache des Widgets, nicht die Sprache der indexierten Seiten; siehe Fehlerbehebung zur Sprache. Selbst verfasster Titel- und Begrüßungstext wird nicht automatisch übersetzt. Free umfasst Styling, behält aber das ChattyBox-Branding bei; ab Starter kann es ausgeblendet werden.

Diese Entscheidungen folgen auf den Inhaltstest, damit die visuelle Einrichtung keine Probleme beim Abruf oder in der Dokumentation verdeckt.

6. Eine Integration auswählen​

ZielNächster Schritt
Die gepflegte ChattyBox-Oberfläche aus Anwendungscode einbindenJavaScript SDK
Eine eigene Oberfläche erstellen und pflegenHeadless JavaScript SDK
Einen KI-Coding-Assistenten das npm-Paket integrieren lassenKI-gestützte Integration
Die Projektkonfiguration über Git und CI verwaltenCLI und Konfigurationsbereitstellung
Die gepflegte Oberfläche ohne npm oder Build-Schritt verwendenGehostetes Widget-Skript
Das gepflegte Widget ohne Theme-Änderungen zu WordPress hinzufügenWordPress-Plugin
Das gepflegte Widget mit Composer zu Drupal 10 oder 11 hinzufügenDrupal-Modul

Browser-Integrationen benötigen einen öffentlichen Widget-API-Schlüssel. Prüfen Sie unter Installieren → Schlüssel und Domains die Ursprünge des Schlüssels: Ein für eine Website-Domain vorbereiteter Schlüssel kann bereits auf diesen Ursprung beschränkt sein; Schlüssel ohne Einschränkungen funktionieren über mehrere Ursprünge hinweg. Unter Origins bearbeiten können Sie optionale Einschränkungen aktivieren und die benötigten Produktions-, Vorschau-, Staging- und localhost-Ursprünge hinzufügen. Wenn aktiviert, erfolgt der exakte Abgleich nach Schema, Hostname und Port (z. B. sind https://example.com und http://localhost:3000 verschiedene Origins). Wählen Sie unter Installation auf der Website den Schlüssel aus und kopieren Sie das generierte Snippet und die API-URL. Ursprungseinschränkungen sind eine optionale zusätzliche Absicherung, keine Authentifizierung.

Öffentliche Widget-Schlüssel sind dafür vorgesehen, in Browsercode zu erscheinen. Tokens für die Konfigurationsbereitstellung und andere Verwaltungszugangsdaten sind vertraulich und dürfen niemals zu einer Website hinzugefügt werden.

Um das Snippet eines vorhandenen öffentlichen Schlüssels wiederzufinden, geben Sie unter Installieren → Installation auf der Website eine HTTP(S)-Website-URL ein und wählen Sie den Schlüssel aus. Die Auswahl zeigt nur nicht abgelaufene Schlüssel, die uneingeschränkt oder für die Origin dieser URL zugelassen sind. Geben Sie für einen eingeschränkten Schlüssel eine erlaubte Origin ein; unter Schlüssel und zulässige Domains verwalten können Sie seine Einschränkungen prüfen. Falls das Installationsformular nicht verfügbar ist, schließen Sie zuerst den im Dashboard angezeigten Einrichtungsschritt ab. Für einen Schlüsselwechsel erstellen Sie einen neuen Schlüssel, aktualisieren und testen Sie die Installation und löschen Sie erst danach den alten Schlüssel. Die Löschung stoppt sofort Installationen, die ihn noch verwenden. Ein Schlüssel gehört zu genau einem Chatbot; die Namen „Staging“ oder „Produktion“ schaffen keine getrennten Umgebungen.

7. Vor dem Start validieren​

Installieren Sie die ausgewählte Integration zuerst auf einer Vorschau- oder Staging-Website. Testen Sie vor der allgemeinen Veröffentlichung die bereitgestellte Origin, die Navigation zwischen Routen, Quellenangaben, Fallback-Verhalten, das mobile Layout und die Browserkonsole.

Arbeiten Sie die Start-Checkliste ab und verwenden Sie anschließend Konversationen → Verlauf in jedem Tarif. Konversationen → Analysen und Konversationen → Unbeantwortete Fragen sind in Pro und Business verfügbar. Weitere Informationen finden Sie unter Analysen und unbeantwortete Fragen.

Dashboard-Übersicht​

Ein Projekt wird unter /chatbot/<projectId> geöffnet. Die Tabs verwenden den Query-Parameter tab, keine separaten Unterseiten:

Arbeitsbereichtab-WertZweck
ÜbersichtoverviewEinrichtungsfortschritt und aktuelle Aktivitäten prüfen
Wissensbasis → Importieren und aktualisierensettingsSeiten erkennen, auswählen, importieren und aktualisieren; Quelleinstellungen anpassen
Wissensbasis → SeitencontentSeiten und Importaufträge prüfen, Inhalte löschen, Embeddings neu erstellen
Chatbot testentestFragen stellen und gespeicherte Konversationen erneut ansehen
Konversationen → VerlauflogsGespeicherte Konversationen lesen und einzelne oder alle löschen
Konversationen → AnalysenanalyticsAufgezeichnete Interaktionen der letzten 30 Tage ansehen, maximal 5.000; Pro/Business
Konversationen → Unbeantwortete FragengapsErkannte unbeantwortete Fragen prüfen und bearbeiten; Pro/Business
Anpassen → VerhaltenpromptsAnweisungen für den Assistenten auswählen oder bearbeiten
Anpassen → ErscheinungsbildappearanceErscheinungsbild und Sprache des gehosteten Widgets prüfen und anpassen
Installieren → Schlüssel und DomainskeysÖffentliche Schlüssel erstellen/löschen und optionale Origin-Einschränkungen bearbeiten
Installieren → Installation auf der WebsiteembedEine Installation vorbereiten und das Snippet eines Schlüssels kopieren
Chatbot-EinstellungenmanageChatbot-Details, Bereitstellungstokens und Konfigurationssperre verwalten oder den Chatbot löschen

Alle Chatbots führt zurück zu /dashboard. Die Kontoübersicht liegt unter /dashboard/overview; Konto & Abrechnung unter /settings/account mit Profil, Tarif, Nachrichtenverbrauch, Abrechnungsportal und PAYG-Einstellungen. /settings und /settings/billing leiten dorthin weiter. Unter /settings/keys gibt es eine Projektauswahl zum Erstellen/Löschen öffentlicher Schlüssel; optionale Origin-Einschränkungen werden im Chatbot-Arbeitsbereich unter Installieren → Schlüssel und Domains bearbeitet.

Berechtigungen und Konfigurationssperre​

Der Dashboard-Projektzugriff ist auf den Eigentümer beschränkt (oder auf den Eigentümer eines älteren Arbeitsbereichs). Ein öffentlicher Widget-Schlüssel gewährt keinen Zugriff auf Projekteinstellungen oder gespeicherte Konversationsverläufe; die Mitgliedschaft in einer Organisation allein erteilt diese Projektberechtigungen nicht.

Für die Verwaltung über Git/CI bietet Chatbot-Einstellungen Konfigurationsbereitstellungstokens mit Entwicklungs-, Vorschau- und/oder Produktionsbereichen, optionalem Ablaufdatum und Widerruf. Der vollständige Tokenwert wird nur bei der Erstellung angezeigt. Der Abschnitt zeigt auch den Bereitstellungsverlauf.

Konfigurationssperre aktivieren ist irreversibel. Sie blockiert Schreibvorgänge an der Dashboard-Konfiguration und manuelle Inhaltsaktionen, darunter Persona-Speicherungen und Jetzt scrapen, auch wenn eine entsprechende Steuerung weiterhin angezeigt wird. Stellen Sie Konfiguration stattdessen über den CLI-Workflow bereit. Verwaltung öffentlicher Schlüssel, das Löschen von Konversationen und die tarifabhängige Branding-Einstellung bleiben von den gesperrten Konfigurationsfeldern getrennt. Token-Umgebungsbereiche autorisieren Bereitstellungen; sie schaffen weder separate Chatbots noch Browser-Schlüsselumgebungen.

Die Konfiguration als Code stellt außerdem widget.enabled bereit. Der Wert false deaktiviert den öffentlichen Chat einschließlich des Headless-SDK, nicht nur das schwebende Widget. Im aktuellen Formular für das Erscheinungsbild gibt es keinen entsprechenden Schalter zum Aktivieren/Deaktivieren.

Tarife und Kontingente​

TarifChatbotsKontoseitenNachrichten pro Monat
Free110100
Starter31501.000
Pro105.00010.000
Business2525.00050.000

Nachrichten und enthaltene gespeicherte Seiten sind Eigentümerkontingente, die über die Chatbots des Eigentümers hinweg geteilt werden – einschließlich Chatbot testen. Monatliche Seitenaktualisierungen und Aktualisierungs-Cooldowns sind separate Limits. Prüfen Sie vor einem großen Import oder Neuaufbau die Aktualisierungskontingente. Unter Preise finden Sie die dokumentierten gemeinsamen Plankontingente; Konto & Abrechnung zeigt die aktuelle Nutzung und das verfügbare Kontingent Ihres Kontos.

PAYG für Nachrichten, Seiten und Websites ist bei Pro/Business optional und standardmäßig deaktiviert. Legen Sie unter Konto & Abrechnung pro Funktion ein monatliches Ausgabenlimit fest oder wählen Sie ausdrücklich Kein Ausgabenlimit. Ein Limit von null hält die Funktion hart gedeckelt; ohne Ausgabenlimit sind unbegrenzte nutzungsbasierte Gebühren möglich. PAYG schaltet keine Funktionen für Free/Starter frei und umgeht keine Aktualisierungs-Cooldowns des Crawlers. Der Profilname lässt sich dort bearbeiten; die E-Mail-Adresse wird in den Kontoeinstellungen Ihres Anmeldeanbieters verwaltet.