Docs / Widget Chatbot

Widget Chatbot

Déployez un assistant IA sur votre site web avec une seule ligne de code. Il répond automatiquement aux questions à partir de vos documents.

Comment ça marche

  1. Vous créez un widget dans aqoon et le liez à une clé API
  2. Choisissez une clé API — elle détermine quelles collections le chatbot peut interroger.
  3. Collez ce code avant la balise de votre site web.
  4. Les visiteurs posent des questions → aqoon recherche dans vos documents → Claude génère une réponse
Architecture

L'interface de chat s'exécute dans une iframe depuis le domaine d'aqoon. Tous les appels API sont same-origin — aucune configuration CORS nécessaire sur votre site.

Créer un widget

  1. Cliquez sur Connecteurs dans la barre latérale
  2. Cliquez sur Nouvelle collection
  3. Entrez un nom (affiché dans l'en-tête du chat, ex. « Bot Support »)
  4. Choisissez une clé API — elle détermine quelles collections le chatbot peut interroger.
  5. Définissez les domaines autorisés pour restreindre l'intégration du widget.
  6. Cliquez sur Enregistrer
Clés API - aqoon

Utilisez une clé API restreinte (pas en accès complet) si vous souhaitez que le chatbot ne recherche que dans certaines collections. Créez la clé dans Clés API d'abord, puis sélectionnez-la lors de la création du widget.

Intégration sur votre site web

Après avoir créé un widget, copiez le code d'intégration depuis la page de détail du widget et collez-le avant la balise fermante </body> :

<script src="https://aqoon.ai/widget/wgt_abc123def456.js"></script>

Une bulle de chat apparaît dans le coin de votre page. Cliquez dessus pour ouvrir la fenêtre de chat.

Configuration

Modifiez votre widget pour personnaliser son apparence et son comportement :

Apparence

Paramètres Description
Couleur du thème Couleur d'accentuation de l'en-tête et des boutons
Mode du thème Clair ou sombre
Taille du widget Standard, compact ou pleine page
Position En bas à droite ou en bas à gauche
URL de l'avatar URL d'une image d'avatar affichée dans l'en-tête.
Sous-titre Affiché sous le titre dans l'en-tête

Détails de la clé

Paramètres Description
Message de bienvenue Premier message affiché à l'ouverture du chat
Suggestions Boutons de suggestions cliquables (un par ligne)
Texte indicatif du champ de saisie Texte indicatif dans le champ de saisie
Ouverture automatique Le widget s'ouvre automatiquement au chargement de la page
Contact de secours Informations de contact affichées quand le bot ne peut pas répondre.
Instructions personnalisées Instructions supplémentaires (ex. « Toujours répondre en français »)

Capture de leads

Activez Exiger la capture de leads dans les paramètres du widget. Les visiteurs doivent entrer leur nom et leurs coordonnées avant de discuter. Ces données apparaissent dans la liste des conversations de votre tableau de bord.

Conversations

  1. Allez dans Chatbot → cliquez sur votre widget
  2. Cliquer sur Collections dans la barre latérale pour gérer vos collections
  3. Cliquez sur une conversation pour voir la transcription complète avec le markdown rendu

Chaque session affiche : nom du visiteur, nombre de messages, statut (actif/fermé), note étoilée et horodatages.

Note

Les utilisateurs peuvent clore une conversation en :

  • Tapant un mot de clôture (merci, thank you, bye, au revoir, etc.) — l'overlay de notation apparaît automatiquement après la réponse
  • Cliquez sur l'icône + en haut

L'overlay de notation demande 1–5 étoiles et un commentaire optionnel.

Limites et contrôle des coûts

Paramètres Par défaut Description
Limite de messages quotidiens 100 Messages max par jour pour tous les visiteurs
Limite de messages mensuels 3,000 Messages max par mois
Tokens max par réponse 1,024 Contrôle la longueur de la réponse et le coût LLM
Fragments de contexte 5 Nombre max de résultats de recherche envoyés au contexte LLM.
Rétention des conversations (jours) 30 jours Durée de conservation des messages (0 = ne pas stocker)

Lorsque les limites quotidiennes ou mensuelles sont dépassées, le widget se met automatiquement en pause et affiche « Cet assistant est actuellement indisponible. » Vous pouvez le reprendre manuellement depuis le tableau de bord.

Sécurité

  • Verrouillage de domaine — Seuls les domaines autorisés peuvent intégrer le widget. Les requêtes d'autres origines sont rejetées.
  • Limitation de débit — 5 messages par minute et 50 par jour par adresse IP, en plus des limites budgétaires du widget.
  • CAPTCHA Turnstile — Intégration optionnelle de Cloudflare Turnstile pour la protection anti-bot. Ajoutez votre clé de site dans les paramètres du widget.
  • Extrait de contenu — Un aperçu du texte correspondant
  • Protection contre l'injection de prompt — Les messages des utilisateurs sont isolés du prompt système. Le contexte documentaire utilise des délimiteurs XML.
  • Assainissement des sorties — Les réponses de l'IA sont nettoyées avant le rendu pour prévenir les attaques XSS.
  • Anonymisation des IP — Les adresses IP des visiteurs sont automatiquement anonymisées après 7 jours.

Téléversement de fichier

Quand un widget est lié à un agent avec l'outil Interpréteur de code activé, les visiteurs peuvent joindre des fichiers à leurs messages. Cela permet à l'agent de lire et d'analyser les documents téléchargés directement dans la conversation.

Formats pris en charge : PDF et DOCX. Taille maximale : 20 Mo par fichier.

Un bouton trombone apparaît dans la barre de saisie des messages quand l'envoi de fichiers est disponible. Le visiteur clique dessus pour choisir un fichier, attend la fin du téléchargement, puis envoie son message. L'agent reçoit le message et le fichier.

Nécessite l'Interpréteur de code

L'envoi de fichiers est disponible uniquement quand le widget est lié à un agent Actif avec l'outil Interpréteur de code activé. Il n'apparaît pas sur les widgets RAG standard.

Pour activer l'envoi de fichiers : ouvrez l'agent lié à votre widget, activez l'Interpréteur de code dans la section Outils, et re-publiez l'agent.