Configurer les traductions

L’onglet Translations vous permet de localiser chaque texte de l’interface de l’assistant (libellés des boutons, texte indicatif, message de bienvenue, états d’erreur, textes des formulaires) pour que les visiteurs voient l’assistant dans leur propre langue.

Langues intégrées

L’assistant intègre d’origine l’anglais (EN), l’espagnol (ES) et le catalan (CA). Il détecte la langue du navigateur du visiteur (via navigator.language) et choisit automatiquement la correspondance la plus proche. Si aucune ne correspond, l’anglais est utilisé.

Ajouter une nouvelle langue

Ouvrez les Settings de l’assistant, puis l’onglet Translations.
Choisissez Add language et saisissez le code de langue (par ex. FR pour le français, DE pour l’allemand, PT pour le portugais).
Renseignez les textes de l’interface : chaque clé (comme ask, welcome, placeholder) dispose d’un champ pour votre traduction.
Enregistrez.

Vos traductions remplacent celles intégrées : vous pouvez donc aussi personnaliser le texte anglais, par exemple changer le bouton d’envoi de « Ask » en « Send », ou le texte indicatif « Ask a question » en une formule propre à votre marque.

Clés de traduction

Chaque texte de l’interface est référencé par une clé. Voici la liste complète des clés intégrées, leur valeur anglaise par défaut et l’endroit où elles apparaissent dans l’assistant :

Interaction de base :

Clé	Par défaut (EN)	Où elle apparaît
`placeholder`	"Ask a question"	Le texte grisé dans le champ de message.
`ask`	"Ask"	Le libellé du bouton d’envoi.
`search`	"Search"	Le libellé de l’action de recherche (mode overlay).
`searching`	"Searching..."	Affiché pendant que l’assistant génère une réponse.
`noResults`	"Sorry, I couldn't find what you're looking for."	Affiché lorsque l’assistant ne trouve aucun contenu correspondant.
`sorry`	"Sorry, we are unable to answer at this moment."	Affiché en cas d’erreur inattendue.

Accueil et identité :

Clé	Par défaut (EN)	Où elle apparaît
`welcome`	(vide : utilise le message de bienvenue des paramètres General)	Le message d’accueil affiché à l’ouverture du chat.
`description`	(vide : utilise la description des paramètres General)	Le sous-titre sous le titre de l’assistant.

Références et réactions :

Clé	Par défaut (EN)	Où elle apparaît
`references`	"Sources"	Le titre au-dessus des fiches de référence dans une réponse.
`copy`	"Copy"	Infobulle du bouton de copie dans le presse-papiers.
`copied`	"Copied to clipboard"	Confirmation après la copie.
`like`	"Like"	Infobulle du bouton de réaction pouce levé.
`dislike`	"Dislike"	Infobulle du bouton de réaction pouce baissé.

Contrôles de la fenêtre :

Clé	Par défaut (EN)	Où elle apparaît
`close`	"Close"	Infobulle du bouton de fermeture.
`expand`	"Expand"	Infobulle du bouton d’agrandissement.
`collapse`	"Collapse"	Infobulle du bouton de réduction.
`clear`	"Clear conversation"	Infobulle du bouton d’effacement de l’historique.

Formulaires :

Clé	Par défaut (EN)	Où elle apparaît
`showForm`	"Open form"	Le bouton qui ouvre un formulaire de capture de prospects.
`submitForm`	"Submit"	Le bouton d’envoi du formulaire.
`formSubmitted`	"Your form has been submitted."	Confirmation après l’envoi d’un formulaire.

Pièces jointes :

Clé	Par défaut (EN)	Où elle apparaît
`attachFile`	"Attach file"	Infobulle du bouton de pièce jointe.
`attachedFile`	"Attached file:"	Libellé affiché à côté d’un fichier joint.
`removeAttachment`	"Remove attachment"	Bouton pour retirer une pièce jointe en attente.
`processingAttachment`	"Processing attachment..."	Affiché pendant le traitement d’un fichier.

Pied de page :

Clé	Par défaut (EN)	Où elle apparaît
`poweredBy`	"Powered by"	Le texte d’attribution dans le pied de page.
`contactUs`	"Contact us"	L’action de contact dans le pied de page.

Fonctionnement des traductions dans les templates

Dans les templates Liquid de l’assistant, chaque texte traduisible est référencé avec le filtre t :

{{ 'key' | t: 'Fallback text' }}

Le filtre cherche la clé dans la langue du visiteur. Si la clé a une traduction, elle est utilisée ; sinon, c’est le texte de repli (le second paramètre) qui s’affiche.

Par exemple, dans le template de la barre de recherche :

<textarea placeholder="{{ 'placeholder' | t: 'Ask a question' }}"></textarea>
<button>{{ 'ask' | t: 'Ask' }}</button>

Et dans le template de réponse, le titre des sources et les boutons de réaction :

<span>{{ 'references' | t: 'Sources' }}</span>
<button title="{{ 'like' | t: 'Like' }}">...</button>
<button title="{{ 'dislike' | t: 'Dislike' }}">...</button>

Clés de traduction personnalisées

Vous pouvez ajouter vos propres clés en plus de la liste intégrée. Si vous ajoutez une clé nommée customGreeting dans l’onglet Translations, vous pouvez la référencer dans une surcharge de template :

{{ 'customGreeting' | t: 'Hello!' }}

C’est utile pour les utilisateurs Enterprise qui surchargent les templates et ont besoin de textes traduisibles dans leur balisage personnalisé.

Conseils

Commencez par les textes que les visiteurs voient le plus : placeholder, ask, noResults et references.
Testez chaque langue en modifiant le réglage de langue de votre navigateur et en rechargeant la page.
Inutile de traduire toutes les clés : les clés non traduites se rabattent sur la valeur intégrée par défaut pour cette langue, ou sur l’anglais.
Les traductions couvrent l’interface (boutons, libellés, textes indicatifs), pas les réponses : la langue des réponses de l’assistant est contrôlée par les instructions de comportement.

Dépannage

Si un libellé reste dans la langue par défaut, sa clé de traduction est probablement vide : ouvrez l’onglet Translations et renseignez-la.
Évitez d’ajouter deux fois le même code de langue : les doublons peuvent provoquer un comportement imprévisible.
La langue est détectée à partir du navigateur du visiteur, et non de sa localisation. Pour imposer une langue, définissez-la dans l’intégration via une surcharge de template.