Intégration Contao
Ajoutez le chat à chaque page de votre site Contao
Aperçu
L'extension Asyntai ajoute deux champs aux paramètres de votre Contao. Collez l'identifiant de votre widget dans le premier et la bulle de chat apparaît sur chaque page du front end du site. Vous ne modifiez ni template, ni mise en page, ni article, et rien n'est ajouté au back end de Contao.
Configuration
L'installation prend environ cinq minutes et demande une personne capable d'installer des extensions sur le site.
Créez votre assistant
Ouvrez un compte Asyntai gratuit, ajoutez l'adresse de votre site et laissez-le lire vos pages. Téléversez aussi vos listes de prix, vos conditions ou vos manuels si les réponses se trouvent dans des documents.
Installez l'extension
Ouvrez le Contao Manager, cherchez Asyntai et installez le paquet. Si vous déployez en ligne de commande, utilisez plutôt Composer :
composer require asyntai/contao-chatbot-bundle
Lancez ensuite la mise à jour habituelle de la base de données, comme après toute autre extension.
Collez l'identifiant de votre widget
Dans le back end de Contao, allez dans Système, puis Paramètres. Vous y trouverez une section nommée Asyntai AI chatbot. Collez le code de votre tableau de bord Asyntai dans le champ Asyntai widget ID et enregistrez.
Ouvrez votre site
Chargez une page quelconque du front end. La bulle de chat apparaît dans le coin. Posez-lui une question sur votre activité pour voir la réponse qu'elle donne.
Astuce : Vous pouvez coller le code complet du tableau de bord. L'extension en extrait l'identifiant du widget et n'enregistre que celui-ci.
Où le script est ajouté
L'extension utilise le hook generatePage de Contao et ajoute un petit script à la fin du body sur les pages du front end. Vos templates restent intacts, donc une mise à jour de Contao ne peut jamais écraser la modification. Le script attend l'événement load de la page avant de charger quoi que ce soit, ainsi votre propre contenu s'affiche toujours en premier.
Les champs de paramètres
Asyntai widget ID : l'identifiant du site avec lequel vous voulez répondre. Laissez le champ vide pour désactiver le chat.
Script address : laissez ce champ vide. Il n'existe que pour le cas rare où vous servez le widget depuis votre propre adresse.
Désactivation
Videz le champ de l'identifiant du widget et enregistrez. Le script cesse d'apparaître au chargement suivant de la page. Il n'y a aucun cache à vider et aucun balisage ne reste. Vous pouvez aussi désinstaller l'extension dans le Contao Manager ; elle ne crée aucune table de base de données, donc rien ne reste.
Plusieurs sites clients
Le paramètre appartient à l'installation Contao, donc chaque site a son propre identifiant de widget. Donnez à chaque client son propre site dans Asyntai et chaque site répond à partir de son propre contenu, avec son propre historique de chat et ses propres prospects.
Prérequis
- Contao 5.3 ou plus récent
- PHP 8.2 ou plus récent
- Un compte Asyntai avec vos contenus ajoutés
Note : L'extension est gratuite et open source sous licence MIT. Vous payez seulement votre offre Asyntai, où chaque réponse compte pour un message.
Anciennes versions de Contao
Sur Contao 4, l'extension n'est pas prise en charge. Vous pouvez tout de même utiliser Asyntai : copiez le code de votre tableau de bord et collez-le dans votre mise en page, dans le champ des scripts avant la fin du body.
Besoin d'aide ?
Écrivez-nous à [email protected] et nous vous aiderons à le mettre en place.