Stella Chatbot Plugin Documentation
Stella Chatbot est une extension de chatbot basée sur des mots-clés pour WordPress qui répond automatiquement aux questions des visiteurs en utilisant votre propre base de connaissances Q&R — aucun service tiers n'est requis pour l'expérience de base. Ce guide couvre à la fois l'extension gratuite et l'extension autonome Pro, avec des explications détaillées au niveau des champs et du comportement des fonctionnalités. 1) Installation Version Gratuite Vous pouvez installer l'extension gratuite en utilisant l'une des deux méthodes ci-dessous : Méthode 1 : Installation depuis le répertoire des extensions WordPress Dans l'administration WordPress, allez dans Extensions > Ajouter. Recherchez Stella Chatbot. Cliquez sur Installer maintenant puis sur Activer. OU Méthode 2 : Téléchargement manuel du fichier ZIP Allez dans Extensions > Ajouter > Téléverser une extension. Téléversez votre fichier ZIP Stella Chatbot. Cliquez sur Installer maintenant puis sur Activer. Après l'activation Un élément de menu Stella Chatbot apparaîtra dans la barre latérale de votre administration WordPress. Allez dans Stella Chatbot > Settings (Réglages) pour configurer le chatbot. Allez dans Stella Chatbot > Q&A (Q&R) pour ajouter vos premières réponses déclenchées par mots-clés. Version Pro (Autonome) Allez dans Extensions > Ajouter > Téléverser une extension. Téléversez votre fichier ZIP Stella Chatbot Pro. Cliquez sur Installer maintenant puis sur Activer. La version Pro fonctionne comme une extension autonome. Vous n'avez pas besoin d'installer la version gratuite à ses côtés — installez une seule version à la fois. 2) Démarrage rapide Démarrage rapide (Gratuit) Allez dans Stella Chatbot > Settings. Entrez un Chatbot Name (ex: "Stella"). Téléversez une Avatar Image pour le bouton de lancement du chat. Cochez Display chatbot on frontend pour le rendre visible aux visiteurs. Définissez un Welcome Message affiché lorsque les utilisateurs ouvrent le chat. Allez dans Stella Chatbot > Q&A et ajoutez votre première réponse déclenchée par mot-clé. Cliquez sur Save Changes (Enregistrer les modifications). Votre chatbot est maintenant en ligne. Démarrage rapide (Pro) Allez dans Stella Chatbot Pro > Settings. Configurez les paramètres General, Branding, Chat Experience et Appearance. Activez éventuellement l'AI Fallback (Solution de secours IA) et entrez votre clé API. Allez dans Stella Chatbot Pro > Q&A et ajoutez des entrées ou importez-les depuis un fichier. Activez le Lead Capture (Capture de prospects) et le Human Handoff (Relais humain) selon vos besoins. Enregistrez et vérifiez le chatbot sur votre site. 3) Fonctionnalités de l'extension gratuite (Détails) Q&R basées sur des mots-clés : Créez une base de connaissances allant jusqu'à 49 entrées Q&R. Lorsqu'un message de visiteur correspond à un mot-clé, le chatbot renvoie automatiquement la réponse configurée. Nom du chatbot : Définissez un nom personnalisé affiché dans l'en-tête du chat (ex: "Stella", "Robot d'assistance"). Image de l'avatar : Téléversez une image personnalisée pour le bouton de lancement et l'en-tête. Supporte les formes ronde, carrée et arrondie. Visibilité du widget : Activez ou désactivez le chatbot sur le site sans désactiver l'extension. Message de bienvenue : Configurez une salutation affichée lorsque les visiteurs ouvrent le panneau de chat. Navigation par catégorie : Organisez les entrées Q&R en catégories. Affichez des boutons de suggestion de catégories sur l'écran de bienvenue et, optionnellement, un lien "Retour aux catégories" après chaque réponse du robot. Réponse en cas de non-correspondance : Définissez un message de secours affiché lorsqu'aucun mot-clé ne correspond à la saisie de l'utilisateur. Suggestions IA : Affichez jusqu'à 3 suggestions de Q&R connexes sous la réponse de non-correspondance pour guider les visiteurs. Gestion des données : Option pour supprimer toutes les données du chatbot de la base de données lors de la désinstallation de l'extension. 4) Fonctionnalités de l'extension Pro (Détails) Entrées Q&R illimitées : Aucune limite sur le nombre d'entrées FAQ — construisez une base de connaissances aussi vaste que nécessaire. Importation de fichiers flexible : Importez en masse des entrées Q&R à partir de fichiers CSV, TXT ou DOCX. Supporte l'auto-détection des délimiteurs et plusieurs structures de fichiers. Solution de secours IA (AI Fallback) : Lorsqu'aucune correspondance FAQ n'est trouvée, interrogez automatiquement un fournisseur d'IA (OpenAI, Anthropic Claude, Google Gemini, Groq ou OpenRouter) pour générer une réponse. Testeur de modèle IA : Testez la configuration de votre fournisseur d'IA directement depuis la page des réglages avant la mise en ligne. Contrôle des jetons (Tokens) : Définissez la longueur maximale des réponses de l'IA (32–4096 jetons) pour équilibrer coût et qualité. Prompt système IA : Fournissez des instructions personnalisées à l'IA (ex: "Vous êtes un agent d'assistance pour Acme Corp. Ne répondez qu'aux questions concernant nos produits."). Avertissement IA : Affichez optionnellement un message d'avertissement sous les réponses générées par l'IA. Correspondance floue (Fuzzy Match) : Faites correspondre les messages des utilisateurs qui sont proches — mais pas identiques — à un mot-clé ou une question, réduisant ainsi les échecs dus aux fautes de frappe ou aux variations de formulation. Seuil configurable (35–95 %). Capture de prospects : Invitez les visiteurs à saisir leur nom et leur e-mail pendant le chat. Les prospects capturés sont stockés et exportables en CSV. Relais humain : Après un nombre configurable de réponses consécutives sans correspondance, proposez au visiteur un lien pour contacter un agent humain, avec affichage optionnel des horaires d'ouverture. Journaux de chat par session : Enregistrez chaque session de chat. Visualisez les transcriptions complètes des conversations et exportez les journaux en CSV. Tableau de bord analytique : Suivez le nombre total de conversations, de messages, les taux de correspondance FAQ, l'utilisation de l'IA et les mots-clés les plus déclenchés. Contrôles complets de l'apparence : Personnalisez la position du widget (bas-gauche ou bas-droite), le thème clair/sombre, l'animation du lanceur (Flottement, Pulsation, Aucune), la taille du bouton, la taille de l'avatar, la largeur/hauteur de la fenêtre de chat et sa couleur de fond. Contrôles de marque : Supprimez ou personnalisez le texte de crédit "Propulsé par" et le lien affiché en bas du chat. Rétention des données et nettoyage auto : Définissez le nombre de jours de conservation des journaux de chat et des prospects, avec un nettoyage quotidien automatique en option. 5) Guide des réglages champ par champ A) Configuration générale Nom du chatbot : Le nom affiché dans l'en-tête du chat. Visible par tous les visiteurs. Image Avatar / Bouton : Image utilisée à la fois pour le bouton de lancement et l'avatar de l'en-tête. Téléversez via la médiathèque WordPress. Forme de l'avatar : Ronde, Carrée ou Arrondie — contrôle le rayon de bordure de l'avatar. Visibilité du widget : Cochez pour afficher le widget du chatbot sur le site. Décochez pour le masquer sans perdre vos réglages. B) Expérience de chat Message de bienvenue : Le premier message affiché lorsqu'un visiteur ouvre le chat. Exemple : "Bonjour ! Comment puis-je vous aider aujourd'hui ?" Afficher le message de bienvenue : Activez ou désactivez l'affichage du message de bienvenue à l'ouverture du chat. Afficher les suggestions de bienvenue : Affichez des boutons de suggestion de catégories à côté du message de bienvenue. Gérer les catégories : Définissez vos catégories Q&R, une par ligne. Elles sont utilisées pour les suggestions de bienvenue et le lien de navigation "Retour aux catégories". Par défaut : Général, Ventes, Support. Catégories de bienvenue : Sélectionnez jusqu'à 3 catégories à mettre en avant comme boutons d'accès rapide sur l'écran de bienvenue. Navigation (Retour aux catégories) : Affichez un lien "Retour aux catégories" sous chaque réponse du robot, permettant aux utilisateurs de revenir au menu des catégories. Réponse sans correspondance : Le message affiché lorsqu'aucun mot-clé n'est trouvé. Exemple : "Je ne comprends pas votre question. Essayez l'une des suggestions ci-dessous." Suggestions IA : Affichez jusqu'à 3 suggestions de Q&R connexes sous la réponse de non-correspondance. C) Image de marque et identité (Pro) Supprimer le crédit : Masquez le texte "Propulsé par Stella Chatbot" dans le pied de page du chat. Texte de crédit : Personnalisez le texte de crédit affiché lorsque celui-ci est activé. Lien de crédit : Définissez une URL personnalisée pour le lien de crédit. D) Automatisation avancée (Pro) Capture de prospects : Activez cette option pour demander aux visiteurs leur nom et leur e-mail pendant la conversation. Invite de capture de prospects : Le message affiché aux visiteurs pour demander leurs coordonnées. Exemple : "Avant de continuer, pourriez-vous partager votre nom et votre e-mail ?" Correspondance floue (Fuzzy Match) : Activez cette option pour faire correspondre les messages des utilisateurs qui sont proches d'un mot-clé ou d'une question. Seuil de correspondance floue (%) : Sensibilité de la correspondance (35–95 %). Plus élevé = plus strict. Par défaut : 62 %. Relais humain : Activez cette option pour proposer un lien d'assistance après plusieurs réponses sans correspondance. Compteur de non-correspondance : Nombre de messages consécutifs sans correspondance avant de déclencher l'invite de relais. Message de relais : Le message affiché lors de la proposition de mise en relation avec un agent humain. URL d'assistance : L'URL vers laquelle les visiteurs sont dirigés pour un support humain (ex: page de contact ou lien de chat en direct). Heures d'ouverture : Affichez vos horaires d'ouverture à côté du message de relais. Exemple : 09:00–18:00 Lun–Ven. E) Apparence et Widget (Pro) Position du widget : Placez le lanceur de chat en Bas à Droite ou en Bas à Gauche de l'écran. Thème : Mode Clair ou Sombre pour la fenêtre de chat. Animation : Animation du bouton de lancement — Flottement, Pulsation ou Aucune. Taille du bouton (px) : Largeur et hauteur du bouton de lancement (44–88px). Par défaut : 56px. Taille de l'avatar (px) : Taille de l'avatar à l'intérieur de l'en-tête du chat (24–80px). Par défaut : 36px. Largeur de la boîte de chat (px) : Largeur de la fenêtre de chat (280–520px). Par défaut : 350px. Hauteur de la boîte de chat (px) : Hauteur de la fenêtre de chat (220–600px). Par défaut : 480px. Couleur de la boîte de chat : Couleur d'arrière-plan de la fenêtre de chat, sélectionnée via un sélecteur de couleurs. F) Intelligence IA (Pro) Solution de secours IA : Activez les réponses par IA lorsqu'aucune correspondance de mot-clé FAQ n'est trouvée. Fournisseur d'IA : Choisissez parmi OpenAI, Anthropic (Claude), Google Gemini, Groq ou OpenRouter. Clé API : Votre clé API pour le fournisseur sélectionné. Stockée de manière sécurisée (chiffrée dans la base de données). Modèle : Sélectionnez le modèle d'IA à utiliser. Les modèles sont récupérés dynamiquement auprès du fournisseur. Vous pouvez également saisir un identifiant de modèle manuellement. Jetons de sortie max : Longueur maximale des réponses IA (32–4096). Plus bas = plus rapide et moins cher. Recommandé : 128–512 pour le support par chat. Prompt système : Instructions personnalisées pour l'IA définissant son rôle, son ton et l'étendue de ses connaissances. Avertissement IA : Activez pour afficher un message d'avertissement sous les réponses générées par l'IA. Exemple : "Cette réponse a été générée par une IA et peut ne pas être exacte à 100 %." Testeur de modèle IA : Envoyez un message de test à votre fournisseur d'IA configuré directement depuis la page des réglages pour vérifier la connexion. G) Gestion des données Supprimer les données à la désinstallation : Si activé, toutes les données du chatbot (Q&R, journaux, prospects) sont définitivement supprimées de la base de données lors de la désinstallation. Désactivé par défaut. Rétention des données (Pro) : Définissez le nombre de jours de conservation des journaux et des prospects (minimum 7 jours). Par défaut : 180 jours. Nettoyage automatique (Pro) : Supprimez automatiquement les anciens journaux et prospects quotidiennement selon la période de rétention. 6) Gestion des entrées Q&R Ajouter une entrée Q&R Naviguez vers Stella Chatbot > Q&A et remplissez les champs suivants : Catégorie : Optionnel. Groupez cette entrée sous une catégorie (ex: "Commandes", "Retours"). Utilisé pour la navigation et les suggestions de bienvenue. Mot-clé unique : Le mot ou la phrase de déclenchement. Lorsqu'un message de visiteur contient ce mot-clé, la réponse est renvoyée. Doit être unique parmi toutes les entrées. Question : La question complète à laquelle cette entrée répond (pour référence et affichage). Réponse : La réponse que le chatbot envoie. Supporte le HTML de base (liens, gras, listes). Cliquez sur Save FAQ pour ajouter l'entrée, ou Update FAQ lors de la modification d'une entrée existante. Modification et suppression Cliquez sur Edit à côté d'une entrée pour la modifier. Le formulaire passe en mode édition. Cliquez sur Delete pour supprimer définitivement une entrée (confirmation requise). Cliquez sur Cancel pendant l'édition pour revenir au formulaire d'ajout sans enregistrer. Importation de fichiers (Pro) Importez en masse des entrées Q&R à partir de fichiers externes pour gagner du temps lors de la migration ou de la mise en place d'une grande base de connaissances. Formats supportés : CSV (séparé par virgule, point-virgule ou tabulation), TXT (texte brut avec blocs Q&R ou paires clé-valeur), DOCX (Microsoft Word). Naviguez vers Stella Chatbot Pro > Q&A, faites défiler jusqu'à la section Import Q&A, téléversez votre fichier et cliquez sur Import. Exemple de format CSV : keyword,question,answer,category
remboursement,Comment obtenir un remboursement ?,Vous pouvez demander un remboursement sous 30 jours.,Commandes
livraison,Combien de temps prend la livraison ?,La livraison standard prend 3 à 5 jours ouvrables.,Livraison7) Journaux de chat (Pro) Naviguez vers Stella Chatbot Pro > Chat Logs pour voir toutes les sessions de chat enregistrées. Cliquez sur View Chat pour lire la transcription complète de n'importe quelle session. Cliquez sur Export CSV pour télécharger tous les journaux dans un tableur pour une analyse hors ligne. Les journaux sont automatiquement nettoyés selon votre réglage de Rétention des données. 8) Capture de prospects et Leads (Pro) Activez le Lead Capture dans Settings > Advanced Automation et définissez un message d'invite. Naviguez vers Stella Chatbot Pro > Leads pour voir tous les prospects capturés avec nom, e-mail et horodatage. Cliquez sur Export CSV pour télécharger les prospects afin de les utiliser dans votre CRM ou outil d'e-mailing. Les prospects sont automatiquement nettoyés selon votre réglage de Rétention des données. 9) Analytique (Pro) Naviguez vers Stella Chatbot Pro > Analytics pour un aperçu des performances : Nombre total de conversations et de messages. Taux de correspondance FAQ vs taux de non-correspondance. Fréquence d'utilisation de la solution de secours IA. Mots-clés les plus fréquemment déclenchés. Données de conversion de la capture de prospects. 10) Dépannage Le chatbot n'est pas visible sur le site Confirmez que Display chatbot on frontend est coché dans les réglages. Videz votre cache WordPress, le cache des extensions, le cache CDN et le cache du navigateur. Vérifiez les erreurs JavaScript dans la console du navigateur qui pourraient empêcher le chargement du widget. Le mot-clé ne déclenche pas de réponse Vérifiez que le mot-clé est orthographié exactement comme il a été saisi dans l'entrée Q&R. Assurez-vous que le mot-clé est unique — les mots-clés en double sont rejetés. Activez le Fuzzy Match (Pro) pour gérer les fautes de frappe et les variations de formulation. L'IA ne répond pas (Pro) Vérifiez que votre clé API est correcte et dispose de suffisamment de crédits/quota. Utilisez le AI Model Tester dans les réglages pour tester la connexion. Assurez-vous que l'AI Fallback est activé dans Settings > AI Intelligence. Vérifiez que le modèle sélectionné est disponible pour votre niveau de clé API. Les prospects ou journaux n'apparaissent pas (Pro) Confirmez que le Lead Capture est activé dans les réglages. Vérifiez le réglage de Data Retention — les anciens enregistrements ont peut-être été nettoyés automatiquement. Vérifiez que le chatbot reçoit un trafic réel de visiteurs (pas seulement des prévisualisations d'administrateur). 11) Données et désinstallation Les deux versions incluent une option Delete data on uninstall dans la section "Danger Zone" des réglages. Si activé : toutes les entrées Q&R, les journaux de chat et les prospects sont définitivement supprimés de la base de données lors de la désinstallation. Si désactivé (par défaut) : les données restent dans la base de données et sont restaurées si vous réinstallez l'extension. 12) Flux de travail recommandé Définissez les questions les plus courantes que vos visiteurs posent. Créez des entrées Q&R avec des mots-clés clairs et concis et des réponses utiles. Organisez les entrées en catégories pour faciliter la navigation. Définissez un message de bienvenue amical et configurez les 3 catégories de bienvenue mises en avant. Activez l'AI Fallback (Pro) pour gérer les questions non couvertes par votre FAQ. Activez le Lead Capture (Pro) pour collecter les coordonnées des visiteurs. Surveillez les journaux de chat et les analytiques (Pro) pour identifier les lacunes et améliorer la couverture au fil du temps.