Quick-start wizard — from sign-up to the first bot reply in 5 minutes
When you sign up for SilentChat you land in the quick-start wizard automatically — no second password prompt, no hunting for the first steps. The wizard shows three cards that together take under five minutes.
What happens right after "Register"?
After you click "Register" on app.silentchat.de/register:
- Account, tenant and owner role are created in the background
- Automatic login — you are signed in at once, without entering your password again
- Redirect to
/onboarding— the 3-step wizard opens
If your tenant was blocked during setup (for example because the trial limit was reached), you are sent to the normal login page instead — the classic flow as a fallback.
The three steps
Step 1 — Your website
You enter the URL of your website. SilentChat:
- Validates the URL (SSRF protection, format check)
- Creates the domain for reading only (marker
verification_source = onboarding): the crawler may read it and your widget runs there. It is not verified by that — it only counts as a portal or SSO domain after the TXT proof under Settings → Domains → "Verify now" (see Verify a domain) - Queues the crawler with the onboarding profile (max. 50 pages, 120 s total timeout, priority 8)
- Starts the live progress feed: you see the first pages within 1–2 seconds
Skipped it? No problem — you can start the same crawl manually later under Knowledge Base → Auto import. The bot then starts with an empty knowledge base.
Step 2 — Add the widget
The wizard shows a ready-made HTML snippet, pre-filled with the data-widget-key of your automatically created default widget. Three API URLs are embedded (api.silentchat.de, ws.silentchat.de, cdn.silentchat.de).
Where to paste it? Before the closing </body> tag — like Google Analytics or other embed scripts.
No developer at hand? Use one of these plugins or integrations:
- WordPress: Insert Headers and Footers (free in the WP plugin store)
- Shopify: Customize Theme → theme.liquid, before the
</body> - React / Vue / SPA: add it manually to
index.htmlor via auseEffecthook
Step 3 — Test chat
An embedded test widget will go here (in preparation). Until then the step links straight to Settings → Widgets, where you can test your default widget in live mode — either in the preview iframe or on any web page with the snippet installed.
After you click "Great! To the inbox" you land on /app/dashboard — the wizard does not appear again at your next login.
Skip button
Every step has a "Skip to inbox" button at the bottom left. It:
- marks the wizard as completed at once (
wizard_completedstep in the onboarding progress map) - takes you straight to the dashboard
- keeps the wizard from appearing at your next login
Suited for migrations, existing tenants, or if you already know the flow.
Run the wizard again?
Not possible through the UI in v1 — the wizard_completed marker stays. If you want to see the wizard again, a super admin can delete the marker with a database update:
UPDATE onboarding_progress
SET steps = steps - 'wizard_completed'
WHERE tenant_id = '<your-tenant-id>';
On your next visit to /onboarding the wizard opens at step 1 again.
Existing tenants
When the wizard is rolled out, all existing tenants see the wizard page at their next login, because wizard_completed was never set for them. The skip button solves that in one click.
Optionally a super admin can send an announcement email to all existing tenants (endpoint POST /api/v1/admin/onboarding-announce/dispatch, gated by the runtime-config flag onboarding_announce_email_enabled). Idempotent: tenants that were already contacted are skipped.
API reference
| Endpoint | Description |
|---|---|
POST /api/v1/auth/register | Returns tokens in the response (automatic login) |
GET /api/v1/onboarding | Step status including the wizard_completed marker |
PUT /api/v1/onboarding/wizard_completed | Marks the wizard as completed |
POST /api/v1/onboarding/crawl-domain | Step 1 — start the crawl (3/24h/tenant) |
WS event: onboarding.crawl.progress ({ phase, current, total, last_url }).