Guide Joomla v1.3.0

Composant Joomla de chat conversationnel : scénarios, relais opérateur OUI Chat, analytics agrégés et conservation RGPD maîtrisée. Joomla 4.4 à 6.

Présentation

Composant Joomla de chat conversationnel : scénarios, relais opérateur OUI Chat, analytics agrégés et conservation RGPD maîtrisée. Joomla 4.4 à 6.

Prérequis

  • Joomla 4.4, 5 ou 6 selon la version du paquet.
  • PHP >=8.1.
  • Une sauvegarde récente avant toute installation ou mise à jour.

Installation

  1. Téléchargez le paquet ZIP sans le décompresser.
  2. Dans Joomla, ouvrez Système → Installation → Extensions.
  3. Déposez le fichier ZIP dans la zone d’installation, puis attendez le message de confirmation.
  4. Ouvrez le composant depuis le menu Composants. Si le paquet contient un plugin, vérifiez son état dans Système → Gestion → Plugins.
  5. Contrôlez les autorisations du composant avant de l’ouvrir aux équipes.

Configuration initiale

  1. Ouvrez le tableau de bord de l’extension.
  2. Accédez aux Options pour définir les réglages globaux.
  3. Attribuez les droits Créer, Modifier, Supprimer et Administrer aux groupes concernés.
  4. Créez un premier élément de test et vérifiez son affichage côté site lorsqu’une vue publique est fournie.
  5. Activez les tâches planifiées ou plugins du paquet uniquement lorsqu’ils sont nécessaires.

Fonctionnalités

Éditeur de scénarios

Construisez visuellement des flux question/réponse. Chaque réponse déclenche l'une des 6 actions disponibles : question suivante, sous-questions, saisie libre, redirection, fin de scénario ou fermeture du chat.

5 types de déclencheurs

Chaque scénario enregistre son mode de déclenchement. Le widget livré s'ouvre au clic sur le bouton flottant ou automatiquement après un délai réglable de 0 à 60 secondes.

Opérateur en direct

Transférez une conversation vers un conseiller humain via OUI Chat. Les réponses de l'opérateur reviennent dans Joomla par webhook et sont enregistrées avec l'émetteur operator, aux côtés de user et bot.

Cycle de vie des conversations

Chaque échange reçoit un UUID unique et passe par trois états : en cours, terminée ou abandonnée. Le nombre de messages et le taux de complétion sont recalculés à chaque tour de parole.

Analytics agrégés

Une commande CLI consolide chaque journée en 6 familles de métriques : messages par émetteur, conversations totales, conversations terminées, taux de complétion moyen, temps de réponse moyen et répartition par statut.

Secrets chiffrés au repos

Clé d'API, secret d'API et secret de webhook sont chiffrés en AES-256-GCM avec une clé dérivée du secret de votre site. Les valeurs chiffrées portent un préfixe dédié, ce qui rend la migration transparente.

Webhook signé

Le point d'entrée qui reçoit les réponses opérateur vérifie une signature HMAC-SHA256 en comparaison à temps constant. Tant qu'aucun secret n'est configuré, toutes les requêtes sont refusées : aucun mode permissif.

ACL & restrictions d'affichage

7 actions ACL au niveau du composant, 5 de plus sur les scénarios. Côté site, excluez des groupes d'utilisateurs, masquez le widget pour les invités ou désactivez-le sur des composants entiers.

Premiers usages

  1. Commencez avec un cas simple et des données non sensibles.
  2. Validez le résultat avec l’équipe qui utilisera l’extension.
  3. Documentez les choix propres au site : rôles, automatisations, modèles et intégrations.
  4. Déployez progressivement, puis surveillez les journaux et retours utilisateurs.

Captures d’écran

Interface de Chatbox
Vue de l’interface d’administration de l’extension.
Installation de Chatbox
Écran standard d’installation d’une extension Joomla.

Dépannage

L’extension n’apparaît pas après installation
Vérifiez le message d’installation, l’état du composant et des plugins, puis videz le cache Joomla/WordPress.
Une action est refusée
Contrôlez les droits du groupe utilisateur, le jeton de session et les éventuelles restrictions de sécurité.
Le rendu ne correspond pas au site
Testez avec le cache désactivé, inspectez les substitutions de template et recherchez un conflit CSS ou JavaScript.
Une intégration externe échoue
Vérifiez l’URL, les identifiants, les quotas et les journaux sans copier de secret dans une demande d’assistance.

Mise à jour et désinstallation

Avant une mise à jour, sauvegardez les fichiers et la base de données, lisez les changements de version, puis testez sur une copie du site. Pour désinstaller, exportez d’abord les données utiles. La suppression d’un paquet peut retirer plusieurs composants, modules ou plugins associés.