Riferimento del tag script: tutti gli attributi e le fonti di configurazione

Il widget può essere configurato interamente tramite gli attributi del tag script, senza script inline e quindi anche con una Content Security Policy rigorosa. Se preferisce scrivere JavaScript, imposti gli stessi campi tramite window.ReactiveChatSettings o ReactiveChat('boot', …).

Aspetto, testi, schermata iniziale, regole e tour si configurano normalmente nel Suo account; vengono trasmessi dal server quando si stabilisce la connessione. Gli attributi descritti qui definiscono ciò che deve valere per ciascuna pagina. Tutte le opzioni di aspetto sono descritte in Personalizzazione.

Quattro fonti di configurazione e la loro precedenza

Prevale la fonte successiva; l’unione è superficiale (un campo oggetto come brand viene sostituito interamente, senza unione ricorsiva):

1. Valori predefiniti del widget
2. Attributi data-rc-* sul tag del caricatore
3. window.ReactiveChatSettings (impostato prima del caricatore)
4. Chiamate ReactiveChat('boot', {...}) dalla coda, nel loro ordine

I campi sconosciuti al widget vengono scartati: un attributo con un errore di battitura non produce alcun effetto né avviso.

<script>
  window.ReactiveChatSettings = { locale: 'en', position: 'left' };
</script>
<script src="https://cdn.reactive.chat/loader.js"
        data-rc-site-key="SITE_KEY"
        async></script>

Come vengono letti i valori degli attributi

Il nome viene convertito da kebab case a camel case: data-rc-site-key → siteKey. Il tipo deriva dal valore predefinito:

• Stringa – viene mantenuta invariata.
• Booleano – solo "false" e "0" sono falsi; tutto il resto, compreso un attributo vuoto, è vero.
• Lista – separata da virgole, ad esempio "idle,pointer".
• Numero o oggetto – viene letto come JSON. Se il JSON non è valido, resta il valore predefinito.

Viene letto solo il tag attualmente in esecuzione (document.currentScript). Incorpori quindi il caricatore come script classico, senza type="module".

Obbligatorio

• data-rc-site-key (stringa, obbligatorio) – la chiave del Suo progetto, disponibile nell’account in Progetto → Installazione. Formato [A-Za-z0-9_-]{8,64}. Se manca o non è valida, non si avvia nulla, senza alcun messaggio nella console.

Connessione e distribuzione

