L'assistant des visiteurs est une petite bulle « Je suis une IA » posée sur votre site public. Le visiteur y tape sa question, Astus cherche dans les pages de votre site et lui répond en deux ou trois phrases, avec des liens vers les bonnes pages.
C'est un module à part, installé avec le paquet depuis la version 2.1.9, mais jamais publié tout seul : chaque question consomme des jetons sur votre compte d'IA, sans clic de votre part. C'est à vous de décider de l'ouvrir.
Ce qu'il fait, et ce qu'il ne fait pas
Il cherche uniquement dans votre site, dans l'index de la Recherche avancée de Joomla, avec les droits d'un simple visiteur. Un article non publié, programmé pour plus tard ou réservé aux membres n'y est pas : l'assistant ne peut donc pas le montrer.
Il n'invente aucun lien. L'IA choisit parmi les pages trouvées par la recherche, par leur numéro ; les adresses sont construites par Astus à partir de l'index. Si le texte de l'IA contient une adresse web ou électronique, elle est retirée avant l'affichage.
Il n'écrit rien sur votre site. Aucun outil, aucune modification : il lit l'index, il répond.
Il ne remplace pas votre service client. Quand il ne trouve pas, il le dit, et propose votre page contact ou un ticket d'assistance si vous les avez renseignés.
Avant de commencer : trois conditions
Tant que l'une d'elles manque, la bulle reste cachée. C'est voulu : une bulle qui répond « indisponible » à chaque question serait pire que pas de bulle.
- Le plugin Système - Astus est activé. Voir Installer Astus et afficher ses modules.
- Une clé d'IA est enregistrée dans Composants → Astus, bouton Options. L'assistant utilise le même fournisseur que le reste d'Astus (Gemini, Claude ou Mistral).
- L'index de la Recherche avancée est rempli. Ouvrez Composants → Recherche avancée et cliquez Indexer. Vérifiez au passage que le plugin Contenu - Recherche avancée est activé : c'est lui qui ajoute à l'index chaque article que vous enregistrez ensuite.
Si l'index est vide ou ancien, l'assistant ne trouve rien ou trouve des pages périmées. Relancez Indexer après une grosse série de modifications.
Publier le module, pas à pas
Le module est déjà installé avec le paquet : il n'y a rien à téléverser.
- Ouvrez Contenu → Modules du site, puis cliquez Nouveau.
- Choisissez Astus - Assistant des visiteurs.
- Titre : un nom pour vous retrouver dans la liste, par exemple « Assistant ». Dans la colonne de droite, réglez Titre sur Masquer.
- Position : choisissez une position présente sur toutes les pages. Dans Cassiopeia comme dans Corpus, la position
debugconvient. La bulle flotte de toute façon en bas de l'écran : la position sert seulement à ce que Joomla l'écrive dans la page. - Statut : Publié.
- Langue : Toutes. Un seul module suffit pour un site multilingue (voir plus bas).
- Onglet Affectation des menus : Sur toutes les pages, ou seulement sur les pages de votre choix.
- Onglet Avancé, Style du module : choisissez none (groupe Système). Sinon le modèle dessine une carte vide, avec son titre, à l'endroit de la position.
- Réglez l'onglet Limites (plus bas) avant d'enregistrer, puis Enregistrer & Fermer.
Ouvrez votre site dans une fenêtre privée : la bulle apparaît en bas à droite. Posez une question sur un sujet que vos pages traitent.
Les réglages de l'onglet Module
L'onglet s'ouvre sur une fiche de présentation du module. Dessous, l'apparence est à gauche et « Quand l'assistant ne trouve pas » à droite ; les liens extérieurs suivent, sur toute la largeur. Sur un écran étroit, tout passe sur une colonne. Tous les champs ont une valeur par défaut : vous pouvez publier sans rien toucher.
L'apparence
| Réglage | Ce qu'il fait | Par défaut |
|---|---|---|
| Nom de l'assistant | Un prénom ou un nom, par exemple « Léa ». Il remplace « Assistant du site » en tête du panneau et dans l'accueil : « Bonjour. Je suis Léa, une IA… ». La mention « IA » reste toujours affichée. | Vide : « Assistant du site » |
| Titre de la bulle | La première ligne de la bulle, en gras. | Vide : « Je suis une IA » |
| Texte de la bulle | La seconde ligne. Masquée sur téléphone. | Vide : « Une question ? Je cherche la réponse sur le site. » |
| Côté de l'écran | Gauche ou droite. | Droite |
| Format de la bulle | Complète : l'icône, le titre et le texte. Petite : un rond avec l'icône et la pastille « IA ». Automatique : complète tant que le visiteur ne l'a pas ouverte, petite ensuite. | Automatique |
| Fermer au clic sur la page | Le panneau se referme quand le visiteur clique ailleurs sur la page. Sans effet sur téléphone, où le panneau occupe tout l'écran. | Oui |
| Fermer après inactivité (minutes) | Le panneau se referme seul après ce délai sans activité. Jamais pendant une recherche, ni si le visiteur a commencé à écrire. La conversation est gardée. 0 : jamais. | 5 |
| Couleur imposée | Laissez vide pour reprendre les couleurs de votre modèle (voir plus bas). Une couleur choisie ici gagne ; le texte passe en blanc ou en noir selon ce qui se lit le mieux. | Vide |
| Page de confidentialité | Un élément de menu. Son lien s'affiche sous le champ de saisie, à côté de la mention qui prévient que les questions partent chez un fournisseur d'IA. | Aucune |
Pourquoi « Je suis une IA » ? Le règlement européen sur l'IA impose de prévenir une personne qu'elle s'adresse à une IA. Gardez cette mention, même si vous donnez un prénom à l'assistant.
Quand l'assistant ne trouve pas
Sous chaque réponse qui n'aboutit pas, un encadré propose au visiteur de vous écrire. Il s'affiche quand rien n'est trouvé, quand l'IA juge que vos pages ne répondent pas, quand un plafond est atteint ou en cas de panne. Jamais sous une vraie réponse. Si vous ne renseignez ni page contact ni assistance, il ne s'affiche pas.
| Réglage | Ce qu'il fait |
|---|---|
| Phrase d'introduction | Au-dessus des liens. Vide : « Pas de réponse ici ? Notre équipe peut vous aider. » |
| Page contact | L'élément de menu de votre page contact. |
| Texte du lien contact | Vide : « Nous écrire depuis la page contact ». |
| Assistance | Aucune, Page du site ou Lien extérieur. Le champ suivant change selon ce choix. |
| Page d'assistance | Avec Page du site : l'élément de menu de votre page d'assistance. |
| Adresse d'assistance | Avec Lien extérieur : l'adresse de votre système de tickets, complète (https://…) ou en chemin du site (/support). |
| Texte du lien d'assistance | Vide : « Ouvrir un ticket d'assistance ». |
Les liens extérieurs
Pour les questions que votre site ne traite pas mais qu'un autre site couvre bien : un forum, une documentation officielle. Cliquez + pour ajouter une ligne, dix au plus.
| Colonne | Exemple |
|---|---|
| Nom affiché | Forum Joomla.fr |
| Adresse | https://forum.joomla.fr |
| Ce qu'il couvre | Questions générales sur Joomla : installation, mises à jour, extensions |
| Langue | Français (France), ou Toutes |
L'assistant ne propose que ces liens, deux au plus, et seulement quand la question entre dans leur sujet. Écrivez donc la colonne Ce qu'il couvre avec soin : c'est elle que l'IA lit pour décider. Ils s'affichent sous « Ailleurs sur le web » et s'ouvrent dans un nouvel onglet. Si vos propres pages répondent, elles passent avant.
Les réglages de l'onglet Limites
Vous payez chaque question. Une question coûte deux petits appels à l'IA, avec un modèle léger : quelques centaines de jetons, une fraction de centime. Mais sur un site public, n'importe qui peut poser des questions. Ces plafonds sont tenus par le serveur : un visiteur ne peut pas les contourner.
| Réglage | Ce qu'il fait | Par défaut |
|---|---|---|
| Questions par visiteur et par jour | Au-delà, la bulle propose la recherche classique du site. | 10 |
| Questions par mois, pour tout le site | Votre budget. Au-delà, l'assistant se met en pause jusqu'au premier du mois suivant. | 300 |
| Garder les questions sans réponse | Les questions restées sans réponse sont gardées, sans adresse ni identifiant. | Oui |
| Modèle d'IA | Laissez vide : Astus prend le petit modèle de votre fournisseur (Gemini Flash-Lite, Claude Haiku ou Mistral Small). | Vide |
Après sa première question, le visiteur voit sous le champ de saisie combien il lui en reste pour la journée.
Les couleurs
Aucune couleur n'est inventée : la bulle prend celles de votre modèle.
- Avec Corpus, elle reprend sa couleur d'accent, son fond, ses textes, ses arrondis et sa police, mode sombre compris. Changez la teinte de Corpus : la bulle suit.
- Avec Cassiopeia, elle reprend la couleur primaire du modèle, et les couleurs de fond et de texte de Bootstrap.
- Avec un autre modèle, elle se rabat sur les variables de Bootstrap, puis sur un bleu sombre.
Pour imposer une autre couleur, utilisez le réglage Couleur imposée.
Un site multilingue
Un seul module suffit. Laissez sa langue sur Toutes.
- Les textes de la bulle et du panneau suivent la langue de la page.
- La recherche ne montre que les pages de cette langue, plus celles marquées Toutes.
- L'IA répond dans la langue de la page.
- Les pages choisies dans le module (confidentialité, contact, assistance) : choisissez la page dans une seule langue. Si elle est associée à ses traductions dans Joomla, chaque visiteur reçoit celle de sa langue. Votre page de confidentialité en français choisie ici donne la page anglaise au visiteur anglais.
- Les liens extérieurs ont leur colonne Langue : le forum francophone pour les pages en français, le forum anglophone pour les pages en anglais.
Attention aux textes personnalisés. Le nom de l'assistant vaut pour toutes les langues, c'est normal pour un prénom. Mais un titre de bulle, une phrase d'introduction ou un texte de lien saisis dans le module s'affichent tels quels dans toutes les langues. Sur un site multilingue, laissez-les vides : ils sont alors traduits. Si vous tenez à les personnaliser, publiez un module par langue, avec le champ Langue du module réglé sur chacune.
Ce que voit le visiteur
- La bulle, en bas de l'écran. Elle ne s'ouvre jamais toute seule.
- Le panneau, à droite sur ordinateur, en plein écran sur téléphone. Il s'utilise entièrement au clavier : la touche Échap le referme et rend la main à la bulle.
- Les réponses, avec un à trois liens vers vos pages. Quand aucune page ne convient, un lien vers la recherche classique du site.
- La conversation le suit d'une page à l'autre pendant sa visite. Quand il clique sur une page proposée, il y arrive panneau fermé, pour la lire ; la conversation l'attend dans la bulle.
- Nouvelle conversation : le bouton en forme de flèche circulaire, en haut du panneau, efface l'échange.
Ouvrir l'assistant depuis un lien de vos pages
L'assistant n'a pas d'adresse à lui : il vit dans sa bulle. Pour qu'un lien de vos pages l'ouvre, par exemple « Demander à l'assistant » au bas d'un article, donnez à ce lien l'attribut data-astus-ouvrir, dans le code HTML de la page. Un clic dessus ouvre le panneau, où que le lien se trouve.
Écrivez ce lien caché, avec l'attribut hidden : <a href="#" data-astus-ouvrir hidden>Demander à l'assistant</a>. Astus le montre sur les pages où l'assistant est présent. Ailleurs, il reste caché : un lien qui ne fait rien serait pire que pas de lien du tout.
Les questions sans réponse
Ouvrez Composants → Astus → Vos extensions. Le bloc Assistant des visiteurs indique si le module est publié, combien de questions ont été posées ce mois-ci, et liste les dernières questions restées sans réponse.
Une question sans réponse, c'est un sujet que votre site ne traite pas encore, ou qu'il traite avec d'autres mots. C'est votre prochain article.
Ce qui sort du site
- La question du visiteur et les extraits des pages trouvées partent chez votre fournisseur d'IA, pour rédiger la réponse. Une ligne sous le champ de saisie le dit au visiteur, et lui demande de ne pas y mettre de données personnelles.
- L'adresse IP du visiteur sert à compter ses questions du jour. Elle est hachée avec le secret de votre site et la date : elle n'est jamais conservée en clair et change chaque jour. Les compteurs sont effacés au-delà de quarante jours.
- Les questions sans réponse sont gardées sans adresse ni identifiant : la question, sa langue et sa date. Réglez Garder les questions sans réponse sur Non si vous ne le souhaitez pas.
Pensez à mentionner l'assistant dans votre politique de confidentialité.
Quand la bulle n'apparaît pas
Vérifiez dans cet ordre :
- Le module est publié, avec une position et une affectation aux pages concernées.
- La position choisie existe bien dans votre modèle et sur cette page.
- Le plugin Système - Astus est activé.
- Une clé d'IA est enregistrée dans les Options d'Astus.
- L'index de la Recherche avancée contient au moins une page publiée.
- Le cache de Joomla : videz-le (Système, rubrique Maintenance, Effacer le cache) après avoir publié le module.
La bulle s'affiche mais répond « L'assistant ne peut pas répondre pour le moment » : le fournisseur d'IA refuse la clé ou ne répond pas. Essayez le chat d'Astus dans l'administration : il affiche le message d'erreur exact du fournisseur. Un plafond atteint donne un autre message, qui le dit clairement.
Elle répond, mais ne trouve jamais rien : relancez l'indexation de la Recherche avancée, et vérifiez que vos articles sont publics et publiés.