Le widget sur votre site

Le widget met votre assistant là où sont vos visiteurs : sur votre site. Vous collez un script, la bulle de discussion apparaît, et le visiteur retrouve exactement ce que vous avez testé dans le Playground — même fenêtre, mêmes couleurs, mêmes messages, mêmes règles. Le widget n’est pas une version réduite de l’assistant : c’est le même, déployé.

Pour mettre le widget en service :

Ouvrez le canal Site web — widget et préparez-le inactif.
Choisissez la disposition et copiez le Script à installer.
Collez le script sur votre site.
Restreignez les Domaines autorisés, puis activez le widget.

Ouvrir le canal — et préparer sans exposer

Dans la facette Déployer de l’assistant, ouvrez Site web — widget. Le premier réglage, Activer le widget, commande tout le canal : « Tant qu’il est inactif, la clé ne répond pas : vous pouvez préparer les domaines et le script sans rien exposer. »

C’est le mode de travail à retenir : le script peut déjà être collé sur votre site, les domaines déjà réglés — rien ne répond tant que vous n’activez pas. Le jour de la mise en ligne, l’activation est un seul geste dans le tableau de bord, sans toucher au site.

Cliquez sur Enregistrer — le message Canal site web enregistré. confirme. Ce bouton enregistre l’activation et les domaines autorisés. La disposition, elle, n’a rien à enregistrer : elle vit dans le script que vous collez, page par page — c’est l’objet de la section suivante.

Choisir la disposition — un choix par page, pas par assistant

Le sélecteur Où l’assistant apparaît sur cette page compose le script à coller et joue une démonstration animée dans vos couleurs. Quatre dispositions existent, chacune pour un type de page :

Bulle — « Une bulle en bas de l’écran, que le visiteur ouvre. Le choix par défaut, sur toutes les pages du site. »
Panneau latéral — « Un panneau sur toute la hauteur, collé au bord. Le visiteur l’ouvre depuis la bulle. » Même porte d’entrée que la bulle, mais la fenêtre ouverte occupe toute la hauteur de l’écran.
Intégré — « La fenêtre s’installe dans votre page, à l’endroit du bloc ci-dessous. Aucune bulle : elle est déjà là. Donnez-lui une hauteur. » Pour une page qui accueille la fenêtre comme un élément parmi d’autres — la page d’aide d’un site e-commerce, par exemple.
Plein écran — « La fenêtre occupe toute la page — pour une page dédiée. Aucune bulle et aucune fermeture. » Par exemple la page « Posez votre question » qu’une mutuelle réserve à son assistant.

La disposition appartient à la page, jamais à l’assistant : c’est le script collé qui tranche. Le même assistant peut être en bulle sur tout le site d’une compagnie d’assurance et en plein écran sur sa page d’aide — deux scripts, une seule configuration, une seule connaissance.

Si vous choisissez Intégré, l’écran ajoute une étape avant le script : Ajoutez ce bloc là où la fenêtre doit apparaître — un bloc conteneur avec une hauteur, à placer dans votre page. Si ce bloc est introuvable au chargement, le widget retombe en bulle plutôt que de ne rien afficher : le visiteur garde une porte d’entrée.

Coller le script

Pour installer le widget, copiez le Script à installer (Copier passe à Copié) et suivez l’étape affichée : Collez ce script avant la fin du <body> de la page. Le script se charge sans bloquer l’affichage de votre page.

Une fois le widget activé, la disposition choisie apparaît sur la page : la fenêtre configurée dans Apparence, avec vos Messages aux visiteurs. Chaque question posée consomme un crédit de votre espace de travail et crée une conversation, que vous relisez dans Conversations — la section Observer de l’assistant.

Ouvrir depuis votre propre bouton

Si votre site a déjà un bouton d’aide ou de contact, activez Ouvrir depuis mon propre bouton : « Notre bulle disparaît et c’est votre bouton qui ouvre la fenêtre. » L’écran ajoute alors l’étape Ajoutez votre propre bouton en tête du script. Le filet de sécurité est intégré : « Si le bouton est introuvable sur la page, la bulle revient — un visiteur garde toujours une porte d’entrée. » L’option existe pour Bulle et Panneau latéral — les deux dispositions qui ont une bulle à remplacer.

La clé publique

Le script porte une Clé publique : « Elle identifie ce déploiement. » C’est elle qui dit au widget quel assistant répond, avec quelle apparence et quels messages. Elle est publique par nature — toute personne qui lit le code de votre page la voit. Ce qui contrôle où elle fonctionne, ce sont les Domaines autorisés, section suivante.

Régénérer la clé en crée une nouvelle, et la conséquence est immédiate : « Tous les scripts installés avec l’ancienne clé cessent de répondre immédiatement, sur tous les sites. Il faudra recoller le nouveau script. » Le dialogue Régénérer la clé publique ? vous le redit avant de confirmer, et le message qui suit — Nouvelle clé générée. Recollez le script sur vos pages. — nomme le travail restant. Réservez ce geste au cas où la clé sert là où elle ne devrait pas : contre un site indésirable, le remède ordinaire est la liste des domaines, pas la rotation de la clé.

