Helvira AI ChatBot - WordPress
Chatbot alimenté par l'IA avec capacités RAG pour WordPress
Introduction
Helvira AI ChatBot est un plugin WordPress puissant qui ajoute un chatbot intelligent alimenté par l'IA à votre site web. Le chatbot utilise la technologie RAG (Retrieval-Augmented Generation) pour répondre aux questions sur le contenu de votre site, vos produits et vos services.
Fonctionnalités clés
- 🤖 Réponses alimentées par l'IA - Utilise des modèles de langage avancés pour des conversations naturelles
- 📚 Technologie RAG - Indexe automatiquement votre contenu pour des réponses précises
- 🛒 Intégration WooCommerce - Assistant d'achat avec gestion du panier
- 🌍 Support multilingue - Détecte automatiquement et répond dans la langue de l'utilisateur
- 🎨 Design personnalisable - Adaptez à votre marque avec couleurs, dégradés et logos personnalisés
- 📱 Responsive mobile - Fonctionne parfaitement sur tous les appareils
- 💬 Historique des conversations - Maintient le contexte tout au long de la session de chat
Prérequis
| Exigence | Minimum | Recommandé |
|---|---|---|
| WordPress | 5.8+ | 6.0+ |
| PHP | 7.4+ | 8.0+ |
| MySQL | 5.7+ | 8.0+ |
| WooCommerce | 6.0+ (optionnel) | 8.0+ |
Exigences serveur
- Extension PHP
cURLactivée - Extension PHP
JSONactivée - Connexions HTTPS sortantes autorisées (pour les appels API)
Installation
Méthode 1 : Téléchargement via l'admin WordPress
- Téléchargez le fichier ZIP du plugin
- Allez dans Admin WordPress → Extensions → Ajouter
- Cliquez sur Téléverser une extension
- Sélectionnez le fichier ZIP et cliquez sur Installer maintenant
- Cliquez sur Activer l'extension
Méthode 2 : Installation manuelle (FTP)
- Extrayez le fichier ZIP du plugin
- Téléchargez le dossier
helviravers/wp-content/plugins/ - Allez dans Admin WordPress → Extensions
- Trouvez "Helvira AI Chat" et cliquez sur Activer
Configuration
Après l'activation, allez dans Admin WordPress → Helvira Chat pour configurer le plugin.
Paramètres généraux
Activer le chatbot
Basculez cette option pour afficher ou masquer le chatbot sur votre site.
- Activé : Le chatbot est visible pour tous les visiteurs
- Désactivé : Le chatbot est masqué (utile pour la maintenance)
Titre du chat
Le titre affiché dans l'en-tête du widget de chat.
Exemple : "Discutez avec nous", "Besoin d'aide ?", "Posez-moi une question"
Message de bienvenue
Le premier message affiché lorsqu'un visiteur ouvre le chat.
Bonnes pratiques :
- Restez amical et concis
- Mentionnez ce avec quoi le chatbot peut aider
- Considérez le ton de votre marque
Exemple :
Bonjour ! 👋 Je suis là pour vous aider à découvrir nos produits et services. Que souhaitez-vous savoir ?
Configuration API
Clé API
Votre clé API Helvira est nécessaire au fonctionnement du chatbot.
Comment obtenir une clé API :
- Allez sur chat.helvira.ai
- Créez un compte ou connectez-vous
- Naviguez vers Paramètres → Compte → Clés API → Afficher
- Copiez la clé et collez-la dans les paramètres du plugin
⚠️ Note de sécurité : Ne partagez jamais votre clé API publiquement. Le plugin la stocke de manière sécurisée dans votre base de données WordPress.
Modèle IA
Choisissez votre modèle selon votre abonnement :
| Nom du modèle |
|---|
| Gemmini Light (Gemma3) Standard |
| Gemmini (Gemma3) Premium |
| OSS (gpt-oss) Premium |
Paramètres d'apparence
Style de couleur
Choisissez entre deux modes de couleur :
Couleur unie
- Une seule couleur pour tous les éléments
- Look propre et professionnel
- Idéal pour les designs minimalistes
Dégradé
- Effet de dégradé à deux couleurs
- Apparence moderne et dynamique
- Direction personnalisable
Couleur primaire
La couleur principale utilisée pour :
- Le bouton de chat
- L'arrière-plan de l'en-tête
- Le bouton d'envoi
- Les bulles de messages utilisateur
Par défaut : #667eea (Bleu-violet)
Couleur secondaire (dégradé uniquement)
La deuxième couleur pour les effets de dégradé.
Par défaut : #764ba2 (Violet)
Direction du dégradé
Choisissez comment le dégradé s'écoule :
| Option | Direction |
|---|---|
| ↘️ Diagonal | Haut-gauche vers bas-droite (135deg) |
| → Horizontal | Gauche vers droite |
| ↓ Vertical | Haut vers bas |
| ↗️ Diagonal montant | Bas-gauche vers haut-droite (45deg) |
Position du widget
Où le bouton de chat apparaît sur votre site :
- Bas droite (recommandé) - Position standard, n'interfère pas avec le contenu
- Bas gauche - Position alternative pour les sites RTL ou par préférence
- Haut gauche
- Haut droite
Logo personnalisé
Téléchargez une image personnalisée pour le bouton de chat.
Spécifications :
- Format : PNG (avec transparence) ou JPG
- Taille : 40x40 pixels recommandé
- Poids du fichier : Moins de 100Ko pour les meilleures performances
Pour télécharger :
- Cliquez sur Télécharger
- Sélectionnez ou téléchargez une image
- Cliquez sur Utiliser cette image
Indexation du contenu
Le système RAG indexe le contenu de votre site pour que l'IA puisse répondre aux questions avec précision.
Types de publications à indexer
Sélectionnez quels types de contenu doivent être recherchables :
- ✅ Articles - Articles de blog, publications
- ✅ Pages - Pages statiques, à propos, contact
- ✅ Produits - Produits WooCommerce (si installé)
Recommandation : Activez tous les types de contenu publics pour une couverture complète.
Nombre maximum de chunks de contexte
Combien de chunks de contenu inclure dans le contexte IA (1-20).
| Paramètre | Compromis |
|---|---|
| 1-3 | Plus rapide, moins de contexte |
| 4-6 | Équilibré (recommandé) |
| 7-10 | Plus de contexte, plus lent |
| 11-20 | Contexte maximum, le plus lent |
Par défaut : 5 chunks
Taille des chunks (mots)
Nombre de mots par chunk de contenu (100-2000).
- Chunks plus petits (100-300) : Correspondance plus précise, moins de contexte par chunk
- Chunks plus grands (500-1000) : Plus de contexte, potentiellement moins précis
- Par défaut : 500 mots
Chevauchement des chunks (mots)
Chevauchement entre les chunks consécutifs pour la continuité (0-500).
- Pourquoi le chevauchement ? Assure que les informations importantes aux limites des chunks ne sont pas perdues
- Par défaut : 100 mots
Réindexation du contenu
Cliquez sur Réindexer tout le contenu pour reconstruire l'index du contenu. Faites-le après :
- L'ajout ou la mise à jour de contenu significatif
- La modification des types de publications indexés
- La modification des paramètres de taille/chevauchement des chunks
- La configuration initiale du plugin
ℹ️ La réindexation peut prendre plusieurs minutes pour les sites volumineux.
Intégration WooCommerce
Si WooCommerce est installé, des fonctionnalités supplémentaires deviennent disponibles.
Activer l'assistant d'achat
Lorsqu'il est activé, le chatbot peut :
- 🛒 Voir le contenu du panier - Voir quels articles sont dans le panier du client
- ➕ Ajouter des produits - Ajouter des articles au panier via le chat
- ➖ Supprimer des produits - Retirer des articles du panier
- 🎫 Appliquer des coupons - Appliquer des codes de réduction
- 📦 Informations produit - Fournir des détails sur les produits
- 💡 Recommandations - Suggérer des produits pertinents
Exemples de conversations
Ajout au panier :
Utilisateur : Ajoute ce produit à mon panier
Bot : ✓ "Nom du produit" ajouté à votre panier. Votre panier contient maintenant 2 articles.
Application de coupon :
Utilisateur : J'ai un code de réduction SAVE20
Bot : ✓ Coupon "SAVE20" appliqué ! Vous économisez 20% sur votre commande.
Questions sur les produits :
Utilisateur : Est-ce en stock ?
Bot : Oui ! Le "Nom du produit" est actuellement en stock avec 15 unités disponibles.
Le prix est de 49,99€. Voulez-vous que je l'ajoute à votre panier ?
Fonctionnalités
Support multilingue
Le chatbot détecte automatiquement et répond dans la langue de l'utilisateur.
Langues supportées pour le panier :
- 🇬🇧 English
- 🇫🇷 Français
- 🇩🇪 Deutsch
- 🇪🇸 Español
- 🇮🇹 Italiano
Comment ça fonctionne :
- L'utilisateur envoie un message dans sa langue
- L'IA détecte la langue
- La réponse est générée dans la même langue
Conscience du contexte de page
Le chatbot sait quelle page le visiteur consulte actuellement.
Exemple :
Utilisateur : Peux-tu résumer cette page ?
Bot : Vous consultez notre page "À propos". Cette page explique l'histoire
de notre entreprise, fondée en 2010, notre mission de fournir des produits
de qualité, et présente notre équipe de plus de 50 employés...
Historique des conversations
- L'historique du chat est conservé pendant la session
- L'IA se souvient du contexte des messages précédents
- Les utilisateurs peuvent effacer l'historique avec le bouton 🗑️
Citations des sources
Lorsqu'il répond à partir du contenu indexé, le chatbot peut afficher les sources :
Bot : Notre politique de retour permet les retours dans les 30 jours suivant l'achat...
Sources :
• Politique de retour
• FAQ - Livraison & Retours
Comment ça fonctionne
RAG (Retrieval-Augmented Generation)
┌─────────────────────────────────────────────────────────────┐
│ Message utilisateur │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ 1. Détection d'intention │
│ Déterminer s'il s'agit d'une question ou action panier │
└─────────────────────────────────────────────────────────────┘
│
┌───────────────┴───────────────┐
▼ ▼
┌─────────────────────────┐ ┌─────────────────────────┐
│ Question de chat │ │ Action panier │
└─────────────────────────┘ └─────────────────────────┘
│ │
▼ ▼
┌─────────────────────────┐ ┌─────────────────────────┐
│ 2. Recherche contenu │ │ 2. Exécuter l'action │
│ indexé (RAG) │ │ (Ajouter/Suppr/etc) │
└─────────────────────────┘ └─────────────────────────┘
│ │
▼ ▼
┌─────────────────────────┐ ┌─────────────────────────┐
│ 3. Construire contexte │ │ 3. Confirmer l'action │
│ + Info page │ │ + Mettre à jour │
└─────────────────────────┘ └─────────────────────────┘
│ │
▼ ▼
┌─────────────────────────────────────────────────────────────┐
│ 4. Réponse de l'IA │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ Afficher à l'utilisateur │
└─────────────────────────────────────────────────────────────┘
Processus d'indexation du contenu
- Extraction : Le contenu est extrait des articles, pages et produits
- Découpage : Le contenu est divisé en chunks gérables
- Stockage : Les chunks sont stockés dans la base de données avec métadonnées
- Récupération : Les chunks pertinents sont récupérés selon les requêtes utilisateur
Dépannage
Le chatbot n'apparaît pas
Causes possibles et solutions :
| Cause | Solution |
|---|---|
| Plugin désactivé | Activer dans Helvira Chat → Paramètres généraux |
| Erreur JavaScript | Vérifier la console du navigateur pour les erreurs |
| Conflit de thème | Tester avec le thème par défaut |
| Cache | Vider le cache du site et du navigateur |
Erreur "Clé API invalide"
- Vérifiez que la clé API est correcte (pas d'espaces supplémentaires)
- Vérifiez si la clé a expiré
- Assurez-vous que votre compte API est actif
- Testez la connexion dans les paramètres
Le chatbot donne des réponses incorrectes
- Réindexez le contenu - Cliquez sur "Réindexer tout le contenu"
- Vérifiez les types de publications indexés - Assurez-vous que le contenu pertinent est indexé
- Augmentez le nombre max de chunks - Permettez plus de contexte pour de meilleures réponses
- Revoyez la qualité du contenu - L'IA ne peut utiliser que ce qui est indexé
Réponses lentes
| Cause | Solution |
|---|---|
| Taille de chunk trop grande | Réduire la taille des chunks à 300-500 |
| Trop de chunks | Réduire le max de chunks à 3-5 |
| API lente | Vérifier le statut de l'API, essayer un autre modèle |
| Problèmes serveur | Vérifier les ressources du serveur |
Actions panier WooCommerce ne fonctionnent pas
- Assurez-vous que Activer l'assistant d'achat est ON
- Vérifiez que WooCommerce est actif et à jour
- Vérifiez que le produit existe et est en stock
- Videz les transients WooCommerce
L'historique du chat ne se sauvegarde pas
- L'historique est stocké dans le sessionStorage du navigateur
- S'efface à la fermeture de l'onglet (par conception)
- Le mode privé/incognito peut bloquer le stockage
FAQ
Questions générales
Q : Le chatbot est-il gratuit ? R : Le plugin est gratuit, mais nécessite une clé API de Helvira AI qui peut avoir des coûts associés selon l'utilisation.
Q : Fonctionne-t-il avec n'importe quel thème ? R : Oui, Helvira Chat est conçu pour fonctionner avec n'importe quel thème WordPress correctement codé.
Q : Puis-je l'utiliser sur plusieurs sites ? R : Vérifiez les termes de licence de votre clé API. Certains plans permettent plusieurs sites.
Q : Mes données sont-elles sécurisées ? R : Oui. Les conversations sont traitées via des connexions HTTPS sécurisées. Nous ne stockons pas les données de conversation sur nos serveurs.
Questions techniques
Q : Cela affecte-t-il la vitesse du site ? R : Le widget de chat se charge de manière asynchrone et a un impact minimal sur le temps de chargement (~50Ko).
Q : Puis-je personnaliser la personnalité de l'IA ? R : L'IA s'adapte au nom et à la description de votre site. Les prompts système personnalisés pourraient être disponibles dans les versions futures.
Q : Fonctionne-t-il avec les constructeurs de pages ? R : Oui, compatible avec Elementor, Divi, Beaver Builder et autres.
Q : Puis-je exclure certaines pages ? R : Pas actuellement. Cette fonctionnalité est prévue pour une future version.
Questions WooCommerce
Q : Le chatbot peut-il traiter les paiements ? R : Non, il peut guider les utilisateurs vers le paiement mais ne gère pas le traitement des paiements.
Q : Supporte-t-il les produits variables ? R : Oui, il peut ajouter des produits variables avec les variations sélectionnées.
Q : Peut-il accéder à l'historique des commandes ? R : Actuellement limité. Les fonctionnalités complètes d'historique des commandes sont prévues.
Changelog
Version 1.0.0 (Version initiale)
- ✅ Chatbot alimenté par l'IA avec RAG
- ✅ Indexation du contenu pour articles, pages, produits
- ✅ Intégration WooCommerce (actions panier)
- ✅ Support multilingue
- ✅ Apparence personnalisable (couleurs, dégradés, logo)
- ✅ Design responsive mobile
- ✅ Historique des conversations
- ✅ Conscience du contexte de page
- ✅ Interface d'administration moderne
Support
Documentation : docs.helvira.ai
Email de support : support@helvira.ai
Issues GitHub : github.com/helvira/chat-plugin/issues
Licence
Ce plugin est sous licence GPL v2 ou ultérieure.
Ce programme est un logiciel libre ; vous pouvez le redistribuer et/ou le modifier
selon les termes de la GNU General Public License telle que publiée par
la Free Software Foundation ; soit la version 2 de la Licence, soit
(à votre choix) toute version ultérieure.
Fait avec ❤️ par Helvira AI