Lingue del widget web — 50 out of the box.

Panoramica — cosa significa "supportato"

Una lingua viene resa disponibile nel Widget Web quando ogni stringa visibile all'utente nell'interfaccia della chat dispone di una traduzione revisionata da un madrelingua. Ciò include il testo segnaposto del campo di composizione, il suggerimento del pulsante di invio, i banner sullo stato della connessione, i pulsanti di risposta rapida e ogni notifica di errore. Se una stringa non può essere tradotta con un equivalente diretto (modi di dire, espressioni legate a una cultura specifica), durante la revisione viene formulata una versione adatta alla lingua locale anziché ricorrere all'inglese.

L'elenco in questa pagina è la tabella di runtime effettiva: il caricatore del widget include questi codici e recupera il pacchetto corrispondente alla prima visualizzazione.

Panoramica della copertura

Come viene rilevata la lingua del visitatore

Il rilevamento viene eseguito una sola volta, al caricamento del widget, e seleziona la prima corrispondenza in quest'ordine:

1. Override esplicito. Se la tua pagina imposta window.Knocket.locale = 'ja' prima del caricamento del widget, quello ha la precedenza. Vedi Override nel codice.
2. Attributo HTML lang. Se è presente <html lang="fr">, il widget lo adotta. Questa è l'opzione più semplice per i siti multilingue: impostalo lato server per ogni pagina.
3. Impostazioni locali del browser. In alternativa, viene utilizzato navigator.languages[0]. Le varianti regionali vengono ricondotte alla lingua di base (ad es. pt-BR → pt).
4. Inglese. Se nessuna delle opzioni precedenti corrisponde a un pacchetto disponibile, il widget rimane in inglese anziché essere tradotto solo parzialmente.

L'elenco completo — 50 languages

Classificate in base al numero globale di parlanti. Ogni riga rappresenta un pacchetto linguistico disponibile; la colonna del codice contiene la stringa esatta richiesta dal widget.

Sovrascrivi nel codice

Se conosci già la lingua preferita del visitatore (dallo stato dell'app, da un'impostazione dell'account o da un parametro URL), indicala esplicitamente al widget:

<script>
  window.Knocket = window.Knocket || {};
  window.Knocket.locale = 'ja'; // must be set before the loader script
</script>
<script src="https://cdn.knocket.ai/w.js" async></script>

Oppure, dopo il caricamento del widget, modificalo in tempo reale:

Knocket('setLocale', 'zh-Hans');

Il widget esegue nuovamente il rendering di ogni stringa, inverte la direzione per le lingue RTL e mantiene intatta la conversazione corrente.

Comportamento di fallback

Due casi limite da segnalare:

• Lingua non distribuita. Se specifichi un codice sconosciuto (ad es. xx o una variante regionale poco comune), il widget torna automaticamente all'inglese senza avvisarti e segnala la mancata corrispondenza nelle analisi della console.
• Fallback regionale. Quando un pacchetto regionale non è disponibile, i codici regionali vengono ricondotti alla lingua di base. pt-BR → pt, en-GB → en. Il cinese semplificato e quello tradizionale sono pacchetti separati (zh-Hans e zh-Hant): non associarli come alias.