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
Vous créez un widget dans aqoon et le liez à une clé API
Choisissez une clé API — elle détermine quelles collections le chatbot peut interroger.
Collez ce code avant la balise
de votre site web.
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
Cliquez sur Connecteurs dans la barre latérale
Cliquez sur Nouvelle collection
Entrez un nom (affiché dans l'en-tête du chat, ex. « Bot Support »)
Choisissez une clé API — elle détermine quelles collections le chatbot peut interroger.
Définissez les domaines autorisés pour restreindre l'intégration du widget.
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> :
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
Allez dans Chatbot → cliquez sur votre widget
Cliquer sur Collections dans la barre latérale pour gérer vos collections
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.