Intégration Wagtail
Un assistant IA qui répond aux questions sur votre site Wagtail
Aperçu
Le paquet Wagtail place un assistant IA sur votre site. Un bouton de chat se trouve dans le coin de chaque page, les visiteurs posent leur question avec leurs propres mots, et la réponse vient de vos propres contenus : votre site web, vos documents téléversés et vos articles d'aide.
Avertissement IA : Les réponses sur votre site web sont produites par une IA. Elles peuvent parfois être inexactes ou incomplètes. Vérifiez-les avant de vous y fier, surtout pour des décisions importantes.
Comment ça marche
Le paquet ajoute un intergiciel qui place un petit script juste avant la balise de fermeture body de chaque page. Ce script attend la fin du chargement de la page, puis récupère le widget de chat chez Asyntai. Votre site s'affiche donc en premier et la vitesse de la page ne change pas. Votre serveur ne parle jamais à Asyntai ; seul le navigateur du visiteur le fait.
Vous ne changez rien dans vos gabarits. L'intergiciel laisse l'administration de Wagtail tranquille, et il laisse tranquille tout ce qui n'est pas une page HTML.
Prérequis
- Un compte Asyntai. La formule gratuite suffit pour commencer.
- Un site Wagtail, version 5.2 ou plus récente, avec Django 4.2 ou plus récent et Python 3.9 ou plus récent.
- L'accès au code de ce site, car vous installez un paquet Python.
Installation
Suivez ces étapes pour ajouter Asyntai à votre site Wagtail :
Installer le paquet
Installez-le depuis le Python Package Index, dans le même environnement que votre site :
pip install wagtail-ai-chatbot
L'ajouter à vos réglages
Ajoutez l'application et le module de réglages Wagtail à INSTALLED_APPS, et l'intergiciel en haut de MIDDLEWARE :
INSTALLED_APPS = ["wagtail_asyntai", "wagtail.contrib.settings", ...]
MIDDLEWARE = ["wagtail_asyntai.middleware.AsyntaiWidgetMiddleware", ...]
Lancer la migration
Cela crée la table qui garde vos réglages :
python manage.py migrate wagtail_asyntai
Collez l'identifiant de votre widget
In the Wagtail admin, open Settings and then Asyntai chat assistant. Paste your widget ID and select Save. You find the ID in your Asyntai Dashboard under Setup & Integration. You can paste the whole snippet; the package keeps only the ID.
Astuce : Ajoutez vos documents, vos questions et réponses et vos instructions dans le tableau de bord Asyntai avant de publier, afin que l'assistant réponde correctement dès le premier visiteur.
Paramètres
- ID du widget : le chat est actif tant que ce champ contient un ID valide, et inactif quand il est vide.
- Afficher le chat aux visiteurs déconnectés seulement : les utilisateurs connectés ne voient jamais le chat. Utile quand l'assistant est là pour répondre aux gens qui ne se sont pas encore inscrits.
- Adresse du script du widget : laissez cette valeur telle quelle, sauf si le support Asyntai vous demande de la changer.
Les réglages sont par site, donc un projet qui sert plusieurs sites depuis une seule installation Wagtail peut donner à chaque site son propre assistant.
Réglages dans votre fichier de réglages
Un projet qui garde sa configuration dans des variables d'environnement peut sauter l'administration et poser les valeurs dans le code. Si les deux sont remplis, l'administration l'emporte.
ASYNTAI_WIDGET_ID = "asyntai_ab12cd34"
Trois autres valeurs sont facultatives : ASYNTAI_SHOW_TO_ANONYMOUS_ONLY, ASYNTAI_SCRIPT_URL et ASYNTAI_SKIP_PREFIXES. La dernière nomme les chemins que le widget ne touche jamais, ce dont vous avez besoin quand votre administration n'est pas à /admin/.
Placer le widget à la main
Si vous préférez choisir l'endroit vous-même, laissez l'intergiciel de côté et mettez la balise dans votre gabarit de base. La balise et l'intergiciel ne se déclenchent jamais tous les deux, vous pouvez donc garder les deux.
{% load asyntai %} ... {% asyntai_widget %}
Ce que l'assistant sait faire
- Répondre aux questions des visiteurs tout de suite, 24 h sur 24, sur chaque page
- Répondre dans plus de 80 langues, détectées automatiquement à partir de la question
- Rester ouvert pendant que le visiteur passe d'une page à l'autre
- Utiliser vos propres documents, FAQ et instructions pour donner des réponses précises
Formules et tarifs
L'intégration Wagtail est disponible sur toutes les formules Asyntai, y compris la formule gratuite. Chaque formule comprend un quota mensuel de messages partagé entre tous vos canaux et toutes vos intégrations. Voir les tarifs.
Désinstallation
Videz le champ de l'ID du widget pour désactiver le chat. Pour retirer le paquet, enlevez l'intergiciel et l'application de vos réglages, puis désinstallez-le avec pip.
Code source
The package is free and open source, under the MIT licence. You can read every line on GitHub.
Besoin d'aide ?
If you have any questions or run into issues, contact us at [email protected].