← Tous les guides

Installer votre assistant sur un site que vous gérez en code, avec ou sans IA

Version du 26 octobre 2026

Votre site est fait avec du code (Next.js, React, Astro, HTML) ou avec un outil qui l'écrit pour vous (Lovable, Bolt, v0, Cursor, Claude Code, ChatGPT). Le plus simple : confier l'installation à votre IA avec la consigne ci-dessous. Elle contient déjà votre code.

Consigne pour votre IA

Copiez ce texte et collez-le dans la conversation de votre outil :

Ajoute l'assistant Aiguilleuse sur toutes les pages de mon site.

Voici la ligne à intégrer, sans la modifier :
<script async src="https://api.preview.aiguilleuse.ai/balise.js?assistant=votre-identifiant"></script>

1. Place-la une seule fois, dans le gabarit commun à toutes les pages (layout racine, template de base ou index.html), juste avant </body>. Pas page par page.
2. Garde l'adresse exacte, paramètre compris. Ne télécharge pas le fichier pour l'héberger sur mon site : il se met à jour tout seul.
3. Selon l'outil du site :
   - Next.js : le composant Script de next/script dans le layout racine (app/layout.tsx, ou pages/_app.tsx), avec strategy="lazyOnload" ;
   - React avec Vite : index.html, juste avant </body> ;
   - Astro : le layout commun, avec l'attribut is:inline ;
   - HTML : chaque gabarit de page.
4. Si le site envoie un en-tête Content-Security-Policy, ajoute https://api.aiguilleuse.ai à script-src et à connect-src.
5. Ne modifie rien d'autre. Montre-moi le changement, puis dis-moi comment publier le site.

Puis publiez le site comme d'habitude.

Sans IA

La même consigne vaut pour vous ou votre développeur. Les deux cas les plus courants :

HTML, React avec Vite : collez la ligne juste avant </body>, dans index.html ou dans chaque gabarit de page.

<script async src="https://api.preview.aiguilleuse.ai/balise.js?assistant=votre-identifiant"></script>

Next.js : dans le layout racine (app/layout.tsx), à l'intérieur de <body> :

import Script from "next/script";

<Script src="https://api.preview.aiguilleuse.ai/balise.js?assistant=votre-identifiant" strategy="lazyOnload" />

Vérifier

  1. Ouvrez votre site publié, à son adresse habituelle, dans une fenêtre de navigation privée.
  2. Si votre assistant est mis en ligne, son bouton apparaît sur la page.
  3. Dans votre tableau de bord, page Installation, la mention « Balise vue sur votre site » s'affiche avec la date du jour. Elle apparaît même avant la mise en ligne.

Si rien ne s'affiche

  • Votre assistant n'est pas encore mis en ligne : le code est bien là (la mention « Balise vue » le confirme), il ne reste qu'à le mettre en ligne depuis la page Installation.
  • Vous regardez l'aperçu de l'outil (Lovable, Bolt, v0) : regardez le site publié.
  • « Balise vue » ne s'affiche pas alors que le bouton apparaît : le site testé n'est pas à l'adresse déclarée (par exemple une adresse de test en .lovable.app ou .vercel.app). L'assistant s'y affiche, mais seule votre adresse déclarée est comptée.
  • Erreur « Content Security Policy » dans la console du navigateur : reprenez l'étape 4 de la consigne.
  • Votre bandeau de cookies bloque l'assistant : votre assistant n'écrit rien dans le navigateur d'un visiteur avant que celui-ci l'ouvre. Vous pouvez le ranger parmi les services nécessaires, qui ne demandent pas d'accord.

Sources