• data-rc-ws-url (stringa, facoltativo) – indirizzo della connessione della chat. Se non specificato, viene ricavato dalla posizione di loader.js (cdn.reactive.chat → wss://ws.reactive.chat/rc_wss/). Obbligatorio quando loader.js non viene caricato da cdn.reactive.chat e per i domini con suffisso composto, come .co.uk. Veda Trasporto.
• data-rc-cdn-base (stringa, facoltativo) – directory da cui vengono caricati il nucleo e i moduli. Valore predefinito: la directory di loader.js.
• data-rc-core-url (stringa, facoltativo) – indirizzo fisso del nucleo al posto di core.<hash>.js dalla stessa directory. Solo per casi particolari, come un mirror proprio.
• data-rc-transport (http, facoltativo) – impone il fallback HTTP fin dall’avvio. Funziona su qualsiasi elemento presente nel documento all’avvio; in alternativa ReactiveChatSettings.transport = 'http'. Tramite boot non ha effetto.
• data-rc-max-retries (numero, valore predefinito 2) – nuovi tentativi se il nucleo non viene caricato (intervallo 300 ms × tentativo).

Lingua, tema e movimento

• data-rc-locale (stringa, valore predefinito auto) – de, en o pl. auto usa <html lang>, poi la lingua del browser, altrimenti l’inglese. Per le altre lingue si ripiega sull’inglese.
• data-rc-theme (auto | light | dark, valore predefinito auto) – auto segue la modalità chiara/scura della Sua pagina, altrimenti quella del sistema.
• data-rc-motion (auto | reduced | full, valore predefinito auto) – animazioni; auto segue prefers-reduced-motion.
• data-rc-strings (oggetto JSON, valore predefinito {}) – sovrascrive singoli testi, ad esempio {"a11y.launcher":"Open help"}. Di norma i testi si gestiscono nell’account (Personalizzazione).

Visualizzazione e posizione

• data-rc-position (right | left, valore predefinito right) – angolo del pulsante della chat e della finestra.
• data-rc-offset (JSON, valore predefinito {"x":20,"y":20}) – distanza dal bordo in pixel, in aggiunta all’area sicura.
• data-rc-z-index (numero, valore predefinito 2147483000).
• data-rc-avoid-overlap (booleano, valore predefinito true) – evita le barre fisse sul bordo inferiore (banner dei cookie, barre del carrello).
• data-rc-hide-launcher (booleano, valore predefinito false) – nessuna icona della chat; la finestra si apre solo tramite i Suoi link o l’API JavaScript. Gli inviti vengono quindi soppressi. Vale indipendentemente dall’impostazione nell’account.
• data-rc-auto-open (booleano, valore predefinito false) – apre la finestra dopo l’avvio.
• data-rc-isolation (shadow | iframe, valore predefinito shadow) – il widget risiede in uno shadow DOM chiuso; iframe visualizza la finestra in un frame, per le pagine con stili globali molto aggressivi.
• data-rc-brand (oggetto JSON) – colore del marchio e forma del pulsante della chat. Il caricatore ne legge subito primary (#rrggbb), onPrimary, radius e launcher.shape (circle, rounded, square, bubble, leaf), launcher.size (44–72) e launcher.size_m; il nucleo controlla il resto. Il codice di incorporamento dell’account contiene già questi valori: senza un primary valido, il caricatore non mostra un pulsante della chat provvisorio, ma attende che il colore arrivi dal server (nessun cambio improvviso di colore, ma il pulsante compare più tardi). Se l’oggetto contiene solo questi campi iniziali, dopo la connessione si applica il marchio dell’account; con ulteriori campi (ad esempio accent), si applica il Suo. Dettagli in Personalizzazione.
• data-rc-logo (oggetto JSON) – src, placement (launcher, header, both), height, alt.
• data-rc-custom-css (stringa) – CSS personalizzato all’interno dello shadow DOM. Veda Personalizzazione.

Caricamento e comportamento

• data-rc-load-triggers (lista, valore predefinito tutti e cinque) – quando viene caricato il nucleo: idle (il browser è inattivo), pointer (mouse o dito sul pulsante della chat), command (un comando API diverso da boot, update, track, identify), frustration (segnale da MousePlayer), push. Prevale il primo evento di attivazione.
• data-rc-idle-timeout-ms (numero, valore predefinito 3000) – tempo limite per l’evento di attivazione idle.
• data-rc-consent (auto | granted | denied, valore predefinito auto) – stato del consenso. auto interroga la Sua piattaforma di consenso (IAB TCF v2 tramite __tcfapi, altrimenti consented.eu); granted/denied lo imposta in modo fisso. Veda Integrazione della protezione dei dati.
• data-rc-dom-spiegel (booleano, valore predefinito true) – false non invia il testo della pagina all’assistente e disattiva «Me lo mostri».
• data-rc-promo (booleano, valore predefinito true) – false nasconde la scheda promozionale su questa pagina.
• data-rc-launcher-selector (selettore CSS) – i clic sugli elementi corrispondenti aprono o chiudono la finestra. Funziona solo dopo il caricamento del nucleo; per i link che devono funzionare subito, usi data-rc-open (sotto).
• data-rc-dnd (booleano, valore predefinito false) – valore iniziale per «Non disturbare».
• data-rc-session-ttl-ms (numero, valore predefinito 1800000) – per quanto tempo viene ripresa una sessione MousePlayer.
• data-rc-debug (booleano, valore predefinito false) – messaggi diagnostici nella console. Equivale a localStorage.setItem('rc_debug', '1') nel browser.

Attributi degli altri elementi della Sua pagina

Aprire la chat (funziona subito, anche prima che il nucleo sia caricato):

• data-rc-open – su qualsiasi elemento; un clic apre la chat accanto all’elemento. data-rc-open="corner" la apre nell’angolo.
• href="#rc-open" o href="#reactive-chat" – lo stesso per i link.
• data-rc-anchor="none" – come corner.
• data-rc-message – testo inserito nel campo di input ma non inviato (massimo 200 caratteri).
• data-rc-tab – msg, home o help: quale scheda viene mostrata in primo piano.

In dettaglio: Aprire la chat da un link o pulsante proprio.

Testo sulla protezione dei dati:

• data-rc-privacy – segnaposto per la sezione su reactive.chat nella Sua informativa sulla privacy, con data-lang, data-heading (2–6) e data-email. Stato in data-rc-privacy-state (loading, done, error). Veda Integrazione della protezione dei dati.

Esclusione del testo della pagina:

• data-rc-private o, in modo equivalente, data-rc-ignore – questo sottoalbero non viene mai inviato all’assistente come testo della pagina e non viene mai indicato da «Me lo mostri».

<aside data-rc-private>
  Internal notes the assistant should not read.
</aside>

Parametri URL

• ?rc_ab=A fino a E – impone una variante di un test A/B in corso per i controlli di qualità (veda Personalizzazione).

Il widget non valuta altri parametri nell’indirizzo durante il caricamento.

Incorporamento ripetuto

Se il caricatore è presente due volte nella pagina (ad esempio tramite un modello e un tag manager), si avvia solo il primo con una chiave del sito valida; il secondo non fa nulla. Un primo tag con una chiave non valida non impedisce l’avvio di un secondo corretto.

Prosegua: API JavaScript · Eventi