SilentChat

Schnellstart-Wizard — Vom Register zur ersten Bot-Antwort in 5 Minuten

Zuletzt aktualisiert: 18. November 2026

Wer SilentChat neu registriert, landet automatisch im Schnellstart-Wizard — kein zweites Passwort-Prompt, kein langes Suchen nach den ersten Schritten. Der Wizard zeigt drei Karten, die zusammen unter fünf Minuten dauern.

Was passiert direkt nach „Registrieren"?

Nach dem Klick auf „Registrieren" auf app.silentchat.de/register:

  1. Account + Tenant + Eigentümer-Rolle werden im Hintergrund angelegt
  2. Auto-Login — Sie sind sofort eingeloggt, ohne erneute Passwort-Eingabe
  3. Redirect auf /onboarding — der 3-Step-Wizard öffnet sich

Falls Ihr Tenant beim Setup gesperrt wurde (z.B. Trial-Limit erreicht), werden Sie stattdessen zur normalen Login-Seite weitergeleitet — der klassische Flow als Fallback.

Die drei Steps

Step 1 — Ihre Website

Sie geben die URL Ihrer Webseite ein. SilentChat:

  • Validiert die URL (SSRF-Schutz, Format-Check)
  • Legt die Domain nur zum Einlesen an (Marker verification_source = onboarding): Der Crawler darf sie lesen, und Ihr Widget läuft dort. Verifiziert ist sie damit nicht — als Portal- oder SSO-Domain gilt sie erst nach dem TXT-Nachweis unter Einstellungen → Domains → „Jetzt verifizieren“ (siehe Domain verifizieren)
  • Stellt den Crawler in die Warteschlange mit dem Onboarding-Profil (max. 50 Seiten, 120s Total-Timeout, Priorität 8)
  • Startet den Live-Progress-Feed: Sie sehen die ersten Seiten in 1–2 Sekunden

Übersprungen? Kein Problem — Sie können später unter Knowledge Base → Auto-Import denselben Crawl manuell auslösen. Der Bot startet dann erst mit einer leeren KB.

Step 2 — Widget einbauen

Der Wizard zeigt einen fertigen HTML-Snippet, vorbefüllt mit dem data-widget-key Ihres automatisch angelegten Standard-Widgets. Drei API-URLs sind eingebettet (api.silentchat.de, ws.silentchat.de, cdn.silentchat.de).

Wo einfügen? Vor das schließende </body>-Tag — wie bei Google Analytics oder anderen Embed-Scripts.

Kein Entwickler greifbar? Nutzen Sie eines der folgenden Plugins bzw. eine dieser Integrationen:

  • WordPress: Insert Headers and Footers (kostenfrei im WP-Plugin-Store)
  • Shopify: Customize Theme → theme.liquid, vor dem </body>
  • React / Vue / SPA: Manuelle Einbindung in die index.html oder per useEffect-Hook

Step 3 — Test-Chat

Hier kommt ein eingebettetes Test-Widget hin (in Vorbereitung). Bis dahin verlinkt der Step direkt zu Einstellungen → Widgets, wo Sie Ihr Standard-Widget im Live-Modus testen können — entweder im Preview-iframe oder auf einer beliebigen Webseite mit eingebautem Snippet.

Nach dem Klick auf „Großartig! Zur Inbox" landen Sie auf /app/dashboard — der Wizard erscheint beim nächsten Login nicht mehr.

Skip-Button

Auf jedem Step gibt es unten links einen „Zur Inbox überspringen"-Button. Damit:

  • wird der Wizard sofort als abgeschlossen markiert (wizard_completed Step in der Onboarding-Progress-Map)
  • landen Sie direkt im Dashboard
  • erscheint der Wizard beim nächsten Login nicht mehr

Geeignet für Migrationen / Bestands-Tenants / wenn Sie den Flow schon kennen.

Wizard nochmal durchlaufen?

In v1 nicht über die UI möglich — der wizard_completed Marker bleibt persistent. Wenn Sie den Wizard nochmal sehen wollen, kann ein Super-Admin den Marker per DB-Update löschen:

UPDATE onboarding_progress
   SET steps = steps - 'wizard_completed'
 WHERE tenant_id = '<ihre-tenant-id>';

Bei der nächsten Navigation zu /onboarding öffnet der Wizard wieder bei Step 1.

Bestands-Tenants

Wenn der Wizard ausgerollt wird, sehen alle bestehenden Tenants beim nächsten Login die Wizard-Seite, weil wizard_completed für sie nie gesetzt wurde. Der Skip-Button löst das in einem Klick.

Optional kann ein Super-Admin eine Ankündigungs-Email an alle Bestands-Tenants schicken (Endpoint POST /api/v1/admin/onboarding-announce/dispatch, gegated durch das RuntimeConfig-Flag onboarding_announce_email_enabled). Idempotent: schon angeschriebene Tenants werden übersprungen.

API-Referenz

EndpointBeschreibung
POST /api/v1/auth/registerLiefert Tokens in der Response (Auto-Login)
GET /api/v1/onboardingStep-Status inkl. wizard_completed Marker
PUT /api/v1/onboarding/wizard_completedMarkiert Wizard als abgeschlossen
POST /api/v1/onboarding/crawl-domainStep 1 — Crawl starten (3/24h/Tenant)

WS-Event: onboarding.crawl.progress ({ phase, current, total, last_url }).