Erste Schritte
In der bevorstehenden Version werden enthaltene Seiten über die Projekte eines Eigentümers geteilt; bis zum Rollout kann das öffentliche Dashboard noch die bisherigen Chatbot-Limits zeigen.
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 New Chatbot und geben Sie dem Projekt einen Namen und optional eine Website-URL. Nach der Erstellung öffnen Sie den Chatbot aus der Projektliste. Sein Standardtab ist Content; die Erstellung startet keinen Scrape.
Unter Preise finden Sie die aktuellen Limits für Projekte, Seiten und Nutzung.
2. Inhaltsquelle konfigurieren
Öffnen Sie Settings. Speichern Sie unter General Settings die öffentliche Website URL mit Save Changes. Wählen Sie unter Scraping Configuration Discovery-Modus, maximale Seiten und optionalen Zeitplan und speichern Sie mit Save Config. Dies sind getrennte Formulare; Include/Exclude-Regeln und Crawl-Tiefe gibt es nur über Konfiguration als Code.
Führen Sie Scrape now aus. ChattyBox extrahiert lesbares öffentliches HTML und stellt geänderte Inhalte zum Indexieren an. Es rendert kein JavaScript und setzt robots.txt nicht durch; verwenden Sie nur autorisierte öffentliche Quellen.
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
Kehren Sie zu Content zurück und vergleichen Sie die tatsächlichen mit den erwarteten Seiten. Ein abgeschlossener Scrape garantiert weder jede URL noch jeden Abschnitt: Prüfen Sie Teilindex-Warnungen und den getrennten Embedding-Status vor der Bewertung.
4. Antwortqualität testen
Öffnen Sie Test Chat 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 Quelle oder Auswahl und scrapen Sie erneut, wenn der Cooldown es erlaubt: Free höchstens wöchentlich, bezahlte Tarife höchstens täglich. Test Chat verbraucht Nachrichtenkontingent und erscheint zusammen mit öffentlichem Chat in Logs, Analytics und Content Gaps.
5. Benutzererlebnis anpassen
Mit Persona wählen Sie Helpful Assistant, Sales Representative, Technical Support, Sarcastic Bot oder Custom Persona, bearbeiten Anweisungen und speichern sie. Persona ergänzt Grounding-Regeln und kann fehlenden Kontext nicht liefern oder den erzwungenen Fallback ersetzen; assistant.fallbackMessage ist nur per Konfiguration als Code verfügbar. Unter Embed prüfen und speichern Sie Widget-Titel, Begrüßung, Farben, Symbol, Position und Sprachverhalten.
Diese Entscheidungen folgen auf den Inhaltstest, damit die visuelle Einrichtung keine Probleme beim Abruf oder in der Dokumentation verdeckt.
6. Eine Integration auswählen
| Ziel | Nächster Schritt |
|---|---|
| Die gepflegte ChattyBox-Oberfläche aus Anwendungscode einbinden | JavaScript SDK |
| Eine eigene Oberfläche erstellen und pflegen | Headless JavaScript SDK |
| Einen KI-Coding-Assistenten das npm-Paket integrieren lassen | KI-gestützte Integration |
| Die Projektkonfiguration über Git und CI verwalten | CLI und Konfigurationsbereitstellung |
| Die gepflegte Oberfläche ohne npm oder Build-Schritt verwenden | Gehostetes Widget-Skript |
| Das gepflegte Widget ohne Theme-Änderungen zu WordPress hinzufügen | WordPress-Plugin |
| Das gepflegte Widget mit Composer zu Drupal 10 oder 11 hinzufügen | Drupal-Modul |
Browser-Integrationen benötigen einen öffentlichen Widget-API-Schlüssel. Öffentliche Schlüssel funktionieren standardmäßig in Produktion, Vorschauen, Staging und auf localhost. Für eine optionale zusätzliche Absicherung öffnen Sie Public Keys > Edit origins, aktivieren Sie Restrict this key to specific origins und fügen Sie jeden zulässigen Browser-Ursprung hinzu. Eingeschränkte Origins werden exakt nach Schema, Hostname und Port abgeglichen (beispielsweise sind https://example.com und http://localhost:3000 unterschiedliche Origins). Kehren Sie zu Embed zurück, um den Schlüssel auszuwählen und das generierte Snippet sowie die API-URL zu kopieren.
Ö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.
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.
Führen Sie die Start-Checkliste durch und verwenden Sie anschließend Logs in jedem Tarif sowie Analytics und Content Gaps in Pro/Business.
Dashboard-Karte
Unter /chatbot/<projectId> sind Content, Test Chat, Logs, Analytics (letzte 30 Tage, höchstens 5.000 Interaktionen; Pro/Business), Content Gaps (Pro/Business), Persona, Public Keys, Embed und Settings Tabs. Account & Billing liegt unter /settings/account; Nachrichten, gespeicherte Seiten, monatliches Refresh-Budget und Cooldowns sind getrennte Limits. Config lock ist irreversibel und blockiert Dashboard-Schreibvorgänge sowie manuelle Content-Aktionen; öffentliche Schlüssel, Konversationslöschung und die tarifabhängige Branding-Einstellung bleiben getrennt.