WebBlocks Live Chat

Hébergez vous-même les conversations d'assistance entre les visiteurs du site et les opérateurs du CMS. Les visiteurs ouvrent un composant de discussion ; les opérateurs lisent et répondent dans Live Chat du panneau CMS. Aucun compte de discussion externe ni service WebSocket n'est nécessaire. Ce guide décrit Live Chat 0.7.1.

Utilisez PHP 8.4 ou ultérieur et WebBlocks CMS ^1.95.1, qui fournit l'environnement d'exécution WebBlocks UI requis. Téléchargez le ZIP compatible depuis la fiche Live Chat du catalogue. Installez-le dans Système → Extensions, activez-le et vérifiez la réussite de la configuration de la base de données. Une ancienne application hôte peut signaler un avertissement de santé de l'extension ; mettez-la à jour avant d'utiliser cette version.

Ouvrez Live Chat → Paramètres et sélectionnez le site. Les paramètres généraux contrôlent l'activation, la disponibilité en ligne/hors ligne, la position gauche/droite, l'e-mail obligatoire hors ligne et les notifications facultatives aux opérateurs. La disponibilité est sélectionnée manuellement ; elle ne détecte pas la présence d'un opérateur.

Les textes par langue disposent d'un formulaire distinct. Définissez titre, accueil, message hors ligne et libellé du bouton d'ouverture pour chaque langue active. Enregistrer les paramètres généraux préserve les textes ; enregistrer les textes préserve les paramètres généraux. Les textes manquants utilisent d'abord la langue par défaut, puis les anciens textes conservés.

Le composant activé s'ouvre uniquement au clic sur son bouton. Le visiteur fournit un nom et éventuellement une adresse e-mail ; vous pouvez exiger cette adresse pour les nouvelles conversations hors ligne. Fermer le composant conserve le brouillon non envoyé. Une fois la conversation fermée, Démarrer une nouvelle conversation revient au formulaire initial. Messages et réponses sont reçus par interrogation périodique.

Les opérateurs doivent disposer de Voir le chat en direct pour lire, Répondre au chat en direct pour répondre ou fermer et Gérer le chat en direct pour configurer le composant. Le site sélectionné limite la liste et les actions disponibles.

Utilisez les vues ouvertes, en attente de réponse, non lues et fermées. La recherche porte sur noms, adresses e-mail et historique des messages. La vue ouverte par défaut place les conversations en attente de réponse en premier ; des tris du plus récent ou du plus ancien sont également disponibles. Non lue et en attente de réponse sont deux états différents : lire un message ne le traite pas comme répondu.

La boîte de réception et la conversation s'actualisent toutes les cinq secondes lorsqu'elles sont visibles. Lire au bas d'une conversation visible marque les messages du visiteur comme lus. Si vous consultez l'historique, les nouveaux messages ne déplacent pas votre position ; Nouveaux messages revient aux derniers. Répondez, fermez une conversation résolue ou rouvrez-la si nécessaire. La réouverture permet au visiteur de répondre à nouveau.

Les opérateurs autorisés reçoivent aussi des badges de non-lus dans le menu latéral et des avis dans le panneau pour les nouveaux messages. Ces avis ne marquent pas les conversations comme lues et ne génèrent pas de notifications du système d'exploitation.

Les notifications hors ligne aux opérateurs sont facultatives. Configurez le destinataire et activez-les uniquement si nécessaire. Les e-mails de réponse aux visiteurs sont désactivés ; les réponses des opérateurs passent par le composant de discussion.

Le contenu et la fréquence héritent de la politique de notification du site CMS. Selon cette politique, les envois sont immédiats, regroupés ou inclus dans un récapitulatif quotidien. Les messages d'alerte seuls omettent noms, adresses, corps des messages et jetons privés de conversation. Les récapitulatifs quotidiens contiennent toujours des informations minimales.

Les envois regroupés/quotidiens et les rappels quotidiens nécessitent le planificateur Laravel de l'hôte chaque minute. Consultez sa santé enregistrée si les e-mails restent en attente. Les notifications exclusivement immédiates sans rappel quotidien ne nécessitent pas d'envoi planifié. L'envoi utilise la configuration e-mail du CMS ; une remise réussie au transport ne prouve pas l'arrivée dans la boîte du destinataire.

L'extension active annonce ses routes via la découverte d'API du CMS et OpenAPI. Utilisez GET /webadmin/api/plugins/webblocks-live-chat/settings?site_id=1 avec live-chat.read. PATCH ou PUT sur la même route nécessitent live-chat.settings.write et une site_id explicite.

Les écritures ne modifient que les champs fournis et fusionnent les valeurs linguistiques avec les textes existants. Seules les langues actives du site sont acceptées. Les restrictions de site du jeton et l'accès délégué actuel continuent de s'appliquer. Consultez la politique de capacités des jetons du CMS installé ; l'activation de l'extension n'accorde pas automatiquement l'accès.

Si le bouton d'ouverture manque, vérifiez l'activation de l'extension, le site sélectionné, l'activation du composant et la compatibilité de l'hôte. Le mode hors ligne modifie les textes d'accueil ; l'activation du composant reste indépendante. Si les réponses s'arrêtent, vérifiez si la conversation a été fermée. Pour les e-mails en attente, contrôlez destinataire, configuration e-mail du CMS, politique héritée et santé du planificateur.

Revenez à la présentation des extensions, consultez la version du catalogue ou utilisez la référence de l'Internal Content API.