Extension Chatbot IA TYPO3 (Gratuit, TYPO3 10 à 14)

Extension TYPO3

L'extension WebChatAgent intègre votre chatbot sur un site web TYPO3. Vous l'installez, collez votre Identifiant du chatbot dans la configuration du site, et le bouton de chat apparaît sur chaque page de ce site. Aucun TypoScript à inclure et aucun gabarit à modifier. Le design, les textes, le comportement de l'IA et le chat en direct restent gérés dans votre tableau de bord WebChatAgent, les modifications y apparaissent donc immédiatement sur le site web.

Une seule version prend en charge TYPO3 10.4, 11.5, 12.4, 13.4 et 14.

Étape 1 : Installer l'extension

Avec Composer (la plupart des projets TYPO3) :

composer require webchatagent/typo3-webchatagent
vendor/bin/typo3 extension:setup

Sans Composer : ouvrez Outils d'administration → Extensions, recherchez webchatagent et installez-la. TYPO3 crée lui-même les champs de base de données.

L'extension est gratuite. Vous la trouverez dans le TYPO3 Extension Repository et sur Packagist.

Étape 2 : Copier votre Identifiant du chatbot

1. Connectez-vous à votre tableau de bord WebChatAgent et ouvrez votre chatbot.
2. Ouvrez Actions du chatbot et cliquez sur Copier l’identifiant du chatbot.

L'identifiant ressemble à 3f2b9c1e-8a7d-4e5f-9b0c-1d2e3f4a5b6c.

Étape 3 : Ajouter l'identifiant à votre site

1. Dans TYPO3, allez dans Gestion du site → Sites et modifiez votre site.
2. Ouvrez l'onglet Chat.
3. Collez l'Identifiant du chatbot dans le champ Identifiant du chatbot et enregistrez.

Ouvrez votre site web dans un nouvel onglet : le bouton de chat se trouve dans le coin de chaque page. Avec plusieurs sites dans une même installation TYPO3, chaque site reçoit son propre identifiant, afin que chaque site web puisse exécuter son propre chatbot.

Masquer le chat sur certaines pages

Ouvrez les propriétés de la page, onglet Chat, puis activez Masquer le bouton de chat sur cette page et toutes les sous-pages. Pratique pour les pages de commande, les pages d'atterrissage pour les campagnes publicitaires ou un espace intranet.

L'option s'applique à la page et à toute son arborescence inférieure. Activez-la sur la page racine et le bouton de chat disparaît sur tout le site, un moyen rapide de suspendre le chat sans supprimer l'identifiant.

Afficher le chat dans une page

Pour une page de contact ou d'aide, vous pouvez placer le chat directement dans le contenu au lieu du bouton flottant (ou en plus de celui-ci) :

1. Dans le module Page, ajoutez un nouvel élément de contenu.
2. Choisissez Chat intégré sous Éléments spéciaux.
3. Laissez Identifiant du chatbot vide pour utiliser l'identifiant du site, ou saisissez-en un autre pour cette page.
4. Facultatif : définissez une Hauteur telle que 600px ou 80vh. Sans cela, le chat s'adapte à son contenu.

Le script du chat intégré se charge uniquement sur les pages qui contiennent un tel élément. Le texte de bienvenue, le thème et les autres options intégrées proviennent de Canaux → Chat intégré dans le tableau de bord, voir le guide sur le chat intégré.

Les rédacteurs sans droits d'administration ont besoin que les nouveaux champs et le type de contenu "Chat intégré" soient activés dans leur groupe d'utilisateurs backend.

Transmettre les utilisateurs connectés du site web au chat

Si votre site TYPO3 dispose d'un espace de connexion, activez Transmettre les utilisateurs connectés du site web au chat dans l'onglet Chat du site. Pour les visiteurs connectés, le chat reçoit alors le nom, l'adresse e-mail et le nom d'utilisateur. Le bot peut les accueillir par leur nom et ne leur redemande pas leurs coordonnées.

TYPO3 ajoute ces données à chaque requête, elles ne sont jamais enregistrées dans le cache de la page. Les visiteurs non connectés n'ont aucune donnée utilisateur transmise. Mentionnez ce transfert dans votre politique de confidentialité.

Transmettre vos propres données (pour les développeurs)

Pour transmettre d'autres informations, par exemple un numéro de client, enregistrez un écouteur pour l'événement WebChatAgent\WebChatAgent\Event\ModifyContextDataEvent et ajoutez vos clés avec setContextData(). Le README sur GitHub propose un exemple complet. Le format et les limites sont décrits dans Intégrer le widget de chat.

Content Security Policy

Lorsque la CSP frontend est activée (TYPO3 12 et versions plus récentes), l'extension ajoute le serveur de chat à la politique pour les scripts, les connexions, les images et les médias, et autorise les styles inline pour le widget. Vous n'avez pas besoin de modifier csp.yaml.

Consentement aux cookies

WebChatAgent n'affiche pas sa propre bannière de consentement. Sans signal de consentement, il fonctionne en mode de confidentialité anonyme. Si votre site TYPO3 utilise un gestionnaire de consentement, connectez-le comme décrit dans Consentement aux cookies et déclencheurs proactifs anonymes.

Dépannage

• Aucun bouton de chat ? Vérifiez que l'identifiant dans l'onglet Chat est complet et que la page ainsi que ses pages parentes n'ont pas l'option Masquer le bouton de chat activée. Videz ensuite les caches de TYPO3. Si vous utilisez un cache de fichiers statiques comme EXT:staticfilecache, videz-le également.
• Toujours rien ? Votre chatbot est peut-être restreint à certains domaines. Ajoutez le domaine de votre site web sous Domaines autorisés dans le tableau de bord.
• Bloqué par la Content Security Policy ? Vérifiez la console du navigateur. Si vous hébergez le chat sous votre propre adresse (marque blanche), saisissez-la comme Adresse du serveur dans l'onglet Chat, afin que l'extension autorise précisément cette adresse.