SilentChat

Konfiguration

Nach der Installation entscheidet die Konfiguration, wie sich das Widget verhält. Alle Einstellungen lassen sich pro Widget im Dashboard unter Einstellungen → Widgets vornehmen.

Branding

Damit sich das Widget in Ihre Seite einfügt:

  • Akzentfarbe für Header, Buttons und Bot-Avatar.
  • Logo (SVG oder PNG, max. 64×64 px) im Chat-Header.
  • Position links oder rechts unten, mit konfigurierbarem Abstand zum Viewport.

Servicezeiten

Tragen Sie Ihre Bürozeiten ein, damit das Widget außerhalb der Zeiten einen Offline-Hinweis statt eines Online-Signals zeigt. Zeitzone, Wochentage und Feiertage lassen sich getrennt pflegen.

Begrüßungstexte

Online- und Offline-Begrüßung sind getrennte Felder und werden je nach Servicezeit automatisch ausgewählt:

{
  "online": "Hi 👋 — wir sind hier. Wie können wir helfen?",
  "offline": "Wir sind gerade offline, antworten aber meist binnen einer Stunde."
}

Consent-Modus

Standardmäßig nutzt das Widget einen anonymen Besuchermodus ohne personenbezogene Daten — kein Einwilligungsbanner nötig. Brauchen Sie Profile mit Name und E-Mail, schalten Sie die Einwilligung ein.

Origin-Whitelist

Tragen Sie alle Domains ein, auf denen das Widget laufen darf. Anfragen von anderen Herkünften lehnt das Backend ab — das verhindert, dass Ihr Widget-Schlüssel auf fremden Seiten benutzt wird.

UX & Engagement

Im Widget-Editor unter dem Reiter UX & Engagement finden Sie eine Reihe von Schaltern, die das Verhalten des Launchers, der Abschlusshelfer und der Bedienkomfort-Optionen steuern.

Launcher

  • show_response_time_indicator — Zeigt eine geschätzte Antwortzeit (Mittel über die letzten 7 Tage) als kleine Pille über dem Chat-Bubble. Aggregat, kein PII. Default aus.
  • show_agent_identity_in_launcher — Zeigt Vorname + Avatar online verfügbarer Agents im Launcher. Agents müssen zusätzlich im eigenen Profil public_display aktivieren. Default aus (Mitarbeiter-PII).

Engagement / Conversion

  • exit_intent (Trigger-Condition) — Feuert, wenn der Maus-Cursor das Browserfenster nach oben verlässt. Über den Trigger-Editor verwendbar, um eine kontextspezifische Begrüßung zu setzen statt sofort den Chat aufzuklappen.
  • quick_actions — Bis zu 6 Karten im HomeScreen mit den Aktionen chat, kb, external_link, booking_link (Allowlist: Calendly, cal.com, SavvyCal, TidyCal, Acuity), email (mailto) oder prefilled_chat (vorgefüllter Composer-Text).
  • enable_persistent_resume — Persistente Chat-Wiederaufnahme über 30 Tage mit signiertem Token (HMAC-SHA256) und Email-Hash. DSGVO-relevant — Default aus. Details siehe DSGVO-Doku.

Bedienkomfort

  • enable_drag_and_drop_upload — Datei per Drag & Drop ins Chat-Fenster ziehen löst denselben Upload-Pfad wie der Paperclip-Button aus. Default an.
  • enable_sound_toggle_in_footer — Glocken-Icon im Chat-Header, um den Benachrichtigungston pro Session stummzuschalten. Persistiert in localStorage. Default an.
  • enable_open_hotkey — Öffnet das Widget mit / oder Strg+K. Blockiert in Inputs/Textareas/contenteditable. Default aus, weil / mit Site-Search-Shortcuts kollidieren kann.
  • enable_mobile_swipe_close — Auf Mobile (≤480px) wischt der Besucher das Widget weg: floating nach unten, side_panel-right nach rechts, side_panel-left nach links. Default an.

Agent-Tools

Im Agent-Composer öffnet der Kalender-Button einen Dialog, in den ein Calendly-/cal.com-/SavvyCal-/TidyCal-/Acuity-Link eingefügt werden kann. Beim Visitor erscheint die Booking-Card mit klickbarem CTA statt eines nackten Links. Backend prüft Allowlist-Hosts und HTTPS.

DSGVO-Hinweis: enable_persistent_resume und show_agent_identity_in_launcher sind die einzigen Schalter mit erheblicher Datenschutz-Implikation. Aktivieren nur mit aktualisierter Datenschutzerklärung und entsprechendem Consent-Banner-Hinweis.

Konfiguration | SilentChat