Domaines autorisés

Domaines autorisés liste « Les sites qui ont le droit d’embarquer le widget. Vide, tout site est autorisé — pratique pour tester, à restreindre avant la mise en ligne. »

Tant que la liste est vide, l’écran l’affiche : « Aucun domaine — tout site est autorisé pour l’instant. » C’est le bon réglage pour essayer le script en local ou en préproduction.
Avant la mise en ligne, ajoutez vos domaines avec Ajouter. Un site hors de la liste ne peut plus embarquer le widget.

La langue du visiteur

Le widget sert chaque visiteur dans sa langue, sans réglage sur la page. La cascade est celle-ci : la langue de la page qui héberge le widget, puis celle du navigateur du visiteur, puis — dès qu’il écrit — la langue de ses propres messages, qui prime sur tout le reste. Les réponses de l’assistant suivent toujours la langue de la question.

Ce que le visiteur lit dans la fenêtre — accueil, refus, invite de saisie, questions suggérées — vient de vos messages, rédigés langue par langue dans Paramètres > Langues & messages de l’assistant. Deux règles y font loi, et elles valent sur le widget :

Une traduction automatique non relue n’est jamais servie : tant que vous ne l’avez pas enregistrée, vos visiteurs voient la langue par défaut.
Un champ laissé vide replie, champ par champ, sur la langue par défaut — jamais un blanc.

L’habillage du widget lui-même suit la langue du visiteur et replie sur votre langue par défaut : aucun texte étranger à votre configuration n’apparaît au milieu de votre page.

En arabe, la fenêtre passe en droite-à-gauche : textes, disposition et position suivent. Le côté choisi dans Apparence (Position sur la page) se retourne de lui-même — l’aide de l’écran le dit : « En arabe, tout passe tout seul du côté opposé. »

Identifier vos visiteurs connectés

Par défaut, un visiteur est un navigateur : l’assistant ne sait pas qui lui parle. Si votre site a des comptes (espace adhérent, espace client), votre serveur peut dire à l’assistant qui est connecté, de façon infalsifiable, et l’opérateur retrouve la personne dans ses conversations.

L’identification repose sur une clé de signature de l’espace de travail. Votre serveur signe un jeton avec cette clé ; l’assistant ne fait confiance qu’à un jeton signé.

Dans Déployer > Site web — widget, ouvrez le panneau Identification des visiteurs (réservé aux propriétaires et administrateurs).
Donnez un nom à la clé si vous le souhaitez, puis cliquez sur Créer une clé.
Copiez le secret avec Copier le secret, puis cliquez sur C’est fait. Le secret n’est plus jamais affiché : gardez-le côté serveur, jamais dans une page.

Le jeton que votre serveur signe est un JWT HS256 dont l’en-tête porte le kid affiché à côté de la clé. Ses champs : sub (l’identifiant du visiteur dans votre système, requis), name, email, phone, attributes (un objet plat de textes courts) et exp (sept jours au plus).

Un réglage du déploiement, enregistré avec Enregistrer : Exiger l’identification. Allumé, seuls les visiteurs identifiés peuvent ouvrir une conversation ; éteint, tout le monde écrit et les visiteurs identifiés sont reconnus.

Pour tester sans votre site, dans le Playground, cliquez sur Identifier le visiteur, renseignez Identifiant chez vous (et, facultatif, Nom et E-mail), puis Ouvrir un test identifié. Le rail affiche la section Visiteur avec ce que l’assistant sait de la personne ; Redevenir anonyme revient au visiteur ordinaire.

Un visiteur identifié apparaît par son nom dans Conversations et sous la date de ses envois dans Données collectées. Son historique le suit : quand il s’identifie, sa conversation anonyme en cours lui est rattachée, et il retrouve ses conversations précédentes avec cet assistant. Après une déconnexion sur le même navigateur, la fenêtre repart d’une conversation vide : le fil d’une personne identifiée ne se rouvre jamais sans son jeton.

Pour supprimer une personne et ses conversations (droit à l’effacement), ouvrez une de ses conversations et cliquez sur Effacer ce visiteur. Les formulaires qu’elle a envoyés et ses rendez-vous restent dans leurs écrans, avec ce qui y est écrit.

Au plafond de crédits

Quand le quota mensuel de crédits de l’espace de travail est épuisé, l’assistant cesse de répondre jusqu’au renouvellement — sur le widget comme partout. Deux réglages de l’assistant décident de ce que vit le visiteur à ce moment-là :

Le Message au plafond mensuel (Paramètres > Langues & messages) : ce que lit un visiteur qui pose une question.
Cacher la bulle au plafond (Paramètres > Comportement) : « La bulle de conversation disparaît du site tant que le quota est épuisé — les visiteurs ne sollicitent plus un assistant qui ne peut pas répondre. »

Le quota dépend de votre offre : la page Offres fait autorité sur les volumes inclus.