Premiers pas
Dans la prochaine version, les pages incluses sont partagées entre les projets d’un même propriétaire ; jusqu’au déploiement, le tableau de bord public peut encore afficher les anciennes limites par chatbot.
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 New Chatbot et donnez un nom au projet. Le projet s’ouvre dans Content, où apparaîtront les pages indexées et les tâches d’exploration.
Consultez les tarifs pour connaître les limites actuelles de projets, de pages et d’utilisation.
2. Configurer la source de contenu
Ouvrez Settings, enregistrez l’URL publique avec Save Changes, puis choisissez le mode, le maximum de pages et la fréquence dans Scraping Configuration avec Save Config : ce sont deux formulaires. Les règles include/exclude et la profondeur de crawl sont disponibles par configuration comme code, pas dans le dashboard.
Lancez Scrape now. ChattyBox découvre les pages sélectionnées, extrait le HTML lisible et met les contenus modifiés en file pour indexation. Il ne rend pas JavaScript et n’applique pas robots.txt ; n’utilisez que des pages publiques autorisées.
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é
Retournez dans Content et comparez les pages obtenues avec celles attendues. Une exploration terminée ne garantit pas toutes les URL ni toutes les sections : vérifiez les avertissements d’indexation partielle et l’état distinct des embeddings avant de tester.
4. Tester la qualité des réponses
Ouvrez Test Chat 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 et relancez l’exploration quand le délai le permet (au plus hebdomadaire sur Free, quotidien sur les formules payantes). Test Chat consomme le quota de messages et alimente les mêmes logs, Analytics et lacunes que le chat public.
5. Personnaliser l’expérience
Utilisez Persona pour ajuster le comportement de l’assistant et la formulation du repli. Si vous prévoyez d’utiliser le widget hébergé, utilisez Embed pour prévisualiser son titre, son message d’accueil, ses couleurs, son icône, sa position et son comportement linguistique.
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. Par défaut, les clés publiques fonctionnent en production, dans les environnements de prévisualisation et de staging, ainsi que sur localhost. Pour un renforcement facultatif en profondeur, ouvrez Public Keys > Edit origins, activez Restrict this key to specific origins et ajoutez chaque origine de navigateur autorisée. Les origines restreintes sont comparées exactement selon le schéma, le nom d’hôte et le port (par exemple, https://example.com et http://localhost:3000 sont des origines différentes). Revenez dans Embed pour sélectionner la clé et copier l’extrait généré ainsi que l’URL de l’API.
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.
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 Logs sur toutes les formules ou Analytics et Content Gaps sur Pro/Business.
Carte du dashboard
Un projet est ouvert à /chatbot/<projectId> : Content, Test Chat, Logs, Analytics (30 jours, maximum 5 000 interactions, Pro/Business), Content Gaps (Pro/Business), Persona, Public Keys, Embed et Settings sont des onglets. Account & Billing est /settings/account et contient profil, formule, usage des messages et réglages PAYG. Les messages, pages stockées, budget d’actualisation et délais sont des limites distinctes.
Le verrou config-as-code est irréversible : il bloque les écritures du dashboard et les opérations manuelles de contenu. Les clés publiques, le nettoyage de conversations et la préférence de branding autorisée par la formule restent séparés. Les portées des jetons ne créent pas des environnements isolés.