Premiers pas
Les quotas documentés de pages incluses sont partagés entre les projets d’un même propriétaire. Consultez les tarifs pour les quotas des formules et Compte et facturation dans le tableau de bord pour l’utilisation actuelle et le quota disponible de votre compte.
Construisez un chatbot utile avant de l’ajouter à votre site. Le parcours essentiel est créer → ajouter du contenu → examiner → tester → personnaliser → intégrer.
1. Créer un compte et un projet
Connectez-vous au tableau de bord ChattyBox, sélectionnez Nouveau chatbot et donnez un nom au projet, avec une URL de site web facultative. Après sa création, l’espace de travail s’ouvre sur Base de connaissances → Importer et actualiser. Si vous ouvrez un projet sans onglet sélectionné, il s’ouvre sur Aperçu. La création seule ne lance pas d’import.
Consultez les tarifs pour connaître les limites actuelles de projets, de pages et d’utilisation.
2. Configurer la source de contenu
Dans Base de connaissances → Importer et actualiser, connectez le site public, examinez les pages détectées, ajustez la sélection recommandée ou personnalisée, puis lancez l’import ou l’actualisation des pages sélectionnées. Les paramètres de source sont enregistrés automatiquement : vérifiez leur état d’enregistrement et corrigez les erreurs de validation ou réessayez après un échec avant de continuer. Les paramètres de source avancés proposent aussi une action distincte Lancer le scraping, qui utilise le mode de découverte configuré. Les règles d’inclusion/d’exclusion et la profondeur d’exploration sont disponibles via la configuration comme code, pas dans le dashboard.
ChattyBox extrait le contenu HTML lisible et met les contenus modifiés en file pour indexation. La découverte et l’enregistrement automatique ne lancent pas l’import. Le service ne rend pas JavaScript et n’applique pas robots.txt ; n’indexez que des pages publiques que vous êtes autorisé à utiliser et sélectionnez soigneusement le périmètre de lancement. La durée dépend de la découverte, du nombre de pages et du travail d’indexation.
Consultez Ajouter et actualiser du contenu pour obtenir des conseils sur les sitemaps, les URL manuelles, l’exploration, le contenu multilingue ou la nouvelle exploration.
3. Examiner le contenu indexé
Ouvrez Base de connaissances → Pages et comparez les pages réellement importées avec les sources attendues. Consultez la tâche d’import pour vérifier les décomptes et les avertissements de contenu partiel, puis contrôlez séparément la tâche d’embeddings avant d’évaluer les réponses. Un import terminé ne garantit ni chaque page demandée ni chaque section. Consultez la progression et l’indexation partielle.
4. Tester la qualité des réponses
Ouvrez Tester le chatbot et posez des questions représentatives que vos visiteurs poseront réellement. Vérifiez que les réponses :
- utilisent la documentation indexée plutôt que des suppositions non étayées ;
- renvoient vers des pages sources utiles ;
- gèrent les informations manquantes avec le comportement de repli prévu ;
- fonctionnent pour les langues et la terminologie importantes.
Améliorez le contenu source ou la sélection lorsque les réponses sont faibles, puis actualisez quand le délai de la formule le permet : les actualisations gratuites sont au plus hebdomadaires et celles des formules payantes au plus quotidiennes. Tester le chatbot consomme le quota de messages du propriétaire et enregistre les conversations. Les interactions de test peuvent apparaître dans les analyses et, si elles sont détectées comme sans réponse, dans les lacunes de contenu ; la facturation et l’enregistrement d’une lacune dépendent du résultat. N’installez pas le chatbot simplement parce que le premier import est terminé.
5. Personnaliser l’expérience
Dans Personnaliser → Comportement, choisissez Assistant serviable, Commercial, Support technique, Bot sarcastique ou Persona personnalisée et modifiez les instructions. Les modifications sont enregistrées automatiquement ; vérifiez leur état avant de continuer. Modifier un préréglage le transforme en persona personnalisée. Ces instructions complètent les règles intégrées de grounding et de formatage ; le contenu récupéré est ajouté automatiquement, évitez donc de copier toute votre base de connaissances dans le prompt. Le texte de persona ne remplace pas le repli imposé en l’absence de contexte ou en cas de lacune. Le paramètre distinct assistant.fallbackMessage est disponible via la configuration comme code, pas dans un champ Persona. Après l’enregistrement, testez les questions prises en charge et le comportement de repli.
Si vous prévoyez d’utiliser le widget hébergé, ouvrez Personnaliser → Apparence pour prévisualiser son titre, son message d’accueil, ses couleurs, son icône, sa position et son comportement linguistique. Les modifications sont enregistrées automatiquement ; vérifiez l’état avant de continuer. Le mode fixe et les remplacements par script influent sur la langue de l’interface du widget, pas sur la langue des pages indexées ; consultez le dépannage linguistique. Le titre et le message d’accueil que vous rédigez ne sont pas traduits automatiquement. Free inclut la personnalisation visuelle, mais conserve la marque ChattyBox ; Starter et les formules supérieures permettent de la masquer.
Ces choix interviennent après les tests de contenu afin que la configuration visuelle ne masque pas les problèmes de récupération ou de documentation.
6. Choisir une intégration
| Objectif | Étape suivante |
|---|---|
| Monter l’interface gérée de ChattyBox depuis le code de l’application | SDK JavaScript |
| Créer et maintenir votre propre interface | SDK JavaScript headless |
| Laisser un assistant de programmation IA intégrer le package npm | Intégration assistée par IA |
| Gérer la configuration du projet depuis Git et la CI | Déploiement de la configuration avec la CLI |
| Utiliser l’interface gérée sans npm ni étape de build | Script du widget hébergé |
| Ajouter le widget maintenu à WordPress sans modifier le thème | Plugin WordPress |
| Ajouter le widget maintenu à Drupal 10 ou 11 avec Composer | Module Drupal |
Les intégrations navigateur nécessitent une clé API publique du widget. Dans Installer → Clés et domaines, vérifiez les origines de la clé : une clé préparée pour un domaine de site web peut déjà être restreinte à cette origine, tandis qu’une clé créée sans restriction fonctionne sur plusieurs origines. Avec Modifier les origines, vous pouvez activer une restriction facultative ou ajouter les origines de production, de prévisualisation, de staging et de localhost nécessaires. Lorsqu’elles sont activées, les origines sont comparées exactement selon le schéma, le nom d’hôte et le port (ainsi https://example.com et http://localhost:3000 sont distincts). Dans Installation sur le site web, sélectionnez la clé et copiez le snippet généré et l’URL de l’API. Les restrictions d’origine sont un renforcement facultatif, pas une authentification.
Les clés publiques du widget sont destinées à apparaître dans le code du navigateur. Les jetons de déploiement de configuration et les autres identifiants de gestion sont privés et ne doivent jamais être ajoutés à un site web.
Pour retrouver le snippet d’une clé publique existante, saisissez une URL de site web HTTP(S) dans Installer → Installation sur le site web, puis sélectionnez la clé. Le sélecteur ne propose que les clés non expirées qui sont sans restriction ou autorisées pour l’origine de cette URL. Pour une clé restreinte, saisissez une origine autorisée ; utilisez Gérer les clés et les domaines autorisés pour examiner ses restrictions. Si le formulaire est indisponible, terminez d’abord l’étape de configuration indiquée dans le tableau de bord. Pour renouveler une clé, créez-en une nouvelle, mettez à jour votre installation et testez-la avant de supprimer l’ancienne. Sa suppression arrête immédiatement les installations qui l’utilisent encore. Une clé appartient à un seul chatbot ; la nommer « staging » ou « production » ne crée pas de séparation entre environnements.
7. Valider avant le lancement
Installez d’abord l’intégration choisie sur un site de prévisualisation ou de staging. Avant de publier largement, testez l’origine déployée, la navigation entre les routes, les citations, le comportement de repli, l’affichage mobile et la console du navigateur.
Suivez la checklist de lancement, puis utilisez Conversations → Historique sur toutes les formules. Conversations → Analyses et Conversations → Questions sans réponse sont disponibles sur Pro et Business ; consultez Analyses et lacunes de contenu.
Carte du dashboard
Un projet est ouvert à /chatbot/<projectId>. Les onglets utilisent le paramètre tab, et non des sous-pages distinctes :
| Vue de l’espace de travail | Valeur de tab | Utilisation |
|---|---|---|
| Aperçu | overview | Vérifier l’avancement de la configuration et l’activité récente |
| Base de connaissances → Importer et actualiser | settings | Découvrir, sélectionner, importer et actualiser des pages ; régler les paramètres de source |
| Base de connaissances → Pages | content | Vérifier les pages et les tâches d’import, supprimer du contenu, reconstruire les embeddings |
| Tester le chatbot | test | Poser des questions et retrouver les conversations enregistrées |
| Conversations → Historique | logs | Lire les conversations enregistrées et en supprimer une ou toutes |
| Conversations → Analyses | analytics | Examiner les interactions enregistrées des 30 derniers jours, dans la limite de 5 000 ; Pro/Business |
| Conversations → Questions sans réponse | gaps | Examiner et résoudre les questions détectées sans réponse ; Pro/Business |
| Personnaliser → Comportement | prompts | Choisir ou modifier les instructions de l’assistant |
| Personnaliser → Apparence | appearance | Prévisualiser et régler l’apparence et la langue du widget hébergé |
| Installer → Clés et domaines | keys | Créer/supprimer des clés publiques et modifier les restrictions d’origine facultatives |
| Installer → Installation sur le site web | embed | Préparer une installation et copier le snippet d’une clé |
| Paramètres du chatbot | manage | Gérer les détails du chatbot, les jetons de déploiement et le verrouillage de configuration, ou supprimer le chatbot |
Tous les chatbots renvoie à /dashboard. L’aperçu du compte est disponible à /dashboard/overview ; Compte et facturation se trouve à /settings/account et regroupe le profil, la formule, l’utilisation des messages, le portail de facturation et les options PAYG. /settings et /settings/billing y redirigent. /settings/keys permet de choisir un projet pour créer ou supprimer des clés publiques ; les restrictions d’origine facultatives se gèrent dans Installer → Clés et domaines du chatbot.
Autorisations et verrouillage de configuration
L’accès au projet dans le dashboard est réservé à son propriétaire (ou à l’utilisateur propriétaire d’un ancien espace de travail). Une clé publique de widget ne donne pas accès aux paramètres du projet ni à l’historique des conversations stockées ; l’appartenance à une organisation ne confère pas à elle seule ces autorisations.
Pour gérer le projet avec Git/CI, Paramètres du chatbot propose des jetons de déploiement de configuration avec des portées développement, prévisualisation et/ou production, une expiration facultative et la possibilité de les révoquer. La valeur complète d’un jeton n’est affichée qu’à sa création. La section présente également l’historique des déploiements.
Activer le verrouillage de la configuration est irréversible. Le verrou bloque les écritures de configuration du dashboard et les opérations manuelles sur le contenu, notamment l’enregistrement de Persona et Lancer le scraping, même si certaines commandes restent visibles. Déployez plutôt la configuration avec le workflow CLI. La gestion des clés publiques, le nettoyage des conversations et la préférence de branding autorisée par la formule restent distincts des champs verrouillés. Les portées d’environnement des jetons autorisent des déploiements ; elles ne créent ni chatbots distincts ni environnements de clés navigateur.
La configuration comme code expose également widget.enabled. Le définir sur false désactive le chat public, y compris le SDK headless, et pas seulement le widget flottant. Le formulaire Apparence actuel ne comporte pas de commande équivalente d’activation/désactivation.
Formules et budgets
| Formule | Chatbots | Pages par compte | Messages par mois |
|---|---|---|---|
| Free | 1 | 10 | 100 |
| Starter | 3 | 150 | 1 000 |
| Pro | 10 | 5 000 | 10 000 |
| Business | 25 | 25 000 | 50 000 |
Les messages et le quota de pages stockées incluses sont des allocations du propriétaire, partagées entre ses chatbots, y compris Tester le chatbot. Le travail mensuel d’actualisation des pages et les délais d’actualisation sont des limites distinctes ; consultez les budgets d’actualisation avant un import ou une reconstruction volumineuse. Consultez les tarifs pour les allocations partagées documentées et Compte et facturation pour l’usage actuel et le quota disponible de votre compte.
Le PAYG pour les messages, les pages et les sites est facultatif sur Pro/Business et désactivé par défaut. Dans Compte et facturation, définissez un plafond mensuel par fonctionnalité ou choisissez explicitement Aucun plafond de dépense. Un budget nul maintient un plafond strict ; l’absence de plafond autorise des frais d’utilisation sans limite. Le PAYG ne déverrouille pas les fonctionnalités de Free/Starter et ne contourne pas les délais d’actualisation du crawler. Le nom du profil se modifie dans cette section ; l’adresse e-mail se gère dans les paramètres du compte du fournisseur de connexion.