Introduction

Especialista en WP Chat est un plugin WordPress avancé qui offre un widget de chat intelligent alimenté par l’IA. Il utilise l’API Google Gemini pour générer des réponses naturelles et contextuellement pertinentes, tout en gérant automatiquement le flux de conversation et la capture de prospects potentiels.

Le plugin est conçu pour améliorer l’expérience utilisateur sur votre site web, en fournissant une assistance immédiate et en capturant des informations de contact précieuses de manière organique pendant les conversations.

Fonctionnalités principales :

• Widget de chat IA propulsé par Google Gemini
• Gestion automatique des états de conversation
• Capture intelligente de prospects
• Support multilingue complet
• Système de protection anti-spam et bannissements
• Tableau de bord d’administration complet
• Hooks extensibles pour les développeurs

Installation et Configuration

Installation du Plugin

1. Téléchargez le fichier .zip du plugin Especialista en WP Chat.

2. Dans votre tableau de bord d’administration WordPress, allez dans Extensions > Ajouter une nouvelle.

3. Cliquez sur le bouton Téléverser une extension en haut de la page.

4. Sélectionnez le fichier .zip que vous avez téléchargé et cliquez sur Installer maintenant.

5. Une fois installé, cliquez sur Activer l’extension.

Configuration Initiale

Après avoir activé le plugin, un nouveau menu “Experto en WP Chat” apparaîtra dans votre tableau de bord d’administration.

1. Allez dans Experto en WP Chat > Réglages.

2. Remplissez les champs de base :

• Nom de l’entreprise : Le nom de votre entreprise ou site web
• Nom de l’agent : Comment le bot s’identifiera (ex. “Assistant Virtuel”)
• Informations de Base : Informations sur votre entreprise, services et produits que l’IA utilisera pour répondre

Configuration de l’API Google Gemini

Pour que le chat fonctionne avec l’IA, vous devez configurer votre clé API Google Gemini :

1. Obtenez votre clé API depuis Google AI Studio.

2. Dans Réglages, collez votre clé dans le champ “Clé API Google Gemini”.

3. Sélectionnez le modèle Gemini (par défaut : gemini-2.0-pro-exp-02-05).

4. Enregistrez les modifications. Le widget de chat apparaîtra automatiquement sur votre site web.

Widget de Chat

Fonctionnement du Chat

Le widget de chat apparaît comme un bouton flottant dans le coin inférieur droit de votre site web. Les visiteurs peuvent cliquer pour démarrer une conversation.

Fonctionnalités du widget :

• Design responsive compatible mobile et desktop
• Indicateurs de saisie en temps réel
• Persistance des conversations entre les pages
• Support pour RTL (langues de droite à gauche)
• Mode débogage optionnel pour le développement

États de Conversation

Le plugin gère automatiquement différents états pendant la conversation :

• Début : Salutation initiale et requêtes générales
• Information : Fournissant des informations sur les produits/services
• Capture de Prospect : Collecte des données de contact de l’utilisateur
• Fin : Fin de la conversation

L’IA décide automatiquement quand passer d’un état à l’autre en fonction du contexte de la conversation.

Capture de Prospects

Lorsque l’IA détecte un intérêt commercial, elle activera automatiquement le mode de capture de prospects :

1. Il demandera naturellement le nom et l’e-mail de l’utilisateur.

2. Il peut éventuellement demander le numéro de téléphone.

3. Les données sont automatiquement enregistrées dans la base de données.

4. Des notifications configurables sont envoyées aux administrateurs.

Les utilisateurs peuvent “échapper” au mode de capture de prospects s’ils ont encore des doutes, en revenant au flux d’informations.

Tableau de Bord d’Administration

Tableau de Bord des Prospects

Gérez tous les prospects capturés depuis Experto en WP Chat > Prospects :

• Liste des prospects : Visualisez tous les contacts capturés
• États : Nouveau, Contacté, Fermé
• Actions groupées : Changez le statut de plusieurs prospects
• Historique de conversation : Visualisez la conversation complète qui a mené au prospect
• Exportation : Possibilité d’exporter des données pour des CRM externes

Chaque prospect inclut des informations détaillées telles que le nom, l’e-mail, le téléphone (facultatif), et le journal complet de la conversation.

Gestion des Bannissements

Le plugin inclut une protection automatique contre le spam et les comportements abusifs :

1. Allez dans Experto en WP Chat > Bannissements pour gérer les adresses IP bannies.

2. Les bannissements sont appliqués automatiquement lorsque du contenu inapproprié est détecté.

3. Vous pouvez débannir les adresses IP manuellement ou nettoyer le stockage local.

4. Les bannissements sont temporaires et sont automatiquement levés après la période définie.

Configurations Avancées

Options supplémentaires disponibles dans le panneau de configuration :

• Mode de débogage : Affiche les informations techniques pour le développement
• Langue de l’IA : Code de langue pour les réponses de l’IA
• Modèle Gemini : Sélection du modèle d’IA à utiliser
• Configuration des Sessions : Durée de vie des sessions de chat

Support Multilingue

Langues Disponibles

Le plugin inclut un support complet pour plusieurs langues :

• Espagnol (es_ES) : Langue par défaut
• Anglais (en_US) : Support complet
• Autres langues : Facilement extensible

Configuration de la Langue

1. Dans Réglages, sélectionnez la langue par défaut de l’interface.

2. Configurez la “Langue par défaut de l’IA” pour les réponses de l’intelligence artificielle.

3. L’IA peut détecter automatiquement la langue de l’utilisateur et adapter ses réponses.

4. Les textes de l’interface s’adaptent automatiquement à la langue sélectionnée.

Personnalisation et Hooks

Hooks pour Développeurs

Le plugin fournit plusieurs hooks pour étendre ses fonctionnalités :

Hooks d’action :

• especialista_wp_chat_lead_captured – S’exécute lorsqu’un prospect est capturé
• especialista_wp_chat_conversation_started – Au démarrage d’une conversation
• especialista_wp_chat_message_processed – Après le traitement d’un message

Intégrations avec des CRM

Exemple d’intégration avec un CRM externe :

add_action('especialista_wp_chat_lead_captured', 'enviar_lead_a_crm', 10, 3);function enviar_lead_a_crm($lead_id, $lead_data, $conversation_history) {    // Votre code d'intégration CRM ici    // $lead_data contient : nom, e-mail, téléphone, etc.    // $conversation_history contient l'historique complet}

Dépannage

Le chat n’apparaît pas sur le site :

• Vérifiez que la clé API Gemini est correctement configurée
• Assurez-vous que l’extension est activée
• Vérifiez la console du navigateur pour les erreurs JavaScript

L’IA ne répond pas ou donne des erreurs :

• Vérifiez votre clé API dans Google AI Studio
• Vérifiez que le modèle Gemini sélectionné est disponible
• Activez le mode de débogage pour voir les erreurs détaillées

Les prospects ne sont pas enregistrés :

• Vérifiez que la table de la base de données a été correctement créée
• Vérifiez les permissions de la base de données
• Vérifiez les journaux PHP pour les erreurs

Problèmes de performance :

• Le plugin utilise des transients pour optimiser les performances
• Les bannissements et sessions sont nettoyés automatiquement
• Envisagez d’utiliser la mise en cache d’objets pour les sites à fort trafic

Pour un support additionnel : Contactez EspecialistaEnWP.com