Textes et langues

Le widget utilise l’allemand, l’anglais et le polonais. Chacun de ses quelque 200 textes peut être remplacé : dans votre compte pour toutes les pages, ou dans le code pour certaines pages.

Comment le widget choisit la langue

Le widget se trouve dans votre page. La langue que lit actuellement le visiteur compte donc davantage que le réglage de son navigateur. L’ordre :

1. Une langue choisie par votre page pour ce visiteur via ReactiveChat('setLocale', …) (voir ci-dessous).
2. Une langue fixe dans le code d’intégration (data-rc-locale) ou la configuration.
3. Sinon, la langue de votre page dans <html lang="…">.
4. Sinon, la langue par défaut de votre compte.
5. Sinon, la langue du navigateur, puis l’anglais.

Les codes régionaux sont raccourcis : de-AT devient de. Une langue inconnue du widget devient l’anglais.

Le plus important est donc un <html lang> correct sur vos pages. Le widget suit alors lui-même chaque version linguistique de votre site.

La langue par défaut dans votre compte

Sous /app/projects/{id}, dans l’onglet Installation, section Données de base, choisissez la Langue par défaut : de, en ou pl. Elle remplit deux fonctions :

• Elle s’applique aux visiteurs des pages sans <html lang> si le code d’intégration ne définit aucune langue.
• C’est la langue dans laquelle vous rédigez vos textes personnalisés, l’écran d’accueil et la carte promotionnelle (voir ci-dessous).

Définir la langue dans le code

Fixe pour une page, dans le code d’intégration :

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

À l’exécution, par exemple depuis votre propre sélecteur de langue :

ReactiveChat('setLocale', 'en');

setLocale change immédiatement les libellés du widget. Celui-ci mémorise le choix pendant un an dans le navigateur du visiteur ; il devient aussi prioritaire sur data-rc-locale des autres pages. Le widget ne possède pas de sélecteur de langue propre. Si vos visiteurs doivent choisir, appelez setLocale depuis votre sélecteur.

Textes personnalisés dans votre compte

Dans l’onglet Textes et formulaires, section Textes personnalisés, chaque texte du widget est répertorié avec sa clé, regroupé par zone dans des sections repliées. Notre texte apparaît en gris dans le champ. Votre saisie le remplace. Le titre indique combien de textes personnalisés sont déjà définis.

• 400 caractères maximum par texte.
• Laisser vide signifie : notre texte.
• Un texte exactement identique au nôtre n’est pas enregistré.
• Le widget remplit les paramètres entre accolades comme {n}, {name} ou {time}. Conservez-les dans votre texte pour afficher leur valeur.

Important pour la langue : vous saisissez les textes dans la langue par défaut du projet, et ils s’appliquent dans cette langue. Les visiteurs dont le widget utilise une autre langue voient encore nos textes fournis. Pour vos propres textes dans d’autres langues, utilisez le code (ci-dessous), idéalement sur les pages de la version linguistique correspondante.

Les modifications atteignent vos visiteurs en moins d’une minute.

Les clés principales

Un extrait, par zone :

• launcher.text, launcher.subtext – libellé et seconde ligne du bouton du chat. Vides à l’origine ; une saisie est prioritaire sur les champs sous Apparence → Marque.
• launcher.label – le libellé du bouton du chat lu par les lecteurs d’écran (« Ouvrir le chat »).
• header.title, header.subtitle_online, header.subtitle_bot, header.response_time – titre et secondes lignes de l’en-tête.
• home.greeting, home.sub, home.start, home.start_sub – message d’accueil et point d’entrée de l’écran d’accueil (le message se règle plus facilement sous Écran d’accueil).
• tabs.home, tabs.messages, tabs.help – les onglets.
• input.placeholder et les autres input.* – le champ de saisie.
• offline.* – le formulaire « Laisser un message ».
• prechat.* – le formulaire préalable.
• bh.* – les mentions sur les heures de service.
• ds.* et daten.* – le consentement et la fiche « Vos données ».
• msg.ki_notice – la mention avant la première réponse de l’assistant IA.
• csat.* – l’évaluation après la conversation.
• transcript.*, upload.*, handoff.*, queue.*, teaser.*, err.* – transcription par e-mail, pièces jointes, transfert à l’équipe, file d’attente, infobulle et messages d’erreur.

La liste complète est visible dans votre compte.

La mention « Powered by reactive.chat » (voir Fenêtre de chat) et les textes des visites guidées du produit (voir Visites guidées du produit) ne se modifient pas via les textes.

Remplacer les textes dans le code

Dans le code d’intégration, avec data-rc-strings en JSON et les clés en notation pointée :

<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>

Ou dans la configuration :

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

Un second appel boot sur la même page charge de nouveaux strings. Vous pouvez ainsi changer les textes après la connexion, par exemple.

Les textes définis dans le code s’appliquent de la même façon dans toutes les langues. Définissez-les donc sur les pages dont la langue est fixe et précisez-y aussi cette langue.

Ordre de priorité, du plus fort au plus faible :

1. Textes dans le code (strings), uniquement pour la page où ils figurent.
2. Textes personnalisés du compte, dans la langue par défaut.
3. Nos textes fournis dans la langue du visiteur.
4. Anglais.

Le code est volontairement prioritaire : pour donner un libellé différent à une seule page, faites-le sur cette page, sans modifier le réglage de toutes les autres.

Autres textes ailleurs

Certains textes possèdent leur propre champ, souvent par langue :

• Message d’accueil, tuiles et écran d’accueil : L’écran d’accueil du chat
• Phrase au-dessus du formulaire préalable (par langue) : Disponibilité, formulaires et service
• Phrase de consentement et lien vers la politique de confidentialité (par langue) : Vie privée et consentement
• Textes des infobulles et messages proactifs : Messages proactifs
• Nom et ton de l’assistant IA : Assistant IA
• Carte promotionnelle, aussi par langue dans le code : La carte promotionnelle dans le chat