Proaktive Ansprache: Tooltips, zeitgesteuerte Nachrichten und Kampagnen

Ein Ereignis auf deiner Seite löst eine Ansprache aus, etwa ein Klick, Scrollen oder eine Pause. Nach einer Wartezeit erscheint dann eine kleine Blase am Starter oder eine Nachricht im Chat. Im Konto heißt das Tooltips & zeitgesteuerte Aktionen: /app/projects/{id}, Reiter Regeln & Service.

Zwei Darstellungen

• Tooltip-Blase am Chat-Knopf – leise. Sie steht neben dem Starter, verschwindet von selbst oder per Kreuz und öffnet das Fenster nicht. Sie nimmt dem Besucher nicht den Tastaturfokus, wer gerade ein Formular ausfüllt, wird nicht herausgerissen. Auf dem Handy steht sie über dem Starter.
• Nachricht im Chat – erscheint als Nachricht im Gesprächsverlauf. Mit Chatfenster dabei öffnen springt das Fenster auf.

Wer gerade etwas nicht schafft, dem schiebt man besser kein Fenster ins Gesicht. Nimm im Zweifel die Blase.

Tooltips im Assistenten anlegen

Die Liste zeigt alle Ansprachen als Karten, mit Schalter aktiv, Bearbeiten, Duplizieren, Löschen und Verschieben. Vorgaben wiederherstellen setzt die mitgelieferten Regeln zurück. Neue Tooltips legst du in fünf Schritten an, mit Vorschau auf heller und dunkler Seite.

1. Auslöser

• Seite geöffnet – beim Aufruf einer Seite.
• Verweildauer – nach einer Mindestzeit auf der Seite. Das Widget prüft alle 30 Sekunden.
• Scrolltiefe – ab einem Prozentsatz der Seite, 1 bis 100.
• Inaktivität – keine Maus, Tastatur, Berührung oder Scrollen für 3 Sekunden bis 60 Minuten.
• Rückkehr in den Tab – der Besucher kommt nach einer Abwesenheit in den Tab zurück.
• Verlassen-Absicht – der Mauszeiger verlässt das Fenster oben. Nur am Desktop.
• Klick auf ein Element – CSS-Selektor, Pflicht.
• Maus verweilt – über einem Element, 0,2 bis 60 Sekunden (Vorgabe 1 Sekunde). Selektor Pflicht.
• Element wird sichtbar – ein Element scrollt ins Bild. Selektor Pflicht.
• Formularfeld betreten – Fokus auf einem Feld. Selektor Pflicht.
• Text kopiert – optional auf ein Element begrenzt.
• Eigenes Ereignis – aus deinem Code, siehe unten.
• Frustration – etwa ein JavaScript-Fehler auf der Seite (js_error). Weitere Signale wie wiederholte Klicks auf dieselbe Stelle oder abgebrochene Formulare liefert nur die MousePlayer-Anbindung.
• Kaufabsicht – erkannt nur mit MousePlayer.

2. Bedingungen

• Adresse enthält und enthält nicht – ein Teil der Adresse oder ein regulärer Ausdruck in der Form /muster/i.
• Kommt von – die vorherige Seite (Referrer), gleiche Schreibweise.
• Gerät – Handy oder Desktop.
• Besucher – neu oder wiederkehrend. „Wiederkehrend“ erkennt das Widget nur, wenn es etwas im Browser speichern darf, also mit Einwilligung.
• Sprache der Seite – bis zu 20 Sprachkürzel.
• Seiten in dieser Sitzung – mindestens 1 bis 100.
• Team – nur wenn jemand online ist, oder nur wenn niemand online ist.
• Geschäftszeiten – nur innerhalb oder nur außerhalb deiner Erreichbarkeit.
• Nicht während eines laufenden Gesprächs – Vorgabe. Als laufend gilt ein Gespräch, wenn das Fenster offen ist oder die letzte Nachricht weniger als 10 Minuten alt ist.

3. Zeitsteuerung

