Messaggi proattivi: tooltip, messaggi programmati e campagne

Un evento sulla pagina attiva un avviso, ad esempio un clic, lo scorrimento o una pausa. Dopo un’attesa compare un piccolo fumetto accanto al pulsante della chat oppure un messaggio nella chat. Nell’account si chiama Tooltip e azioni programmate: /app/projects/{id}, scheda Regole e servizio.

Due visualizzazioni

• Fumetto del tooltip sul pulsante della chat: discreto. Sta accanto al pulsante, scompare da solo o tramite la croce e non apre la finestra. Non sottrae il focus della tastiera al visitatore, quindi non interrompe chi sta compilando un modulo. Sui telefoni sta sopra il pulsante.
• Messaggio nella chat: appare come messaggio nella conversazione. Con Apri anche la finestra della chat si apre la finestra.

Se qualcuno sta incontrando difficoltà, è meglio non aprirgli una finestra davanti. Nel dubbio, usi il fumetto.

Creare tooltip nell’assistente

L’elenco mostra tutti gli avvisi come schede, con interruttore attivo, Modifica, Duplica, Elimina e pulsanti per spostarli. Ripristina predefiniti reimposta le regole fornite. Crea nuovi tooltip in cinque passi, con anteprima su pagina chiara e scura.

1. Attivatore

• Pagina aperta: all’apertura di una pagina.
• Tempo sulla pagina: dopo un tempo minimo. Il widget verifica ogni 30 secondi.
• Profondità di scorrimento: da una percentuale della pagina, da 1 a 100.
• Inattività: nessun mouse, tastiera, tocco o scorrimento per un periodo da 3 secondi a 60 minuti.
• Ritorno alla scheda: il visitatore torna alla scheda dopo essersene allontanato.
• Intenzione di uscita: il puntatore lascia la finestra dal bordo superiore. Solo desktop.
• Clic su un elemento: selettore CSS obbligatorio.
• Permanenza del mouse: su un elemento, da 0,2 a 60 secondi (predefinito 1 secondo). Selettore obbligatorio.
• Elemento visibile: un elemento entra nell’area visibile durante lo scorrimento. Selettore obbligatorio.
• Ingresso in un campo del modulo: focus su un campo. Selettore obbligatorio.
• Testo copiato: facoltativamente limitato a un elemento.
• Evento personalizzato: dal Suo codice, vedere sotto.
• Segnali di frustrazione: ad esempio un errore JavaScript sulla pagina (js_error). Altri segnali, come clic ripetuti nello stesso punto o moduli abbandonati, sono forniti solo dal collegamento MousePlayer.
• Intenzione di acquisto: rilevata solo con MousePlayer.

2. Condizioni

• L’indirizzo contiene e L’indirizzo non contiene: parte dell’indirizzo o espressione regolare nel formato /pattern/i.
• Proviene da: pagina precedente (referrer), stessa notazione.
• Dispositivo: telefono o desktop.
• Visitatori: nuovi o di ritorno. Il widget può riconoscere un visitatore di ritorno solo se può memorizzare dati nel browser, quindi con consenso.
• Lingua della pagina: fino a 20 codici lingua.
• Pagine in questa sessione: minimo da 1 a 100.
• Team: solo quando qualcuno è online o solo quando nessuno è online.
• Orario di servizio: solo entro o solo fuori dalla disponibilità.
• Non durante una conversazione in corso: predefinito. Una conversazione è in corso se la finestra è aperta o l’ultimo messaggio risale a meno di 10 minuti prima.

3. Tempi

• Attesa in secondi dopo l’attivatore. Se nel frattempo il visitatore passa a una pagina a cui il tooltip non si applica, viene scartato.
• Durata della visualizzazione del fumetto: fino alla chiusura del visitatore oppure da 3 a 120 secondi. Senza valore, 15 secondi.
• Frequenza: una volta per sessione, visitatore, conversazione oppure al massimo ogni 10 minuti, 1 ora o 24 ore. «Più volte per sessione» consente da 2 a 10.
• Importanza: alta, media, bassa o un numero personalizzato. Se due tooltip si applicano contemporaneamente, vince il più importante.

4. Contenuto

• Testo: massimo 500 caratteri.
• Risposte rapide: pulsanti sotto il testo, massimo 32 caratteri ciascuno: fino a 3 nel fumetto, fino a 4 nel messaggio. Ogni risposta ha un effetto:
• Fai una domanda: apre la chat, mostra la Sua frase e la risposta del visitatore e chiede di che cosa si tratta.
• No grazie: chiude il fumetto. Questo tooltip non torna nella sessione.
• Richiedi una richiamata: apre la richiesta di richiamata.
• Messaggio (predefinito): invia la risposta come messaggio nella chat.
• Immagine dell’operatore: mostra sul fumetto l’avatar del membro del team assegnato.
• L’IA ne scrive uno per pagina: anziché una frase fissa, l’IA scrive per ogni pagina una frase adatta dai suoi contenuti. Il Suo testo rimane come alternativa.

Suggerimenti e frasi personalizzate per pagina

Con L’IA ne scrive uno per pagina, può far creare suggerimenti per le 20 pagine più visitate, al massimo una volta al minuto. Vengono scritti in background, solitamente entro un minuto. Può sostituire ciascun suggerimento con un testo personalizzato (massimo 500 caratteri). Si applica a quella pagina finché non lo scarta; l’IA non lo sovrascrive mai. Un suggerimento scartato viene riscritto alla visita successiva della pagina.

