Retour au tableau de bord

Documentation

Apprenez à utiliser Asyntai

Intégration Wagtail

Un assistant IA qui répond aux questions sur votre site Wagtail

Aller au tableau de bord

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 :

1

Installer le paquet

Installez-le depuis le Python Package Index, dans le même environnement que votre site :

pip install wagtail-ai-chatbot
2

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", ...]
3

Lancer la migration

Cela crée la table qui garde vos réglages :

python manage.py migrate wagtail_asyntai
4

Collez l'identifiant de votre widget

Dans l'administration de Wagtail, ouvrez Settings puis Asyntai chat assistant. Collez votre ID de widget et choisissez Save. Vous trouvez cet ID dans votre tableau de bord Asyntai sous Setup & Integration. Vous pouvez coller tout l'extrait de code ; le paquet ne garde que l'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

Confidentialité

Le paquet publie exactement deux valeurs sur la page : l'ID du widget et l'adresse du script. Rien sur vos pages ni sur vos utilisateurs n'est envoyé à Asyntai. Seul le navigateur du visiteur parle à Asyntai, et seulement quand le visiteur ouvre le chat.

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

Le paquet est libre et ouvert, sous licence MIT. Vous pouvez lire chaque ligne sur GitHub.

Besoin d'aide ?

Si vous avez des questions ou rencontrez des problèmes, contactez-nous à [email protected].