Configurare le traduzioni
La scheda Translations ti permette di localizzare ogni testo dell’interfaccia dell’assistente (etichette dei pulsanti, testo segnaposto, messaggio di benvenuto, stati di errore, testi dei moduli) così i visitatori vedono l’assistente nella loro lingua.
Lingue integrate
L’assistente include di serie inglese (EN), spagnolo (ES) e catalano (CA). Rileva la lingua del browser del visitatore (da navigator.language) e sceglie automaticamente la corrispondenza più vicina. Se non ne trova nessuna, usa l’inglese.
Aggiungere una nuova lingua
- Apri le Settings dell’assistente e la scheda Translations.
- Scegli Add language e inserisci il codice della lingua (ad es.
FRper il francese,DEper il tedesco,PTper il portoghese). - Compila i testi dell’interfaccia: ogni chiave (come
ask,welcome,placeholder) ha un campo per la tua traduzione. - Salva.
Le tue traduzioni sostituiscono quelle integrate, quindi puoi anche personalizzare il testo inglese: ad esempio, cambiare il pulsante di invio da "Ask" a "Send" o il testo segnaposto da "Ask a question" a qualcosa di specifico per il tuo brand.
Chiavi di traduzione
Ogni testo dell’interfaccia è identificato da una chiave. Ecco l’elenco completo delle chiavi integrate, il loro valore predefinito in inglese e dove compaiono nell’assistente:
Interazione principale:
| Chiave | Predefinito (EN) | Dove compare |
|---|---|---|
placeholder | "Ask a question" | Il testo grigio dentro il campo del messaggio. |
ask | "Ask" | L’etichetta del pulsante di invio. |
search | "Search" | L’etichetta dell’azione di ricerca (modalità overlay). |
searching | "Searching..." | Mostrato mentre l’assistente genera una risposta. |
noResults | "Sorry, I couldn't find what you're looking for." | Mostrato quando l’assistente non trova contenuti corrispondenti. |
sorry | "Sorry, we are unable to answer at this moment." | Mostrato in caso di errore imprevisto. |
Benvenuto e identità:
| Chiave | Predefinito (EN) | Dove compare |
|---|---|---|
welcome | (vuoto: usa il messaggio di benvenuto delle impostazioni General) | Il saluto mostrato quando si apre la chat. |
description | (vuoto: usa la descrizione delle impostazioni General) | Il sottotitolo sotto il titolo dell’assistente. |
Riferimenti e reazioni:
| Chiave | Predefinito (EN) | Dove compare |
|---|---|---|
references | "Sources" | Il titolo sopra le schede di riferimento in una risposta. |
copy | "Copy" | Tooltip del pulsante per copiare negli appunti. |
copied | "Copied to clipboard" | Conferma dopo la copia. |
like | "Like" | Tooltip del pulsante di reazione con il pollice in su. |
dislike | "Dislike" | Tooltip del pulsante di reazione con il pollice in giù. |
Controlli della finestra:
| Chiave | Predefinito (EN) | Dove compare |
|---|---|---|
close | "Close" | Tooltip del pulsante di chiusura. |
expand | "Expand" | Tooltip del pulsante di espansione. |
collapse | "Collapse" | Tooltip del pulsante di compressione. |
clear | "Clear conversation" | Tooltip del pulsante per cancellare lo storico. |
Moduli:
| Chiave | Predefinito (EN) | Dove compare |
|---|---|---|
showForm | "Open form" | Il pulsante che apre un modulo di acquisizione contatti. |
submitForm | "Submit" | Il pulsante di invio del modulo. |
formSubmitted | "Your form has been submitted." | Conferma dopo l’invio di un modulo. |
Allegati:
| Chiave | Predefinito (EN) | Dove compare |
|---|---|---|
attachFile | "Attach file" | Tooltip del pulsante per allegare file. |
attachedFile | "Attached file:" | Etichetta mostrata accanto a un file allegato. |
removeAttachment | "Remove attachment" | Pulsante per rimuovere un allegato in coda. |
processingAttachment | "Processing attachment..." | Mostrato mentre un file viene elaborato. |
Footer:
| Chiave | Predefinito (EN) | Dove compare |
|---|---|---|
poweredBy | "Powered by" | Il testo di attribuzione nel footer. |
contactUs | "Contact us" | L’azione di contatto nel footer. |
Come funzionano le traduzioni nei template
Nei template Liquid dell’assistente, ogni testo traducibile è richiamato con il filtro t:
{{ 'key' | t: 'Fallback text' }}Il filtro cerca la chiave nella lingua del visitatore. Se la chiave ha una traduzione, viene usata; altrimenti viene mostrato il testo di riserva (il secondo parametro).
Ad esempio, nel template della barra di ricerca:
<textarea placeholder="{{ 'placeholder' | t: 'Ask a question' }}"></textarea>
<button>{{ 'ask' | t: 'Ask' }}</button>E nel template della risposta, il titolo delle fonti e i pulsanti di reazione:
<span>{{ 'references' | t: 'Sources' }}</span>
<button title="{{ 'like' | t: 'Like' }}">...</button>
<button title="{{ 'dislike' | t: 'Dislike' }}">...</button>Chiavi di traduzione personalizzate
Puoi aggiungere chiavi tue oltre all’elenco integrato. Se aggiungi una chiave chiamata customGreeting nella scheda Translations, puoi richiamarla in una sostituzione di template:
{{ 'customGreeting' | t: 'Hello!' }}È utile per gli utenti Enterprise che sostituiscono i template e hanno bisogno di testi traducibili nel proprio markup personalizzato.
Consigli
- Inizia dai testi che i visitatori vedono di più:
placeholder,ask,noResultsereferences. - Testa ogni lingua cambiando l’impostazione della lingua del browser e ricaricando la pagina.
- Non devi tradurre ogni chiave: quelle non tradotte ricorrono al valore predefinito integrato per quella lingua, o all’inglese.
- Le traduzioni riguardano l’interfaccia (pulsanti, etichette, testi segnaposto), non le risposte: la lingua delle risposte dell’assistente è controllata dalle istruzioni di comportamento.
Risoluzione dei problemi
- Se un’etichetta resta nella lingua predefinita, probabilmente la sua chiave di traduzione è vuota: apri la scheda Translations e compilala.
- Evita di aggiungere due volte lo stesso codice di lingua: i duplicati possono causare comportamenti imprevedibili.
- La lingua viene rilevata dal browser del visitatore, non dalla sua posizione. Per forzare una lingua, impostala nell’integrazione tramite una sostituzione di template.