Installer le widget

Le widget RolChat est un bouton flottant unique qui s’adapte aux modules que vous avez activés : chat, formulaire de demande de rappel, prise de rendez-vous, formulaire de prospect et recherche dans la base de connaissances y cohabitent. Installez-le une fois ; ce qu’il affiche se décide dans le tableau de bord.

1. Copier le code

Dans Paramètres → Widget, choisissez le site et copiez le code d’installation. Il ressemble à ceci :

<!-- RolChat widget -->
<script>
  window.rolchatConfig = {
    "site_id": "ste_…",
    "account_id": "…",
    "widget_key": "wk1.<site>.<signature>",
    "modules": ["chat"]
  };
</script>
<script async src="https://widget.rolchat.com/stub.js"></script>

La clé du widget est publique et peut figurer dans une page sans risque. Elle désigne votre site et elle est signée, si bien que personne ne peut brancher une copie du widget sur votre compte. Le tableau de bord ajoute d’autres clés à l’objet (message d’accueil, titre de l’en-tête, thème, horaires d’ouverture, disposition selon l’écran) à mesure que vous modifiez les paramètres du widget ; copiez de nouveau le code après ces modifications, ou gardez un objet minimal et laissez le widget récupérer le reste.

stub.js pèse quelques kilo-octets et ne charge le reste que lorsque le visiteur en a besoin : l’interface de chat à la première ouverture, le suivi après consentement, le bandeau de consentement là où il est requis.

2. Le coller avant </body>

Ajoutez le code à chaque page où vous voulez le widget, idéalement via le modèle de votre site ou votre gestionnaire de balises pour qu’il apparaisse partout d’un coup. Le script se charge de façon asynchrone et ne bloque pas l’affichage ; le paquet chargé en premier est volontairement léger pour ne pas dégrader vos Core Web Vitals.

3. Vérifier le fonctionnement

Ouvrez votre site dans une fenêtre de navigation privée. Le bouton apparaît dans le coin choisi. Dans le tableau de bord, Visiteurs affiche la nouvelle session anonyme en temps réel, et un message envoyé depuis le widget apparaît dans la Boîte de réception comme nouvelle conversation.

Identifier les utilisateurs connectés

Si vos visiteurs se connectent à votre produit, indiquez à RolChat qui ils sont afin que les conversations soient rattachées au bon contact :

window.rolchat.identify({
  email: "alice@example.com",
  first_name: "Alice",
  last_name: "Martin",
  phone: "+15551234567",
  external_id: "user_12345",
  custom_fields: { plan: "pro" },
});

Les attributs acceptés sont email, phone, first_name, last_name, external_id et un objet plat custom_fields ; tout le reste est ignoré. RolChat recherche l’e-mail dans le CRM. Si un contact existe, la session y est rattachée et l’agent voit le profil ; sinon, les informations sont conservées et un prospect est créé lorsque le visiteur écrit pour la première fois.

Pour un niveau de confiance plus élevé, votre backend peut signer l’identité : transmettez la signature que RolChat délivre pour l’utilisateur avec les attributs, et la session n’est promue que si la signature est valide. Appelez window.rolchat.reset() lorsque l’utilisateur se déconnecte, sinon la personne suivante sur ce navigateur verra la conversation précédente.

L’API JavaScript

window.rolchat est disponible dès que le stub s’exécute ; les appels effectués avant le chargement du paquet sont mis en file et exécutés dans l’ordre.

Méthode	Effet
show() / hide()	Afficher ou masquer le lanceur
open() / close()	Ouvrir ou fermer le panneau de chat
identify(traits)	Rattacher la session à une personne (voir plus haut)
reset()	Oublier l’identité et démarrer une nouvelle session anonyme
pushEvent(name, props)	Signaler un événement personnalisé pour les messages déclenchés et l’automatisation
trackPageView(path?)	Signaler une page vue dans les applications monopage
setLocale(code)	Changer la langue du widget
showConsentPreferences()	Ouvrir le centre de préférences de consentement
on(event, handler) / off(event, handler)	S’abonner à chat:opened, chat:closed, message:sent, message:received, session:started

window.rolchat.pushEvent("cart_abandoned", { value: 129.9, currency: "EUR" });
window.rolchat.on("message:received", () => audio.play());

Langue et sens de lecture

Le widget parle la langue que vous fixez avec lang dans window.rolchatConfig (par exemple "lang": "de") ; sans ce réglage, la langue du navigateur du visiteur, prise dans l’ordre des préférences du navigateur parmi les 40 langues prises en charge par RolChat ; si aucune ne correspond, l’anglais. Le réglage de langue du site lui-même n’est pas utilisé : pour que le widget parle la langue de votre site, définissez lang. L’arabe et l’hébreu s’affichent de droite à gauche. Le widget ne traduit pas les messages des agents ; côté agent, la traduction en direct par IA peut être utilisée à la place.

Cookies et consentement

Le widget ne suit pas les visiteurs avant leur consentement lorsqu’un bandeau de consentement est requis. Si vous utilisez le module Confidentialité de RolChat, le bandeau et le widget partagent le même état de consentement. Si vous utilisez un autre outil de consentement, les événements analytiques du widget attendent le signal que vous configurez dans Paramètres → Confidentialité → Intégration.

Où se configure le widget

Quoi	Où
Couleurs, position, message d’accueil, points d’entrée, code d’installation	Paramètres → Widget
Modules affichés dans le widget	Paramètres → Modules (par site)
Horaires d’ouverture et message hors ligne	Paramètres → Sites → Horaires d’ouverture
Messages déclenchés sur des pages précises	Marketing → Déclencheurs