Chatbot de site web

Website Chatbot

Tutoriel Vidéo

Website Chatbot

Voir sur la page Tutoriels →

Le chatbot de site web place votre assistant IA sur n'importe quel site sous la forme d'une petite bulle de discussion que les visiteurs peuvent ouvrir. Vous le configurez entièrement dans QAnswer, puis vous collez un seul extrait de code dans votre site.

Ouvrez l'assistant, allez dans l'onglet Exposer et sélectionnez la carte « Chatbot de site web ». La page qui s'ouvre est un guide d'installation en cinq étapes ; suivez-les de haut en bas.

Note
Si l'organisation de l'assistant ne dispose pas de l'option Expose, ce guide s'ouvre en lecture seule : l'avis « Option Expose requise » apparaît en haut et toutes les étapes sont grisées. Voir L'option Expose.
Note
La carte « Chatbot de site web » n'est proposée que pour les assistants dont le type de tâche est Discussion.

Étape 1 — Personnaliser

La première étape est divisée en deux : la carte « Paramètres du widget » à gauche contient les options, et l'« Aperçu du widget » à droite montre le résultat en direct à mesure que vous les modifiez.

L'étape 1 du guide d'installation, avec les paramètres du widget à gauche et un aperçu en direct à droite

La moitié supérieure de la carte de paramètres définit l'apparence et le comportement du widget :

  • Titre du widget — l'en-tête affiché en haut du widget ouvert. Laissé vide, le nom de l'assistant est utilisé.
  • Message initial — le message d'accueil de l'assistant, avant que le visiteur ne saisisse quoi que ce soit.
  • Thème — Auto, Clair ou Sombre. Auto suit le réglage système du visiteur.
  • Lors de la première visite, le widget sera… — « Réduit » n'affiche que la bulle ; « Ouvert » déploie la discussion immédiatement.
  • Position à l'écran — le coin dans lequel le widget se place — en bas à droite, en bas à gauche, en haut à droite ou en haut à gauche.
  • Autoriser l'export des conversations — ajoute une commande permettant aux visiteurs de télécharger leur conversation.

Plus bas dans la même carte se trouvent les options de style plus fines :

La moitié inférieure de la carte Paramètres du widget, avec la marge de position, la couleur d'accentuation et la propriété CSS font
  • Marge de position — la distance en pixels, en X et en Y, entre le widget et les bords de l'écran — utile lorsque le widget masquerait autrement un élément de votre site.
  • Couleur d'accentuation — les couleurs primaire et secondaire du widget, pour qu'il corresponde à votre charte graphique.
  • Afficher le texte « Powered by » — décochez la case pour retirer la mention QAnswer au bas du widget.
  • Propriété CSS « font » — une option avancée qui vous permet de transmettre une déclaration CSS de police brute, pour que le widget corresponde à la typographie de votre site.
Avertissement
Ces paramètres sont partagés par toutes les intégrations widget de cet assistant, y compris les intégrations tierces comme WordPress ou Wix. Cliquez sur « Enregistrer » dans le coin de la carte Paramètres du widget pour conserver vos modifications — l'aperçu se met à jour immédiatement, mais rien n'est enregistré tant que vous ne le faites pas.

Étape 2 — Tester

Avant de toucher à votre site réel, vous pouvez voir le widget par-dessus celui-ci. Saisissez l'adresse de la page sur laquelle vous souhaitez l'essayer :

L'étape 2, Tester, avec la puce « Simuler », un champ d'URL de site web et les actions Copier et Ouvrir la démo
  • « Ouvrir la démo » ouvre cette page dans un nouvel onglet, avec votre widget superposé.
  • « Copier » copie le lien de démonstration, pour que vous puissiez l'envoyer à un collègue.
Note
Il s'agit uniquement d'une simulation destinée à l'aperçu — rien n'est installé sur le site que vous saisissez, et le lien de démonstration ne permet pas de déployer le widget. Utilisez pour cela l'extrait de l'étape 4.

Étape 3 — Choisir votre accès

Un widget sur un site web public doit être accessible à des personnes qui ne sont pas connectées à QAnswer. Cette étape détermine comment elles y accèdent :