• Wartezeit in Sekunden nach dem Auslöser. Wechselt der Besucher in dieser Zeit auf eine Seite, für die der Tooltip nicht gilt, entfällt er.
• Anzeigedauer der Blase: bis der Besucher sie schließt, oder 3 bis 120 Sekunden. Ohne Angabe 15 Sekunden.
• Häufigkeit – einmal je Sitzung, je Besucher, je Gespräch, oder höchstens einmal in 10 Minuten, 1 Stunde oder 24 Stunden. „Mehrmals je Sitzung“ erlaubt 2 bis 10.
• Wichtigkeit – hoch, mittel, niedrig oder eine eigene Zahl. Treffen zwei Tooltips zugleich zu, gewinnt der wichtigere.

4. Inhalt

• Text – höchstens 500 Zeichen.
• Schnellantworten – Knöpfe unter dem Text, je höchstens 32 Zeichen: bis zu 3 an der Blase, bis zu 4 an der Nachricht. Jede Antwort hat eine Wirkung:
• Frage stellen – öffnet den Chat, zeigt deinen Satz und die Antwort des Besuchers und fragt nach, worum es geht.
• Nein danke – schließt die Blase. Dieser Tooltip kommt in der Sitzung nicht wieder.
• Rückruf anfordern – öffnet die Rückrufbitte.
• Nachricht (Standard) – schickt die Antwort als Nachricht in den Chat.
• Bild des Agenten – zeigt an der Blase den Avatar des zuständigen Teammitglieds.
• KI formuliert je Seite – statt eines festen Satzes formuliert die KI für jede Seite einen passenden Satz aus deren Inhalt. Dein Text bleibt der Rückfall.

Vorschläge und eigene Sätze je Seite

Mit KI formuliert je Seite kannst du Vorschläge für die 20 meistbesuchten Seiten erzeugen lassen, höchstens einmal je Minute. Sie entstehen im Hintergrund, meist binnen einer Minute. Jeden Vorschlag kannst du durch einen eigenen Text ersetzen (höchstens 500 Zeichen). Er gilt für diese Seite, bis du ihn verwirfst, die KI überschreibt ihn nie. Ein verworfener Vorschlag wird beim nächsten Besuch der Seite neu formuliert.

Was immer gilt

Damit Ansprachen nicht nerven, gelten feste Regeln, die du nicht abschalten kannst:

• Höchstens eine Ansprache je 10 Minuten und Besucher. Ausgenommen sind Tooltips auf Klick, Mausverweilen und Formularfeld: Sie antworten auf eine Handlung des Besuchers.
• Keine Blase, solange das Chatfenster offen ist oder der Starter ausgeblendet ist.
• Höchstens 3 Blasen je Sitzung.
• Weggeklickt ist weggeklickt: Derselbe Tooltip kommt in dieser Sitzung nicht wieder.
• Nicht stören: Hat deine Seite den Besucher auf „nicht stören“ gesetzt (siehe unten), kommt keine Ansprache.

Tarif

Im kostenlosen Tarif ist 1 aktiver Tooltip je Projekt möglich, ab Professional unbegrenzt viele. Gezählt werden aktive Blasen und Nachrichten in der Reihenfolge der Liste. Wer über die Grenze speichern will, bekommt eine Meldung. Fällt ein Workspace in den kostenlosen Tarif zurück, bleiben überzählige Tooltips gespeichert, werden aber nicht ausgeliefert.

Für Fortgeschrittene: Regeln als JSON

Unter dem Assistenten steht Experten: Regeln als JSON. Dort steht dieselbe Liste als JSON, die du direkt bearbeiten kannst. Leer heißt: die Vorgaben von reactive.chat. Beim Speichern wird streng geprüft. Ein Fehler nennt die Regel und das Feld.

[
  {
    "id": "preise-hilfe",
    "enabled": true,
    "priority": 50,
    "when": { "event": "scroll", "minScrollPct": 60, "urlMatch": "/preise" },
    "unless": { "conversationActive": true },
    "throttle": { "max": 1, "per": "session" },
    "delayMs": 2000,
    "action": {
      "type": "teaser",
      "text": "Fragen zu den Tarifen? Ich helfe gern.",
      "quickReplies": ["Ja, eine Frage", "Nein danke"],
      "replyRoles": ["ask", "dismiss"],
      "ttlMs": 20000
    }
  }
]

Die wichtigsten Grenzen:

