Comment ajouter le chatbot IA Asyntai à Umbraco
Guide étape par étape pour les sites Umbraco CMS
Étape 1 : Obtenir votre code d'intégration
Tout d'abord, rendez-vous sur votre Tableau de bord Asyntai et faites défiler jusqu'à la section « Code d'intégration ». Copiez votre code d'intégration unique qui ressemblera à ceci :
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Note : Le code ci-dessus n'est qu'un exemple. Vous devez copier votre propre code d'intégration depuis votre Tableau de bord car il contient votre identifiant de widget personnel.
Étape 2 : Modifier le modèle maître (recommandé)
La façon la plus simple d'ajouter le chatbot à toutes les pages est de modifier votre template Master :
- Connectez-vous à votre back-office Umbraco
- Accédez à Paramètres dans la barre latérale gauche
- Développez Templates
- Cliquez sur votre modèle Master (ou le modèle de mise en page principal utilisé par votre site)
- Trouvez la balise fermante
</body> - Collez votre code d'intégration Asyntai juste avant la balise
</body> - Cliquez sur "Save"
Astuce : L'ajout du script avant la balise fermante </body> garantit qu'il se charge après le contenu de la page, ce qui est recommandé pour les widgets de chat et ne ralentira pas le chargement de votre page.
Alternative : Utilisation du type de document Site Settings
Pour plus de flexibilité, vous pouvez ajouter un champ personnalisé pour gérer les scripts de pied de page :
- Accédez à Paramètres → Types de document
- Modifiez votre type de document Site Settings (ou créez-en un s'il n'existe pas)
- Ajoutez une nouvelle propriété appelée « Footer Scripts » avec un type de données Textarea
- Enregistrez le type de document
- Go to Content and edit your Site Settings node
- Collez votre code d'intégration Asyntai dans le champ Footer Scripts
- Dans votre template Master, ajoutez ce code avant
</body>:@Html.Raw(Model.Value("footerScripts")) - Enregistrez à la fois le contenu et le modèle
Note : L'utilisation de @Html.Raw() est importante pour rendre les balises script correctement sans encodage HTML.
Alternative : Utilisation du dossier de scripts
You can also create a JavaScript file in the Umbraco Backoffice:
- Accédez à Paramètres → Scripts
- Faites un clic droit sur Scripts et sélectionnez « Create »
- Créez un nouveau fichier appelé asyntai-chatbot.js
- Ajoutez le code suivant :
(function() {
var script = document.createElement('script');
script.async = true;
script.src = 'https://asyntai.com/static/js/chat-widget.js';
script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
document.body.appendChild(script);
})(); - Replace
YOUR_WIDGET_IDwith your actual widget ID - Enregistrez le fichier
- Incluez ce script dans votre template Master avant
</body>:<script src="/scripts/asyntai-chatbot.js"></script>
Alternative : Par page avec RenderSection
Si vous souhaitez le chatbot uniquement sur des pages spécifiques :
- Dans votre template Master, ajoutez avant
</body>:@RenderSection("footerScripts", required: false) - In the specific page template where you want the chatbot, add:
@section footerScripts {
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
}
Étape 3 : Vérifier l'installation
Après avoir enregistré vos modifications, visitez votre site web dans un nouvel onglet de navigateur ou en navigation privée. Vous devriez voir le bouton du widget de chat dans le coin inférieur droit. Cliquez dessus pour vérifier qu'il s'ouvre et fonctionne correctement.
Vous ne voyez pas le widget ? Assurez-vous d'avoir enregistré le modèle après avoir effectué les modifications. Essayez de vider le cache de votre navigateur ou de consulter le site dans une fenêtre de navigation privée. Si vous utilisez Umbraco Cloud, les modifications devraient se déployer automatiquement. Pour un Umbraco auto-hébergé, vous devrez peut-être redémarrer l'application ou vider le cache.
Weebly