Étape 3, Choisir votre accès, avec les options Public, Uniquement avec une clé API et Avancé : clé en stockage local
  • Public — toute personne qui charge votre site peut utiliser le widget, sans clé API. C'est le choix habituel pour un site public.
  • Uniquement avec une clé API — l'assistant reste privé et l'extrait contient une clé API qui permet au widget d'y accéder.
  • Avancé : clé en stockage local — aucune clé API n'est générée ni écrite dans l'extrait : votre page transmet la clé au widget à l'exécution. Le statut indique alors « Prêt : le code ci-dessous ne contient aucune clé API ; votre page la fournit à l’exécution. »
Note
Il n'y a pas d'option Utilisateurs connectés ici, car les visiteurs de votre site ne sont pas connectés à QAnswer. Si une autre interface a déjà réglé l'assistant sur Utilisateurs connectés, l'option reste affichée, marquée « Ne fonctionne pas ici » : choisissez-en une autre.

Lorsque Uniquement avec une clé API est sélectionné, les réglages de la clé apparaissent juste sous l'option :

  • Utiliser une clé API existante liste les clés de l'assistant utilisables ici ; les clés expirées et les clés Read and write sont écartées. Ce choix n'apparaît que si vous avez un accès en écriture à l'assistant et qu'une telle clé existe.
  • Pour créer une nouvelle clé, saisissez un nom dans Nom de la clé API et cliquez sur Générer une clé.
  • La clé choisie s'affiche alors masquée, avec un bouton de copie, et Utiliser une autre clé fait réapparaître le sélecteur. QAnswer mémorise la clé dans votre navigateur et la sélectionne à nouveau la prochaine fois que vous ouvrez le guide.

Passer à Public ou à Utilisateurs connectés met la clé de côté, puisqu'aucune n'est alors nécessaire ; elle revient si vous repassez à Uniquement avec une clé API.

Note
Sous les options, un message d'état indique si l'intégration est prête, par exemple « Prêt : tout le monde peut utiliser cette intégration, aucune clé API n'est nécessaire. », ou ce qui manque encore, comme « Pas encore prêt : sélectionnez ou créez une clé API ci-dessus. »
Avertissement
L'accès est un réglage au niveau de l'assistant. Le modifier ici le modifie aussi pour l'interface de discussion, l'interface de recherche, l'API REST et toutes les intégrations tierces de l'assistant — pas seulement pour ce widget.
Note
Cette étape ne contrôle que l'accès public anonyme. Pour partager l'assistant avec des utilisateurs, des équipes ou des organisations précis, utilisez plutôt la boîte de dialogue Partager dans la barre supérieure de l'assistant.

Étape 4 — Exporter

La dernière étape obligatoire vous fournit le code à coller dans votre site. Trois variantes de la même intégration sont disponibles ; choisissez celle qui correspond à la façon dont votre site est construit.

L'extrait Script, une simple balise script pointant vers le chargeur de widget QAnswer
  • Script — une simple balise '<script>' qui charge le widget depuis QAnswer. L'option la plus simple, et la bonne pour presque tous les sites.
  • Script Content — le corps en ligne de ce script, pour les plateformes qui autorisent l'ajout de JavaScript mais pas d'une balise script avec un attribut src.
  • IFrame — une intégration par '<iframe>', pour les environnements où les scripts externes sont bloqués par une politique de sécurité du contenu.
Note
Collez l'extrait juste avant la balise '</body>' fermante de chaque page où le widget doit apparaître. Dans les éditeurs de site comme Confluence, Wix ou WordPress, vous devrez peut-être le placer dans un élément « bloc de code » ou « bloc HTML ». Tant que le message d'état de l'étape 3 n'indique pas Prêt, cette étape reste grisée.

Étape 5 — Personnaliser les données supplémentaires (facultatif)

Votre site web connaît souvent des informations sur le visiteur que l'assistant ignore — qui il est, quelle formule il a souscrite, quelle page il consulte. Les données supplémentaires vous permettent de les transmettre à l'assistant sous forme de paires clé/valeur. Saisissez un nom de champ et une valeur d'exemple, puis utilisez le bouton + pour ajouter d'autres lignes.

L'étape Export avec son extrait Script contenant la paire botName / Support Bot, puis l'étape des domaines autorisés et l'étape de personnalisation des données supplémentaires où cette paire est saisie

Ajouter une paire modifie l'extrait de l'étape 4 : copiez donc à nouveau le code après toute modification ici. Les valeurs d'exemple que vous saisissez ne servent qu'à construire l'extrait — remplacez-les par de vraies valeurs issues de votre site au moment de le coller.

Note
Les champs injectés peuvent ensuite être référencés depuis les instructions de l'assistant, par exemple pour saluer le visiteur par son nom.