• höchstens 50 Regeln, insgesamt 60.000 Zeichen,
• id: Kleinbuchstaben, Ziffern und Bindestrich, höchstens 40 Zeichen,
• priority: 0 bis 1000, die kleinere Zahl gewinnt, Vorgabe 100,
• delayMs: 0 bis 86.400.000 (24 Stunden),
• ttlMs (nur Blase): 0 bis 120.000, 0 heißt bis zum Schließen,
• throttle.max: 1 bis 100, throttle.per: session, visitor, conversation, 10m, 1h, 24h,
• action.type: teaser (Blase) oder proactive_message (Nachricht, mit openWidget),
• Muster und Selektoren höchstens 200 Zeichen,
• Felder, die mit _ beginnen, gelten als Kommentar.

Unbekannte Felder werden abgewiesen, ein Tippfehler fällt also beim Speichern auf.

Per Code: eine Blase zeigen

Aus deinem eigenen Code zeigst du eine Blase am Starter, etwa nach einer Handlung auf deiner Seite:

ReactiveChat('show', 'Fragen zum Tarif? Schreib uns.');

ReactiveChat('showTeaser', {
  text: 'Fragen zum Tarif?',
  quickReplies: ['Ja', 'Nein danke'],
  ttlMs: 15000,
  ruleId: 'tarif-kampagne'
});

ReactiveChat('hide');

Auch diese Blasen halten sich an die Regeln oben. showTeaser gibt zurück, ob die Blase gezeigt wurde. Die Ereignisse teaser:shown, teaser:click, teaser:dismiss und teaser:reply meldet das Widget über ReactiveChat('on', …).

Per Code: eigene Ereignisse als Auslöser

Für den Auslöser Eigenes Ereignis meldest du einen Meilenstein aus deiner Seite:

ReactiveChat('track', 'warenkorb_voll');

Im Tooltip trägst du denselben Namen ein.

Nicht stören

Soll ein Besucher gar nicht angesprochen werden, etwa während eines Bezahlvorgangs, setz am Schnipsel:

data-rc-dnd="true"

Der Chat bleibt erreichbar, nur proaktive Ansprachen entfallen.

Kampagnen

Für gezielte Aktionen gibt es unter /app/projects/{id}/campaigns Kampagnen: eine Nachricht im Chat an eine genau beschriebene Zielgruppe, auf Wunsch mit Variante B. Kampagnen gibt es ab dem Professional-Tarif.

• Nachricht höchstens 500 Zeichen, bis zu 3 Antwortknöpfe, optional mit geöffnetem Fenster.
• Variante B mit einem Anteil von 1 bis 99 %, Vorgabe 50 %.
• Zielgruppe nach Seiten, Verweildauer, Herkunft, UTM-Parametern, neuen oder wiederkehrenden Besuchern, Land, Sprache, Gerät, angemeldeten oder anonymen Besuchern und – mit Kundendaten – etwa nach dem Status einer Bestellung.
• Häufigkeit je Besucher 1 bis 50 (Vorgabe 1) und ein Mindestabstand von 1 bis 2160 Stunden (Vorgabe 24).
• Zeitraum mit Start und Ende.
• Wirkung: zugestellt, gesehen, geklickt, Gespräch gestartet, Ziel erreicht.

Kampagnen teilen sich die 10-Minuten-Grenze mit den Tooltips und kommen nie während eines laufenden Gesprächs. Besucher aus der EU, dem EWR, der Schweiz und Großbritannien und Besucher mit unbekanntem Land erreichen sie nur mit Einwilligung. Wie du Kampagnen planst und auswertest, beschreibt das Produkt-Handbuch.

Wenn eine Ansprache nicht erscheint

• Ist sie aktiv und im Tarif erlaubt?
• War in den letzten 10 Minuten schon eine Ansprache?
• Läuft ein Gespräch oder ist das Fenster offen?
• Hat der Besucher sie schon weggeklickt oder ist die Häufigkeit erreicht?
• Passen die Bedingungen, etwa Adresse, Gerät oder Geschäftszeiten?
• Ist der Starter ausgeblendet? Dann gibt es keine Blase. Nimm eine Nachricht im Chat.
• Auslöser Frustration oder Kaufabsicht? Bis auf JavaScript-Fehler kommen diese Signale nur mit MousePlayer.