Regole sempre valide

Per evitare che gli avvisi disturbino, valgono regole fisse che non può disattivare:

• Al massimo un avviso ogni 10 minuti per visitatore. Sono esclusi i tooltip su clic, permanenza del mouse e campo del modulo, perché rispondono a un’azione del visitatore.
• Nessun fumetto mentre la finestra della chat è aperta o il pulsante è nascosto.
• Massimo 3 fumetti per sessione.
• Chiuso significa chiuso: lo stesso tooltip non torna nella sessione.
• Non disturbare: se la pagina ha impostato il visitatore su «non disturbare» (vedere sotto), non compare alcun avviso.

Piano

Nel piano gratuito è possibile 1 tooltip attivo per progetto; da Professional quanti ne desidera. Fumetti e messaggi attivi vengono contati nell’ordine dell’elenco. Chi tenta di salvare oltre il limite riceve un messaggio. Se uno spazio di lavoro torna al piano gratuito, i tooltip in eccesso restano salvati ma non vengono consegnati.

Per utenti esperti: regole in JSON

Sotto l’assistente trova Per esperti: regole in JSON. Contiene lo stesso elenco in JSON, modificabile direttamente. Vuoto significa i valori predefiniti di reactive.chat. Il salvataggio esegue una verifica rigorosa. Un errore indica regola e campo.

[
  {
    "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": "Questions about our plans? Happy to help.",
      "quickReplies": ["Yes, I have a question", "No thanks"],
      "replyRoles": ["ask", "dismiss"],
      "ttlMs": 20000
    }
  }
]

I limiti principali:

• Massimo 50 regole, 60.000 caratteri complessivi,
• id: lettere minuscole, cifre e trattini, massimo 40 caratteri,
• priority: da 0 a 1000, vince il numero minore, predefinito 100,
• delayMs: da 0 a 86.400.000 (24 ore),
• ttlMs (solo fumetto): da 0 a 120.000, 0 significa fino alla chiusura,
• throttle.max: da 1 a 100, throttle.per: session, visitor, conversation, 10m, 1h, 24h,
• action.type: teaser (fumetto) o proactive_message (messaggio, con openWidget),
• modelli e selettori di massimo 200 caratteri,
• i campi che iniziano con _ contano come commenti.

I campi sconosciuti vengono rifiutati, così gli errori di battitura si notano al salvataggio.

Nel codice: mostrare un fumetto

Dal Suo codice mostra un fumetto accanto al pulsante, ad esempio dopo un’azione sulla pagina:

ReactiveChat('show', 'Questions about your plan? Write to us.');

ReactiveChat('showTeaser', {
  text: 'Questions about your plan?',
  quickReplies: ['Yes', 'No thanks'],
  ttlMs: 15000,
  ruleId: 'tarif-kampagne'
});

ReactiveChat('hide');

Anche questi fumetti seguono le regole sopra. showTeaser restituisce se il fumetto è stato mostrato. Il widget comunica gli eventi teaser:shown, teaser:click, teaser:dismiss e teaser:reply tramite ReactiveChat('on', …).

Nel codice: eventi personalizzati come attivatori

Per l’attivatore Evento personalizzato, segnala un traguardo dalla pagina:

ReactiveChat('track', 'warenkorb_voll');

Nel tooltip inserisce lo stesso nome.

Non disturbare

Se un visitatore non deve ricevere alcun avviso, ad esempio durante il checkout, aggiunga questo al codice di incorporamento:

data-rc-dnd="true"

La chat resta raggiungibile; vengono omessi solo gli avvisi proattivi.

Campagne

Per promozioni mirate sono disponibili le Campagne in /app/projects/{id}/campaigns: un messaggio nella chat per destinatari descritti con precisione, anche con una variante B se desidera. Le campagne sono disponibili dal piano Professional.

• Messaggio di massimo 500 caratteri, fino a 3 pulsanti di risposta, facoltativamente con apertura della finestra.
• Variante B con quota dall’1 al 99 %, predefinita 50 %.
• Destinatari in base a pagine, tempo sulla pagina, provenienza, parametri UTM, visitatori nuovi o di ritorno, Paese, lingua, dispositivo, visitatori autenticati o anonimi e, con i dati dei clienti, ad esempio stato di un ordine.
• Frequenza per visitatore da 1 a 50 (predefinita 1) e intervallo minimo da 1 a 2160 ore (predefinito 24).
• Programmazione con inizio e fine.
• Rendimento: consegnata, vista, cliccata, conversazione avviata, obiettivo raggiunto.

Le campagne condividono il limite di 10 minuti con i tooltip e non arrivano mai durante una conversazione in corso. I visitatori di UE, SEE, Svizzera e Regno Unito, e quelli con Paese sconosciuto, vengono raggiunti solo con consenso. Come pianificare e valutare le campagne è descritto nel manuale del prodotto.

Se un avviso non compare

• È attivo e consentito dal piano?
• C’è già stato un avviso negli ultimi 10 minuti?
• È in corso una conversazione o la finestra è aperta?
• Il visitatore lo ha già chiuso o è stata raggiunta la frequenza?
• Le condizioni corrispondono, come indirizzo, dispositivo o orario di servizio?
• Il pulsante della chat è nascosto? Non compare alcun fumetto. Usi un messaggio nella chat.
• Attivatore frustrazione o intenzione di acquisto? A parte gli errori JavaScript, questi segnali arrivano solo con MousePlayer.