Langues du widget Web — 50 out of the box.

Vue d’ensemble — ce que signifie « pris en charge »

Une langue est intégrée au Widget Web lorsque chaque texte visible par l’utilisateur dans l’interface de chat dispose d’une traduction vérifiée par un locuteur natif. Cela comprend le texte indicatif du champ de saisie, l’infobulle du bouton d’envoi, les bandeaux d’état de la connexion, les boutons de réponse rapide et tous les messages d’erreur. Si un texte ne peut pas être traduit par un équivalent direct (expressions idiomatiques, formulations propres à une culture), il est reformulé de façon adaptée aux paramètres régionaux lors de la révision, plutôt que laissé en anglais.

La liste de cette page est la table d’exécution réelle — le chargeur du widget fournit ces codes et récupère le pack correspondant dès le premier affichage.

La couverture en un coup d’œil

Comment la langue du visiteur est détectée

La détection s’exécute une seule fois, lors du montage du widget, et sélectionne la première correspondance dans cet ordre :

1. Remplacement explicite. Si votre page définit window.Knocket.locale = 'ja' avant le chargement du widget, c’est cela qui prévaut. Voir Remplacer dans le code.
2. Attribut HTML lang. Si <html lang="fr"> est présent, le widget l’utilise. C’est l’option la plus propre pour les sites multilingues — définissez-le côté serveur pour chaque page.
3. Paramètres régionaux du navigateur. À défaut, utilise navigator.languages[0]. Les variantes régionales sont ramenées à la langue de base (par ex. pt-BR → pt).
4. Anglais. Si aucun des éléments ci-dessus ne correspond à un pack déployé, le widget reste en anglais plutôt que d’être partiellement traduit.

La liste complète — 50 languages

Classement selon le nombre total de locuteurs dans le monde. Chaque ligne correspond à un pack linguistique disponible ; la colonne du code contient la chaîne exacte attendue par le widget.

Remplacer dans le code

Si vous connaissez déjà la langue préférée du visiteur (depuis l’état de votre application, un paramètre de compte ou un paramètre d’URL), indiquez-la explicitement au 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>

Ou, une fois le widget chargé, modifiez-le en direct :

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

Le widget restitue à nouveau chaque chaîne de caractères, inverse le sens d’affichage pour les langues RTL et conserve la conversation en cours intacte.

Comportement de repli

Deux cas particuliers méritent d’être signalés :

• Paramètres régionaux non pris en charge. Si vous transmettez un code inconnu (par ex. xx ou une variante régionale peu courante), le widget revient silencieusement à l'anglais et signale l'échec dans les analyses de la console.
• Repli régional. Les codes régionaux sont réduits à leur langue de base lorsqu’un pack régional n’est pas fourni. pt-BR → pt, en-GB → en. Le chinois simplifié et le chinois traditionnel disposent de packs distincts (zh-Hans et zh-Hant) — ne les traitez pas comme des alias.