Testi e lingue

Il widget usa tedesco, inglese e polacco. Ciascuno dei suoi circa 200 testi può essere sostituito: nell’account per tutte le pagine oppure nel codice per singole pagine.

Come il widget sceglie la lingua

Il widget si trova all’interno della Sua pagina. Ciò che il visitatore sta leggendo conta quindi più dell’impostazione del browser. L’ordine:

1. Una lingua scelta dalla Sua pagina per questo visitatore tramite ReactiveChat('setLocale', …) (veda sotto).
2. Una lingua fissa nel codice di incorporamento (data-rc-locale) o nella configurazione.
3. Altrimenti la lingua della pagina da <html lang="…">.
4. Altrimenti la lingua predefinita nell’account.
5. Altrimenti la lingua del browser e, infine, l’inglese.

I codici regionali vengono abbreviati: de-AT diventa de. Una lingua sconosciuta al widget diventa inglese.

La cosa più importante è quindi un <html lang> corretto sulle Sue pagine. Il widget segue così autonomamente ogni versione linguistica del sito.

La lingua predefinita nell’account

In /app/projects/{id}, scheda Installazione, sezione Dati di base, scelga la Lingua predefinita: de, en o pl. Ha due funzioni:

• Si applica ai visitatori sulle pagine senza <html lang>, se il codice di incorporamento non imposta una lingua.
• È la lingua in cui scrive i testi personalizzati, la schermata iniziale e la scheda promozionale (veda sotto).

Impostare la lingua nel codice

Fissa per una pagina, nel codice di incorporamento:

<script src="https://cdn.reactive.chat/loader.js"
        data-rc-site-key="SITE_KEY"
        data-rc-locale="pl"
        async></script>

Durante l’esecuzione, ad esempio dal Suo selettore della lingua:

ReactiveChat('setLocale', 'en');

setLocale cambia subito le diciture del widget. Il widget ricorda la scelta per un anno nel browser del visitatore, e questa prevale anche su data-rc-locale nelle altre pagine. Nel widget stesso non c’è un selettore della lingua. Se i visitatori devono scegliere, chiami setLocale dal Suo selettore.

Testi personalizzati nell’account

Nella scheda Testi e moduli, sezione Testi personalizzati, è elencato ogni testo del widget con la relativa chiave, raggruppato per area in sezioni chiuse. Il nostro testo compare in grigio nel campo. Ciò che inserisce lo sostituisce. Il titolo indica quanti testi personalizzati ha già.

• Massimo 400 caratteri per testo.
• Lasciare vuoto significa usare il nostro testo.
• Un testo identico al nostro non viene salvato.
• Il widget compila i segnaposto tra parentesi graffe come {n}, {name} o {time}. Li mantenga nel testo se vuole mostrare il valore.

Importante per la lingua: digiti i testi nella lingua predefinita del progetto, e lì hanno effetto. I visitatori il cui widget usa un’altra lingua continuano a vedere i nostri testi forniti. Per testi personalizzati in altre lingue, usi il codice (sotto), idealmente sulle pagine della rispettiva versione linguistica.

Le modifiche raggiungono i visitatori entro un minuto.

Le chiavi più importanti

Un estratto, per area:

• launcher.text, launcher.subtext – dicitura e seconda riga del pulsante della chat. Vuoti inizialmente; un inserimento prevale sui campi in Aspetto → Marchio.
• launcher.label – la dicitura del pulsante della chat letta dagli screen reader («Apri la chat»).
• header.title, header.subtitle_online, header.subtitle_bot, header.response_time – titolo e seconde righe dell’intestazione.
• home.greeting, home.sub, home.start, home.start_sub – saluto e punto di accesso della schermata iniziale (il saluto si imposta più facilmente in Schermata iniziale).
• tabs.home, tabs.messages, tabs.help – le schede.
• input.placeholder e altri input.* – il campo di input.
• offline.* – il modulo «Lasci un messaggio».
• prechat.* – il modulo pre-chat.
• bh.* – avvisi sull’orario di servizio.
• ds.* e daten.* – consenso e scheda «I Suoi dati».
• msg.ki_notice – l’avviso prima della prima risposta dell’assistente IA.
• csat.* – la valutazione dopo la conversazione.
• transcript.*, upload.*, handoff.*, queue.*, teaser.*, err.* – conversazione via e-mail, allegati, passaggio al team, coda, fumetto del tooltip e messaggi di errore.

Può vedere l’elenco completo nell’account.

La nota «Powered by reactive.chat» (veda Finestra della chat) e i testi dei tour del prodotto (veda Tour del prodotto) non possono essere modificati tramite i testi.

Sostituire testi nel codice

Nel codice di incorporamento con data-rc-strings come JSON, chiavi in notazione con punti:

<script src="https://cdn.reactive.chat/loader.js"
        data-rc-site-key="SITE_KEY"
        data-rc-locale="en"
        data-rc-strings='{"input.placeholder":"Your question about your order …","header.title":"Customer service"}'
        async></script>

Oppure nella configurazione:

ReactiveChat('boot', {
  strings: { 'input.placeholder': 'Your question about your order …' }
});

Una seconda chiamata boot sulla stessa pagina carica nuove strings. In questo modo può, ad esempio, modificare i testi dopo l’accesso.

I testi impostati nel codice valgono allo stesso modo in ogni lingua. Li imposti quindi su pagine la cui lingua è fissa e imposti anche lì la lingua.

Ordine di precedenza, dal più forte al più debole:

1. Testi nel codice (strings): si applicano solo alla pagina in cui sono presenti.
2. Testi personalizzati dall’account, nella lingua predefinita.
3. I nostri testi forniti nella lingua del visitatore.
4. Inglese.

Il codice prevale volutamente: se vuole usare diciture diverse su una singola pagina, lo fa lì senza modificare l’impostazione di tutte le altre.

Altri testi altrove

Alcuni testi hanno un campo proprio, spesso per lingua:

• Saluto, riquadri e schermata iniziale: La schermata iniziale della chat
• Frase sopra il modulo pre-chat (per lingua): Disponibilità, moduli e servizio
• Frase di consenso e link all’informativa sulla privacy (per lingua): Privacy e consenso
• Testi dei tooltip e dei messaggi proattivi: Messaggi proattivi
• Nome e tono dell’assistente IA: Assistente IA
• Scheda promozionale, anche per lingua nel codice: La scheda promozionale nella chat