Chatbot Builder - Aide
Guide complet pour créer des chatbots IA à partir de divers documents et sources web
Aperçu
Chatbot Builder (Chatbotty.ai)est une plateforme optimisée Redis Cache pour créer des chatbots IA à partir de divers documents et sources web. Elle s'adresse à tous ceux qui ont besoin de fournir des réponses de qualité aux questions des utilisateurs basées sur des documents actuels — administrations publiques, organisations, entreprises et particuliers.
✨ Fonctionnalités clés
🤖 IA et traitement
- • Chatbots IA à partir de divers documents et sources web
- • Routage IA intelligent pour une qualité de réponse optimale
- • Base de données vectorielle pour la recherche sémantique
- • Découpage avancé selon le type de document
⚡ Performance et fiabilité
- • Mise en cache multi-niveaux (Memory → Redis → PostgreSQL)
- • Widget asynchrone sans impact sur la vitesse de la page
- • Protection contre les abus et les attaques de bots
- • Limites de débit flexibles pour chaque chatbot
📊 Gestion et analytics
- • Nombreuses options de personnalisation et de configuration
- • Remplacement automatique des documents par de nouvelles versions
- • Analytics en temps réel et optimisation de la qualité
- • Gestion automatique des abonnements et des niveaux
🎯 Idéal pour
- Administrations publiques et institutions
Automatisation des services d'information aux citoyens, réponses aux questions fréquentes sur les procédures officielles
- E-commerce et services en ligne
Support client intelligent sans centre d'appel, gestion des commandes et des réclamations
- Entreprises avec une documentation étendue
Recherche rapide dans les ressources internes, intégration des nouveaux employés
- Établissements d'enseignement
Soutien aux étudiants et réponses aux questions fréquentes, informations sur les programmes d'études
- Établissements de santé
Information des patients et soutien administratif, guides patients
- Cabinets juridiques
Accès rapide aux documents juridiques et précédents, analyse des affaires
- Entreprises IT et technologiques
Automatisation du support technique et documentation API, résolution de problèmes courants
- Sociétés de conseil
Partage d'expertise et de meilleures pratiques, base de connaissances interne
- Agences marketing
Analyse des besoins clients et optimisation du contenu, assistance aux briefs créatifs
Premiers pas
🎯 Guide rapide
- 1Inscription et connexion
Créez votre compte. Vous obtenez automatiquement le niveau Evaluation pendant 14 jours avec 3 000 messages/mois (plus que les 500 d'Elite) ainsi que toutes les fonctionnalités Elite.
- 2Création de votre premier chatbot
Cliquez sur "Nouveau chatbot" → saisissez le nom et la description → choisissez le style de réponse (formel/amical/professionnel). Après la création, vous serez redirigé vers les paramètres détaillés où vous pourrez personnaliser tous les paramètres du chatbot selon vos besoins.
- 3Téléchargement de documents
Glissez-déposez des fichiers PDF/DOCX/TXT/MD ou saisissez l'URL d'une page web. Vous pouvez choisir le type de document pour une stratégie de découpage optimale (juridique, technique, académique, actualités, général).
- 4Test et intégration
Testez le chatbot en mode aperçu → copiez le code d'intégration → insérez-le sur votre site web
⚡ Conseils rapides pour démarrer
📄 Préparation des documents
- • Structure : Utilisez des titres clairs, des puces et une numérotation
- • Format : PDF avec texte lisible (pas d'images scannées)
- • Taille : La taille du fichier affecte la vitesse de traitement
- • Contenu : Supprimez les doublons et les parties non pertinentes
- • Langue : Terminologie et style cohérents
- • Métadonnées : Noms de fichiers clairs pour une meilleure organisation
- • Actualité : Utilisez les dernières versions des documents
🎨 Intégration du widget
Intégration simple via code JavaScript :
<script src="https://chatbotty.ai/chatbot-embed.js" data-chatbot-id="xxxxxxxx"> </script>
- • Chargement asynchrone sans blocage de la page
- • Support multi-domaine
Gestion des chatbots
➕ Créer des chatbots
🎯 Configuration de base
Informations de base :
- • Nom du chatbot : Identification de votre chatbot
- • Description : Brève description de l'objectif du chatbot
- • Style de réponse : Formel / Amical / Professionnel / Informel
🎨 Apparence
Personnalisation de l'apparence du widget chatbot :
- • Couleur du thème : Sélection parmi les couleurs prédéfinies
- • Message de bienvenue : Texte pour le premier contact avec l'utilisateur
- • Message d'erreur : Texte affiché lorsque le chatbot est indisponible
- • Domaines autorisés : Spécifiez où le widget peut être utilisé
💎 Nombre maximum de chatbots par abonnement
Free
1 chatbot
Evaluation
1 chatbot
Essai 14 jours
Basic
1 chatbot
Elite
2 chatbots
Enterprise
3 chatbots
🗑️ Confirmation de suppression
Processus de suppression sécurisé
Lors de la suppression d'un chatbot, une boîte de dialogue de confirmation apparaît pour éviter toute suppression accidentelle.
⚠️ Avertissement :
Toutes les données du chatbot, les documents et les analytics seront définitivement supprimés et ne pourront pas être récupérés.
Paramètres avancés du chatbot
🧠 Comportement de l'IA et prompts
📝 Instructions système
Définissez la personnalité et le comportement de l'assistant IA. Contient des directives pour :
- • Style de communication et ton des réponses
- • Comportement général et règles
- • Instructions critiques pour les limitations
🏷️ Variables disponibles
Les variables suivantes peuvent être utilisées dans les prompts et messages :
- •
{current_datetime}- Date et heure actuelles - •
{chatbot_id}- Identifiant unique du chatbot - •
{fallback_message}- Message de repli personnalisé quand aucune réponse n'est trouvée
⚡ Qualité de recherche et de réponse
🔍 Paramètres de recherche
- • Seuil de similarité (0,4) : Correspondance minimale pour utiliser le document
- • Nombre de fragments en contexte (5) : Combien de fragments de document l'IA reçoit
- • Routage intelligent du modèle : Sélectionne automatiquement le meilleur modèle selon la complexité
- • Tickets de support automatiques : Quand l'IA ne peut pas répondre, elle propose de créer un ticket. Nécessite le consentement et l'email de l'utilisateur.
- • Force Fallback : Quand activé, affiche toujours le message de repli pour les requêtes avec peu de pertinence documentaire. Quand désactivé, l'IA répond même sans documents pertinents (mode conversationnel).
⚙️ Préférences de langue et paramètres IA
- • Langue de réponse du chatbot : Langue dans laquelle le chatbot répondra
- • Fuseau horaire : Pour les réponses sur la date et l'heure actuelles
- • Créativité (Température) : 0,0 = précis, 1,0 = réponses créatives
- • Longueur maximale de réponse (tokens) : Limite en tokens (≈ 375 mots pour 500 tokens)
🛡️ Protection anti-spam
- • Max requêtes/jour : Nombre maximum de requêtes depuis une adresse IP par 24h (protection anti-bot)
- • Max requêtes/session : Nombre maximum de requêtes par session (fenêtre de 2h pour prévenir les abus)
- • Limite de débit par minute : Protection contre les requêtes spam
- • Cache TTL (secondes) : Durée de mise en cache des réponses
🔄 Réinitialiser les paramètres
Restaurer les paramètres par défaut
Le bouton 'Réinitialiser' restaure tous les paramètres avancés à leurs valeurs par défaut. Une boîte de dialogue de confirmation apparaît avant la réinitialisation.
ℹ️ Remarque :
Vous pouvez toujours réinitialiser vos paramètres aux valeurs par défaut si vous souhaitez repartir de zéro ou si quelque chose ne fonctionne pas comme prévu.
Gestion des documents
📤 Téléchargement de fichiers
📋 Sources prises en charge
Fichiers
PDF, DOCX, TXT, MD, HTML
Web URL
Scraping automatique
Mises à jour
Remplacement automatique de version
🎯 Préparation optimale des documents
✅ Pratiques recommandées :
- • Titres et structure clairs
- • PDF avec texte lisible (pas d'images)
- • Formatage cohérent
- • Numérotation logique des sections
❌ À éviter :
- • Images scannées sans OCR
- • Fragmentation excessive du texte
- • Formatage incohérent
- • Fichiers de plus de 10 Mo
💾 Limites de stockage par abonnement
Free
10 Mo total
Evaluation
20 Mo total
Basic
10 Mo total
Elite
20 Mo total
Enterprise
50 Mo total
📋 Détection des doublons
Gestion intelligente des doublons
Lors du téléchargement d'un document avec le même nom qu'un document existant, une boîte de dialogue apparaît pour éviter les écrasements accidentels.
Options disponibles :
- • Remplacer : Écrase le document existant par la nouvelle version
- • Garder les deux : Conserve les deux versions (le nouveau fichier reçoit un suffixe numéroté)
📄 Processus de téléchargement
Sélectionner le chatbot
Choisissez le chatbot auquel le document sera assigné
Choisir la méthode de téléchargement
📎 Fichiers (PDF, DOCX, TXT, MD)
Maximum 10 Mo par fichier
🌐 Web URL
Scraping automatique de pages web
Sélectionner le type de document
Le système optimise automatiquement le traitement selon le type :
Document juridique :
Lois, règlements, contrats
Manuel technique :
Guides, spécifications, procédures
Actualités :
Articles, communiqués de presse
Texte académique :
Articles scientifiques, études
Document général :
Paramètres universels
Décrire le document (facultatif)
Ajoutez une description pour faciliter la navigation future dans la liste des documents
Conseil de mise à jour
En entrant le même nom de document, vous avez la possibilité de remplacer automatiquement la version originale sans avoir à supprimer le document obsolète. Vos données resteront à jour.
Widget de chat
🔧 Intégration web (afficher le chatbot sur votre site)
📋 Obtenir le code d'intégration
Vous trouverez le code d'intégration pour chaque chatbot dans le menu contextuel (trois points). Cliquez sur "Copier le code d'intégration" et collez-le sur votre site avant la balise fermante </body>.
<script src="https://chatbotty.ai/chatbot-embed.js" data-chatbot-id="xxxxxxxx"> </script>
💡 Conseil :Le widget se charge de manière asynchrone et n'affecte pas la vitesse de votre page. La bulle de chat apparaît une fois la configuration chargée en arrière-plan.
🔴 Remarque :Si le chatbot est désactivé, le widget n'apparaîtra pas du tout sur le site web.
⚠️ Installation via GTM :Si vous intégrez le widget via Google Tag Manager et qu'un visiteur refuse les cookies, GTM ne se chargera pas et le chatbot n'apparaîtra pas. Nous recommandons d'intégrer le code directement dans le HTML, hors de GTM.
⚙️ Configuration du widget
Vous pouvez entièrement personnaliser le widget dans la section "Apparence"lors de l'édition du chatbot. Tous les paramètres sont automatiquement appliqués au code d'intégration.
🎨 Apparence et position :
- • Couleur du thème : 6 couleurs prédéfinies (bleu, rouge, vert, jaune, violet, orange)
- • Position du widget : En bas à droite / En bas à gauche
- • Message de bienvenue : Accueil de l'utilisateur
- • Message de repli : Texte pour les cas où le chatbot ne connaît pas la réponse
⚙️ Comportement du chatbot :
- • Nom du chatbot : Affiché dans l'en-tête
- • Description : Courte description de l'objectif (non affichée sur le web)
- • Style de réponse : Professionnel, amical, formel
- • Statut : Chatbot actif/inactif
🎯 Personnalisation du widget
Options de position :
- • En bas à droite (par défaut)
- • En bas à gauche
Effets de la bulle :
- • Effet pulse - Bulle animée pour attirer l'attention (peut être activé/désactivé)
👁️ Aperçu du widget
Utilisez la fenêtre d'aperçu pour tester votre chatbot avant l'intégration :
- • Cliquez sur le bouton "Aperçu" dans les paramètres du chatbot
- • Ouvre le widget dans une fenêtre modale
- • Testez toutes les fonctionnalités et l'apparence
- • Aucune installation de code nécessaire
🔗 Page publique du widget
Accédez à votre widget sur : /widget-embed/[widgetId]
- • Page autonome pour les tests
- • Peut être partagée avec les membres de l'équipe
- • Aucune intégration de site web requise
💡 Conseil : Toutes les modifications prennent effet immédiatement sur tous les sites avec le widget intégré. Pas besoin de modifier le code.
⚡ Optimisation des performances
🚀 Chargement asynchrone
- • Chargement asynchrone en arrière-plan
- • La bulle apparaît une fois la configuration prête
- • Zéro impact sur la vitesse de la page principale
- • Amélioration progressive
💾 Cache intelligent
- • Taux de cache hit 90%+
- • Validité de configuration de 5 minutes
- • Chargement rapide via Redis
- • Fonctionnement fluide même en cas de panne Redis
🔒 Sécurité et restrictions
🌐 Restrictions de domaine
Limitez l'accès uniquement aux domaines autorisés :
Exemple de configuration :
- • example.com
- • *.example.com (sous-domaines inclus)
🛡️ Protection anti-spam
Paramètres de limite de requêtes pour la protection contre le spam et les abus
Max requêtes/jour
50
Nombre maximum de requêtes depuis une adresse IP par 24h (protection anti-bot)
Max requêtes/session
20
Nombre maximum de requêtes par session (fenêtre de 2h pour prévenir les abus)
Limite de requêtes/min
10
🛡️ Protection contre les requêtes spam
Cache TTL (secondes)
300
⚡ Durée de mise en cache des réponses
📝 Remarque :
Ces paramètres sont entièrement configurables par l'utilisateur dans les paramètres avancés de chaque chatbot pour une flexibilité maximale.
Analytics
🎯 Accès par abonnement
🆓 Free
Pas d'accès
Popup de mise à niveau avec instructions
⭐ Evaluation
Accès complet
14 jours de fonctionnalités Elite
🔵 Basic
Métriques de base
- • Nombre de messages
- • Requêtes principales
- • Stats du chatbot
👑 Elite+
Analytics détaillées
- • Taux de réussite
- • Export de données
- • Rapports détaillés
- • Interface interactive
- • Analytics par chatbot séparément
🤖 Analytics détaillées par chatbotElite+
📋 Affichage par chatbot
- • Vue individuelle : Analytics séparées pour chaque chatbot
- • Filtrage des requêtes : Afficher uniquement les conversations pertinentes
- • Métriques isolées : Performances individuelles séparées
- • Comparaison : Possibilité de comparer les performances de différents bots
🔍 Affichage détaillé des requêtes
- • Requête complète : Affichage de la question entière de l'utilisateur
- • Fiabilité de la réponse : Valeur exacte du score de confiance
- • Réponse IA : Texte complet de la réponse du chatbot
- • Horodatage : Date et heure de chaque requête
💡 Utilisation pratique :Permet une analyse précise de la façon dont les chatbots répondent aux requêtes, l'identification des problèmes et l'optimisation des documents pour chaque chatbot séparément.
📈 Métriques disponibles
🎯 KPIs principaux
📊 Qualité des réponses
⚠️ Limites d'historique par abonnement
Les données correspondant au nombre maximum de requêtes par mois selon votre abonnement sont conservées. Les données plus anciennes sont automatiquement supprimées pour l'optimisation des performances.
- • Free : 200 requêtes
- • Basic : 3 000 requêtes
- • Elite : 6 000 requêtes
- • Enterprise : 10 000 requêtes
📤 Export et rapports
📋 Disponibilité : La fonctionnalité d'export est disponible uniquement pour les abonnements Elite+ (Elite et Enterprise).
💡 Conseil :Nous recommandons d'exporter les données le dernier jour de chaque mois pour suivre l'historique complet des requêtes.
💾 Formats d'export
- • CSV : Données tabulaires pour Excel
- • JSON : Données structurées pour API
🔍 Filtres de données
🕐 Filtres temporels :
- • Cette semaine : 7 derniers jours
- • Ce mois : Mois en cours
- • Cette année : Année en cours
📋 Filtres par réponse :
- • Toutes les requêtes : Historique complet
- • ✓ Répondu : Réponses réussies
- • ⚠ Partiellement répondu : Réponses incomplètes
- • ✗ Sans réponse : Pas de réponse
Abonnement
🎯 Aperçu des abonnements
Free
Perfect for getting started
•10MB storage
•1 chatbot
•100 requests/month
•Basic support
•✅ Conversation history
•❌ Basic analytics
•❌ Web URL scraping
•❌ Analytics export
•❌ API access
•❌ Support tickets
•❌ Webhook actions
•❌ White-label branding
•➕ Buy extra requests
Evaluation
14-day trial with Enterprise features
•10MB storage
•1 chatbot
•500 requests/month
•✅ Conversation history
•✅ Detailed analytics
•✅ Web URL scraping
•✅ Analytics export
•✅ API access
•✅ Support tickets (AI)
•✅ Webhook actions (n8n)
•❌ White-label branding
•➕ Buy extra requests
•Auto-downgrade to Free
Basic
For growing businesses
•25MB storage
•1 chatbot
•3000 requests/month (total)
•Priority support
•✅ Conversation history
•✅ Basic analytics
•❌ Web URL scraping
•❌ Analytics export
•❌ API access
•❌ Support tickets
•❌ Webhook actions
•❌ White-label branding
•➕ Buy extra requests
Elite
Most popular
•50MB storage
•2 chatbots (max)
•6000 requests/month (total)
•Priority support
•✅ Conversation history
•✅ Detailed analytics
•✅ Web URL scraping
•✅ Analytics export
•✅ API access
•❌ Support tickets
•❌ Webhook actions
•❌ White-label branding
•➕ Buy extra requests
Enterprise
Custom solutions
•100MB storage
•3 chatbots (max)
•10000 requests/month (total)
•Premium support
•✅ Conversation history
•✅ Detailed analytics
•✅ Web URL scraping
•✅ Analytics export
•✅ API access
•✅ Support tickets (AI)
•✅ Webhook actions (n8n)
•✅ White-label branding
•➕ Buy extra requests
💡 Utilisation des données
10 Mo de données correspondent à environ 1 000 pages de document PDF. En formats purement texte, encore plus.
Avertissement : La taille originale du fichier téléchargé est comptée dans les limites de données. Les images intégrées dans les documents peuvent considérablement augmenter la taille du fichier.
💰 Abonnement annuel
Économisez 2 mois avec la facturation annuelle — ne payez que 10 mois !
La facturation annuelle offre des économies significatives par rapport aux paiements mensuels. Vous pouvez modifier votre période de facturation ou votre abonnement à tout moment.
⏰ Expiration de la période d'essai
- • Rétrogradation automatique vers le plan Free après 14 jours
- • Transition transparente sans perte de données
📊 Suivi d'utilisation
📊 Suivi dans le dashboard
Suivez votre utilisation du plan directement en temps réel :
📈 Limites mensuelles
- • Nombre de messages par mois
- • Prévision jusqu'à la fin du mois
- • Réinitialisation automatique chaque mois
📋 Limites permanentes
- • Capacité de stockage (Mo/Mo)
- • Nombre de chatbots (compte/limite)
📊 Statistiques
- • Total des chatbots créés
- • Chatbots actifs et fonctionnels
- • Total des requêtes des utilisateurs
- • Documents téléchargés
📈 Visualisation
- • Barres de progression colorées
- • Suivi en temps réel
⚠️ Enforcement des limites
- • Stockage dépassé : Upload bloqué avec invitation à mettre à niveau
- • Limite de chatbots : Création bloquée, dialogue de mise à niveau affiché
- • Messages mensuels : Le widget ne se charge pas (échec silencieux)
- • Accès analytics : Restrictions de fonctionnalités selon le plan
💰 Extra Messages Add-ons
Extra messages are additional message packages you can purchase to extend your monthly quota. Unlike monthly subscriptions, extra messages never expire and persist across billing cycles.
🔄 How it works:
- Your monthly quota is consumed first
- When monthly quota is exhausted, extra messages are automatically used
- Extra messages persist until fully consumed (no expiration)
- Visible on dashboard with real-time tracking
📦 Available Packages:
💡 When to buy:
- • Seasonal traffic spikes
- • Special campaigns
- • Testing before upgrade
- • One-time high usage
💳 Purchase:Click "Buy Extra Messages" on dashboard or in usage tracking card when approaching limit.
Factures
📋 Aperçu
Toutes vos factures et votre historique de paiements sont disponibles directement dans le portail client. Vous y trouverez les abonnements, les achats d'add-ons et tous les paiements passés.
🔗 Comment accéder
- Allez dans Abonnement dans la barre latérale du dashboard
- Cliquez sur le bouton Gérer l'abonnement
- Vous serez redirigé vers le portail client où vous pouvez consulter toutes les factures et l'historique des paiements
Paramètres
👤 Gestion du compte utilisateur
📝 Changer le nom
Informations personnelles
- • Nom : Nom d'utilisateur affiché
- • Peut être modifié à tout moment
- • Visible dans le profil et les communications
📧 Changer l'email
Après avoir soumis la nouvelle adresse, des liens de confirmation sont envoyés à vos deux adresses actuelles et nouvelles. La modification prend effet uniquement après avoir cliqué sur les deux liens.
- • Vérifiez votre boîte actuelle et confirmez depuis là
- • Vérifiez votre nouvelle boîte et confirmez depuis là
- • Seulement après les deux confirmations le nouvel email sera actif
🔒 Changer le mot de passe
Le mot de passe doit comporter au moins 6 caractères
Exigences du mot de passe :
- • Minimum 6 caractères
- • Combinaison de lettres et chiffres
- • Mot de passe actuel requis
Mot de passe oublié :
- • Réinitialisation par email
- • Lien de réinitialisation sécurisé
- • Livraison immédiate
🌐 Paramètres de langue
Basculer entre les interfaces disponibles
- • Cliquez sur le sélecteur de langue dans la navigation supérieure
- • Langues disponibles : Anglais (EN) / Tchèque (CS)
- • Rechargement automatique de la page — La page se recharge automatiquement après le changement de langue
- • La préférence de langue est enregistrée dans votre compte
⚠️ Zone de danger
Les actions dans cette section sont irréversibles. Procédez avec prudence.
⚠️ La suppression de votre compte supprimera définitivement toutes vos données, chatbots, documents et conversations. Cette opération est irréversible.
Le bouton "Supprimer le compte" déclenchera la suppression complète de toutes les données de la base de données.
API
🚀 Accès programmatique aux chatbots
💎 Disponible pour les niveaux supérieurs
L'accès API est disponible pour les utilisateurs avec les niveaux d'abonnement Evaluation, Elite et Enterprise. Il vous permet d'intégrer vos chatbots dans des applications, sites web ou systèmes personnalisés.
📋 Ce que vous obtenez
- • REST API : Requêtes HTTP standard
- • Exemples de code : JavaScript, Python, PHP, Node.js
- • Chatbot ID : Identifiant unique pour chaque chatbot
- • Documentation complète : Disponible directement dans l'application
💡 Pour commencer : Après vous être connecté, vous trouverez la section "Intégration API" dans le menu, où vous pouvez accéder aux instructions détaillées incluant des exemples de connexion pour divers langages de programmation.
🔐 Authentification API
Comment ça fonctionne
L'accès API utilise l'authentification par token Bearer. Chaque clé API est liée à un chatbot spécifique.
- Créez une clé API dans Dashboard → Intégration API pour votre chatbot
- Incluez la clé API dans l'en-tête Authorization comme token Bearer
- Envoyez une requête POST au endpoint
/api/chat - Le chatbot est automatiquement identifié à partir de la clé API
Important : Vous n'avez PAS besoin d'envoyer chatbot_id dans le corps de la requête. Le chatbot est déterminé à partir de votre clé API.
🔑 Gestion des clés API
Créer des clés API
Générez des clés API sécurisées pour l'accès programmatique à vos chatbots.
Fonctionnalités :
- • Noms personnalisés — Étiquetez les clés pour une identification facile
- • Max 50 clés — Limite par chatbot
- • Tokens sécurisés — Token complet affiché une seule fois à la création
- • Suivi d'activité — Horodatage de dernière utilisation
- • Basculer actif/inactif — Désactivation temporaire sans suppression
Sécurité :
- • Les tokens sont masqués dans l'interface (premier/dernier caractères uniquement)
- • Copier dans le presse-papiers pour une utilisation facile
- • Supprimer immédiatement les clés compromises
⚡ Quota mensuel :L'utilisation de l'API est comptée dans votre limite mensuelle de messages. Des messages supplémentaires peuvent être achetés lorsque le quota est dépassé.
💻 Exemples de code
JavaScript (Navigateur)
// 1. first request – no conversation_id needed
const response = await fetch('https://chatbotty.ai/api/chat', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
message: 'What is your return policy?'
// conversation_id not required – created automatically
})
})
const result = await response.json()
const conversationId = result.data.conversation_id // save for follow-up requests
// 2. follow-up request – previous messages loaded as context
const response2 = await fetch('https://chatbotty.ai/api/chat', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
message: 'What about exchanges?',
conversation_id: conversationId
})
})Node.js
const response = await fetch('https://chatbotty.ai/api/chat', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
message: 'What is your return policy?',
conversation_id: conversationId // optional: to continue a conversation
})
})
const result = await response.json()
console.log(result.data.message)
// result.data.conversation_id – save for follow-up requestsPython
import requests
response = requests.post(
'https://chatbotty.ai/api/chat',
headers={
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
json={
'message': 'What is your return policy?',
'conversation_id': conversation_id # optional: to continue a conversation
}
)
result = response.json()
print(result['data']['message'])PHP
<?php
$ch = curl_init('https://chatbotty.ai/api/chat');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
'message' => 'What is your return policy?',
'conversation_id' => $conversationId // optional: to continue a conversation
]));
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);
echo $result['data']['message'];
?>cURL
curl -X POST https://chatbotty.ai/api/chat \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"message": "What is your return policy?"}'📋 Format de réponse
Réponse réussie
{
"success": true,
"data": {
"message": "AI response text...",
"conversation_id": "550e8400-e29b-41d4-a716-446655440000",
"sources": [
{
"content": "Relevant document excerpt...",
"similarity": 0.95,
"page": 1
}
],
"metadata": {
"tokensUsed": 150,
"cached": false,
"responseTime": 1234,
"searchResults": 3
}
},
"timestamp": "2025-01-28T10:00:00.000Z"
}Réponse d'erreur
{
"success": false,
"error": "Internal server error",
"timestamp": "2025-01-28T10:00:00.000Z"
}⚠️ Remarques importantes
- • Les clés API sont spécifiques aux chatbots — Chaque clé fonctionne avec un seul chatbot
- • Jusqu'à 50 clés par chatbot — Créez plusieurs clés pour différentes applications
- • Les clés peuvent être désactivées — Désactivation temporaire sans suppression
- • Le quota mensuel s'applique — Limité par les messages/mois de votre niveau + messages supplémentaires achetés
- • Pas de limitation de débit par minute — L'API est conçue pour un accès programmatique sans limites de débit
- • Pas de validation de domaine — L'API fonctionne depuis n'importe quelle origine (utilisez avec précaution)
- • Contexte de conversation — Chaque réponse retourne un
conversation_id. Transmettez-le dans les requêtes suivantes pour maintenir le contexte — le système charge les 20 derniers messages automatiquement. Sansconversation_id, chaque requête démarre une nouvelle conversation sans contexte. - • Sécurisez vos clés — N'exposez jamais les clés API dans le code côté client
Conversations
📝 Fonctionnement
La fonctionnalité d'historique des conversations enregistre automatiquement toutes les sessions du chatbot avec des métadonnées complètes à des fins d'analytique, de conformité et d'assurance qualité.
- • Journalisation des sessions : Chaque conversation est enregistrée avec un identifiant de session unique
- • Suivi des métadonnées : Adresse IP, URL de la page, référent, agent utilisateur
- • Horodatages : Timing précis pour chaque échange de messages
- • Informations de contact : E-mail et nom fournis par l'utilisateur si disponibles
🔍 Consulter les conversations
Accédez à l'historique des conversations depuis le dashboard → Conversations dans le menu principal.
Filtres disponibles :
- • Période : Filtrer par période (ce mois-ci, 7 derniers jours, etc.)
- • Filtre (Chatbot) : Afficher les conversations d'un chatbot spécifique ou de tous
- • Source : Filtrer par source (widget, API, etc.)
Colonnes affichées :
- • ID de session, Date/Heure, Nom du chatbot
- • Nombre de messages, Source, E-mail de contact
- • Adresse IP (anonymisée), URL de la page
📋 Détails d'une conversation
Cliquez sur une conversation pour afficher l'historique complet des messages avec les informations détaillées.
- • Chronologie des messages : Toutes les questions des utilisateurs et les réponses de l'IA
- • Données de timing : Horodatages exacts pour chaque message
- • Métadonnées source : URL de la page, référent, agent utilisateur
- • Informations de contact : E-mail et nom si l'utilisateur les a fournis
💡 Conseil : Utilisez l'historique des conversations pour identifier les questions fréquemment posées et améliorer la base de connaissances de votre chatbot. Les tendances dans les requêtes des utilisateurs peuvent vous aider à ajouter la documentation manquante.
Tickets de support
Fonctionnalité Enterprise
Les tickets de support alimentés par l'IA sont disponibles uniquement pour les utilisateurs du niveau Enterprise.
🤖 Fonctionnement
Le système de tickets de support IA détecte automatiquement quand le chatbot ne peut pas répondre à la question d'un utilisateur et propose de créer un ticket de support pour un suivi humain.
- • Détection intelligente : L'IA reconnaît quand elle ne peut pas fournir une réponse satisfaisante
- • Consentement de l'utilisateur : Le système demande à l'utilisateur s'il souhaite créer un ticket
- • Collecte d'e-mail : Collecte l'e-mail de l'utilisateur pour le suivi
- • Résumé IA : Génère un résumé de la conversation pour l'équipe de support
📝 Flux de création de ticket
Le flux de conversation multi-tours pour la création de ticket :
- Déclenchement : L'IA détecte une question sans réponse ou l'utilisateur exprime sa frustration
- Proposition : "Souhaitez-vous que je crée un ticket de support pour vous ?"
- Consentement : L'utilisateur confirme vouloir continuer
- E-mail : "Veuillez fournir votre adresse e-mail pour le suivi"
- Résumé : L'IA génère automatiquement un résumé de la conversation
- Confirmation : Ticket créé avec numéro de référence
📋 Gestion des tickets
Accédez et gérez les tickets de support depuis le dashboard → Tickets de support.
Flux de statut :
- • Ouvert : Nouveau ticket en attente de traitement
- • En cours : L'équipe de support travaille sur le problème
- • Résolu : Problème traité, en attente de confirmation
- • Fermé : Ticket terminé et archivé
Actions disponibles :
- • Afficher le contexte complet de la conversation
- • Mettre à jour le statut du ticket
- • Ajouter des notes internes
- • Envoyer une réponse par e-mail à l'utilisateur
⚙️ Configuration
Activez et configurez les tickets de support dans Paramètres du chatbot → onglet Tickets de support.
- • Activer/Désactiver : Basculer la création de tickets pour ce chatbot
- • Notifications e-mail : Recevoir des alertes pour les nouveaux tickets
- • Réponse automatique : Message personnalisé envoyé à l'utilisateur après la création du ticket
- • Déclencheurs : Configurer quand les propositions de ticket sont faites
💡 Conseil : Examinez régulièrement les tickets pour identifier les lacunes dans votre base de connaissances. Les sujets récurrents indiquent les domaines où vous devriez ajouter plus de documentation.
Actions webhook
Fonctionnalité Enterprise & Évaluation
Les actions webhook sont disponibles pour les utilisateurs Enterprise (jusqu'à 10 webhooks, jusqu'à 10 outils au total) et Évaluation (jusqu'à 5 webhooks, jusqu'à 5 outils au total).
🔗 Vue d'ensemble
Les actions webhook permettent à votre chatbot d'interagir avec des systèmes externes via des appels d'outils déclenchés par l'IA. Définissez des webhooks personnalisés avec des outils spécifiques que l'IA peut invoquer pendant les conversations.
- • Webhooks personnalisés : Définir des endpoints avec authentification
- • Outils IA : Spécifier les outils que l'IA peut appeler (ex. get_order_status)
- • Paramètres : Définir les paramètres requis et optionnels pour chaque outil
- • Gestion des réponses : L'IA traite naturellement les réponses webhook
⚙️ Configuration des webhooks
Configurez les webhooks dans le dashboard → Webhooks pour chaque chatbot.
- Créer un webhook : Saisir le nom, l'URL et les en-têtes d'authentification optionnels
- Définir les outils : Ajouter les outils que l'IA peut appeler (ex. get_order_status, check_inventory)
- Définir les paramètres : Définir les paramètres requis (ex. order_id, product_sku)
- Tester : Utiliser la fonction de test pour vérifier que le webhook fonctionne correctement
- Activer : Activer le webhook pour l'utilisation en production
🔄 Intégration n8n
n8n est un puissant outil d'automatisation de workflows qui fonctionne parfaitement avec notre système webhook.
Configuration rapide :
- Créer un nouveau workflow dans n8n
- Ajouter un nœud déclencheur Webhook (méthode POST)
- Copier l'URL webhook dans la configuration webhook du chatbot
- Construire la logique du workflow (appels API, requêtes de base de données, etc.)
- Retourner une réponse JSON que l'IA va traiter
Exemple de format de réponse :{"status": "shipped", "tracking": "1Z999AA1", "eta": "2024-01-15"}
💡 Exemples d'utilisation
📦 Suivi de commande
Le client demande "Où est ma commande ?" → L'IA appelle get_order_status avec le numéro de commande → Retourne les infos de suivi
👤 Intégration CRM
L'utilisateur fournit son e-mail → L'IA appelle lookup_customer → Retourne les détails du compte et l'activité récente
📅 Prise de rendez-vous
L'utilisateur demande un rendez-vous → L'IA appelle check_availability puis book_appointment → Confirme la réservation
🔍 Vérification des stocks
Le client demande la disponibilité d'un produit → L'IA appelle check_stock → Retourne l'inventaire actuel
🔒 Sécurité
- • HTTPS obligatoire : Tous les endpoints webhook doivent utiliser HTTPS
- • En-têtes personnalisés : Ajouter des jetons d'authentification dans les en-têtes
- • Gestion des délais : Délai de 30 secondes pour éviter les requêtes bloquées
- • Protection SSRF : Les adresses IP privées sont bloquées pour la sécurité
- • Limitation de débit : Protection intégrée contre les appels excessifs
⚠️ Important : N'exposez jamais des clés API sensibles dans les URLs webhook. Utilisez plutôt les en-têtes d'authentification.
💡 Conseil : Commencez par des opérations simples en lecture seule (comme la consultation de commandes) avant d'implémenter des opérations d'écriture. Testez thoroughly avec le testeur webhook intégré avant d'activer en production.
Conseils & Astuces pour la préparation des documents et la mise en œuvre réussie du chatbot
📄 Préparation des documents
📋 Structuration du contenu
- • Division thématique : Un fichier = un sujet
- • Structure logique : Sections et titres clairs
- • Mises à jour faciles : Modifier uniquement les parties pertinentes
- • Clarté : Orientation rapide dans le contenu
📝 Format et nommage
- • Formats texte : TXT, DOC, DOCX (sans images)
- • Noms clairs : Noms de fichiers descriptifs
- • Mise à jour automatique : Même nom = remplacement
- • Sans souci : Ancienne version supprimée automatiquement
💡 Conseil : Préparez les documents à l'avance en format texte brut. Les images et la mise en forme complexe peuvent détériorer la qualité des réponses du chatbot.
🎯 Recherche sémantique
🔍 Comment le chatbot trouve les réponses
- • Correspondance sémantique : Recherche de sens similaire, pas de texte exact
- • Mots-clés : Identifie les termes importants dans la requête
- • Contexte : Tient compte du sens de toute la phrase
- • Similarité : Compare avec les informations existantes
✍️ Formulation optimale
- • Réponses directes : "X a Y ans" au lieu de "X a célébré Y ans"
- • Diverses formulations : Utiliser différentes façons d'exprimer
- • Questions attendues : Penser aux requêtes possibles des utilisateurs
- • Mots-clés : Inclure synonymes et variantes
❌ Moins adapté :
"Big Ben a célébré son 165e anniversaire"
✅ Mieux :
"Big Ben a 165 ans"
Pourquoi :La deuxième version répond mieux aux questions comme "Quel âge a Big Ben ?" ou "Quel est l'âge de Big Ben ?"
📊 Optimisation basée sur l'analytique
🔍 Analyse des lacunes
- • Requêtes sans réponse : Suivre les questions fréquentes sans réponses
- • Faible fiabilité : Identifier les requêtes à faible confiance
- • Problèmes récurrents : Trouver des schémas dans les requêtes infructueuses
- • Frustrations utilisateurs : Observer les points où les utilisateurs bloquent
🎯 Améliorations ciblées
- • Extension des documents : Ajouter les informations manquantes
- • Reformulation : Clarifier les passages ambigus
- • Nouvelles formulations : Ajouter différentes façons d'exprimer
- • Tester et itérer : Tester les changements et mesurer les améliorations
💯 Interprétation de la fiabilité
< 30%
Réponse infructueuse
30-40%
Réponse partielle
> 40%
Réponse réussie
💡 Conseil : Testez vos modifications directement dans le chatbot. Posez les mêmes questions à nouveau et observez les changements de fiabilité. L'objectif est d'atteindre constamment plus de 40% de fiabilité.
Pourquoi des valeurs si basses ? Pour 100% de fiabilité, la requête devrait être identifiée exactement avec le même libellé dans le document, ce qui est très rare. Les valeurs réalistes dans un environnement français sont donc plus basses.
❓ Optimisation FAQ
📈 Analyse des requêtes les plus fréquentes
- • Suivre les tendances : Identifier les questions récurrentes
- • Priorisation : Se concentrer sur les requêtes les plus fréquentes
- • Schémas : Chercher des formulations similaires de la même question
- • Problèmes : Trouver les requêtes à faible fiabilité
📝 Création de document FAQ
- • Un paragraphe = Q&R : Question et réponse ensemble
- • Langage naturel : Utiliser des formulations courantes
- • Réponses complètes : Toutes les informations nécessaires en une fois
- • Variantes diverses : Inclure synonymes et alternatives
✨ Exemple de FAQ optimisée
Combien de temps prend le traitement d'une demande de passeport ?Le traitement d'une demande de passeport prend normalement 6 à 8 semaines à partir du dépôt d'un dossier complet. Pour les voyages urgents, un traitement accéléré est disponible en 2 à 3 semaines moyennant des frais supplémentaires. Vous pouvez récupérer votre passeport en personne au centre de demande ou le faire envoyer à votre adresse.
🚀 Résultat : Un document FAQ augmente considérablement la fiabilité des réponses aux requêtes les plus fréquentes. Vous satisferez 80 à 90% des questions des utilisateurs avec une grande précision.
📊 Analyse à long terme
🔍 Surveillance régulière
- • Vérification hebdomadaire : Suivre les réponses infructueuses
- • Bilan mensuel : Analyser les tendances et les changements
- • Réponses partielles : Identifier les domaines à améliorer
- • Schémas de problèmes : Trouver les lacunes récurrentes
📤 Export analytiqueElite+
- • Format CSV : Pour MS Excel et Numbers
- • Données détaillées : Toutes les requêtes et réponses
- • Fiabilité : Niveau de confiance pour chaque requête
- • Horodatage : Suivi des tendances dans le temps
📈 Workflow recommandé
1. Export hebdomadaire
Télécharger les données de la semaine passée
2. Analyse Excel
Filtrer par fiabilité < 40%
3. Mises à jour
Modifier les documents selon les insights
💡 Pour les utilisateurs avancés : Utilisez des tableaux croisés dynamiques Excel pour regrouper les requêtes similaires et identifier les zones problématiques les plus courantes.
🌐 Utiliser des sources web
🔗 Scraping d'URL webElite+
- • Import direct : Charger le contenu des sites web
- • Sections FAQ : Idéal pour les Foires Aux Questions existantes
- • Documentation : Utiliser la documentation existante prête à l'emploi
- • Contenu actuel : Toujours la dernière version des informations
✅ Avantages du scraping web
- • Gain de temps : Pas de réécriture manuelle
- • Cohérence des données : Pas de différences entre le site web et le chatbot
- • Mises à jour automatiques : Il suffit de recharger l'URL
- • Contenu structuré : La mise en forme est préservée
📋 Sources idéales pour le scraping
✅ Pages adaptées :
- • Sections FAQ
- • Documentation produit
- • Guides et procédures
- • Informations de contact
❌ Moins adaptées :
- • Pages avec beaucoup d'images
- • Menus de navigation
- • Contenu publicitaire
- • Contenu généré par JavaScript
💡 Conseil : Si vous avez une FAQ ou une documentation de qualité sur votre site web, utilisez le scraping d'URL plutôt que la réécriture manuelle. Cela évite les incohérences et fait gagner du temps lors des mises à jour.
💡 Conseils pour tirer le maximum de valeur
Obtenez de meilleures réponses de votre chatbot et tirez le meilleur parti de votre quota mensuel de messages avec ces conseils :
📄 Qualité des documents :
- • Supprimez le contenu inutile avant l'upload — documents plus propres = réponses plus précises
- • Utilisez des documents bien structurés avec des titres et sections clairs
- • Évitez les informations dupliquées entre les documents
❓ Encourager de bonnes questions :
- • Les questions spécifiques et ciblées obtiennent de meilleures réponses que les questions vagues
- • Des documents bien préparés mènent à des réponses plus rapides et précises
📊 Surveiller votre utilisation :
- • Suivez votre quota de messages dans l'analytique du dashboard
- • Pour les pics de trafic saisonniers, utilisez des modules complémentaires de messages supplémentaires plutôt que de mettre à niveau votre forfait
- • Examinez les tendances mensuelles pour décider si votre forfait actuel correspond à vos besoins
Dépannage
⚠️ Problèmes courants
🤖 Le chatbot ne répond pas
Causes possibles :
- • Limite mensuelle de messages dépassée
- • Domaine bloqué par des restrictions
- • Limitation de débit activée
- • Erreur de chargement du widget
Solution :
- • Vérifier l'utilisation dans le dashboard
- • Vérifier les domaines autorisés
- • Outils développeur du navigateur → onglet Réseau
- • Contacter le support avec les détails de l'erreur
📄 Document non traité
Problèmes courants :
- • Fichier plus grand que la limite du forfait
- • Format non supporté
- • PDF corrompu ou protégé par mot de passe
- • Surcharge de la file de traitement
Diagnostics :
- • Vérifier la taille du fichier par rapport à la limite du forfait
- • Essayer de sélectionner du texte dans le PDF
- • Statut de traitement dans les documents
- • Réessayer l'upload si bloqué
🌐 Le widget ne se charge pas
Problèmes de chargement :
- • Blocage par la politique CORS
- • Délai de chargement du script
- • CSP (Content Security Policy)
- • Interférence d'un bloqueur de publicités
Étapes de résolution :
- • Messages d'erreur dans la console du navigateur
- • Essayer un autre navigateur/mode incognito
- • Désactiver temporairement les bloqueurs de publicités
- • Vérifier les paramètres des domaines autorisés
🆘 Contacter le support
📧 Support par e-mail
support@chatbotty.ai
- • Forfaits prioritaires : dans les 24h (exceptionnellement jusqu'à 48h)
- • Forfaits gratuits : généralement dans les 72h
- • Pièces jointes : captures d'écran, logs bienvenus
🔍 Informations à inclure
- • Type et version du navigateur
- • Message d'erreur ou capture d'écran
- • ID du chatbot et URL du widget
- • Étapes de reproduction
- • Erreurs de console (F12)