# Installer l’agent Nodale sur votre site web

<https://nodale.ai/fr/docs>

Une seule balise script place l’agent Nodale sur votre site. Où la coller, ce que votre site doit autoriser, et comment vérifier qu’elle fonctionne.

L’agent Nodale fonctionne sur votre site web grâce à une seule balise script. Cette page s’adresse au développeur qui l’installe. Pour piloter l’agent depuis votre propre code, lisez l’[API JavaScript](https://nodale.ai/fr/docs/api).

## Avant de commencer

Deux conditions doivent être remplies dans votre espace de travail Nodale, sinon le tag ne fait rien :

1. **L’agent est publié et en ligne.** L’onglet Installation de votre agent n’affiche la ligne à coller qu’une fois l’agent publié et son déploiement en ligne.
2. **Votre site est déclaré.** Ajoutez son adresse dans **Sites autorisés**, dans le même onglet. Les règles sont [ci-dessous](#sites-autorisés).

## Coller le tag

```html
<script src="https://tag.nodale.app/v1/tag.js" data-workspace="YOUR_WORKSPACE_ID" async></script>
```

Copiez la ligne depuis l’onglet Installation : elle contient déjà l’identifiant de votre espace de travail. Collez-la sur chaque page où vous voulez l’agent, dans le `<head>` ou juste avant `</body>`.

- **Une ligne par espace de travail, collée une fois.** Le tag lit la configuration actuelle de votre espace de travail à chaque chargement de page. Publier une nouvelle version de l’agent ou changer son affichage atteint toutes les pages sans que personne ne touche au site.
- **Il s’exécute une fois par page.** Le coller deux fois, ou le charger depuis un gestionnaire de balises en plus de la page, est sans conséquence : la seconde copie voit la première et s’arrête.
- **Les applications monopages sont suivies.** L’agent reste monté quand votre application navigue avec `pushState`, `replaceState` ou `popstate`.
- **Langue.** Le widget prend la langue de la page dans `<html lang>`. Pour la fixer vous-même, ajoutez `data-lang` au tag, par exemple `data-lang="fr"`.
- **Un espace de travail par page.** Une page exécute un seul tag.

## Sites autorisés

Le tag ne répond que sur les sites que votre espace de travail déclare. Sur tout autre site, rien n’est ajouté à la page.

- Une entrée est une origine, schéma et port compris : `https://www.example.com`. Elle n’a pas de chemin.
- `https` uniquement, sauf `localhost` et `127.0.0.1` pour le travail en local.
- `https://*.example.com` couvre tous les sous-domaines, à n’importe quelle profondeur, mais pas `example.com` lui-même. Déclarez l’apex comme une entrée à part.
- 20 sites au maximum par espace de travail.
- Un changement ne demande aucune publication. Un site retiré cesse d’afficher l’agent au prochain chargement de page du visiteur.

## Où l’agent s’affiche

L’affichage est un réglage de l’onglet Installation, pas du tag :

- **Barre flottante** : une barre flottante en bas de la page.
- **Bouton** : un lanceur dans le coin inférieur droit, qui ouvre le widget au clic.

Pour placer plutôt l’agent dans votre propre mise en page, ajoutez cet élément là où vous le voulez. Le widget se monte dans le premier qu’il trouve, dans le flux de la page, quel que soit le réglage d’affichage :

```html
<div data-nodale-agent></div>
```

Un troisième affichage, `hidden`, garde l’agent hors de vue jusqu’à ce que votre code l’ouvre. Il est décrit avec l’[API JavaScript](https://nodale.ai/fr/docs/api#affichage-hidden).

## Content Security Policy

Un site qui envoie une Content Security Policy ajoute exactement trois sources aux directives qu’il a déjà :

```text
script-src  https://tag.nodale.app;
frame-src   https://nodale.app;
connect-src https://nodale.app
```

- Pas de `'unsafe-inline'`, pas de `'unsafe-eval'`, pas de joker et pas de nonce : le tag est un script externe sans code inline.
- Aucune entrée `style-src`, `img-src`, `font-src` ou `media-src` : tout ce que le widget affiche se charge dans son propre cadre.
- `require-trusted-types-for 'script'` est compatible.
- `frame-src` se rabat sur `child-src`, puis sur `default-src`.

## Microphone

La voix a besoin du microphone, et le navigateur ne le demande que lorsque le visiteur appuie sur le bouton du microphone, jamais au chargement de la page.

Si votre site envoie un en-tête `Permissions-Policy`, il ne doit pas refuser le microphone au widget. Soit vous omettez `microphone`, soit vous autorisez l’origine Nodale :

```text
Permissions-Policy: microphone=(self "https://nodale.app")
```

## Bandeaux cookies

Un outil de consentement qui bloque les scripts automatiquement doit exempter le tag Nodale, ou le classer dans la catégorie que votre espace de travail a choisie pour la mesure des visites. Un tag bloqué ne peut pas afficher l’agent.

La mesure des visites est désactivée par défaut. Quand vous l’activez, les pages vues ne sont comptées qu’une fois que le visiteur a accepté. Le tag lit la réponse dans votre bandeau cookies ; un site qui n’en a pas la transmet avec [`nodale('consent')`](https://nodale.ai/fr/docs/api#nodaleconsent). L’agent lui-même est monté dans les deux cas.

## Vérifier l’installation

Ouvrez l’onglet Installation. La carte **Tag sur vos sites** liste chaque site déclaré comme **Détecté** ou **Non détecté**, avec la dernière fois où le tag a été vu. **Vérifier à nouveau** lit la page d’accueil de chaque site.

Si l’agent ne s’affiche pas sur une page, vérifiez dans cet ordre :

1. Le site est dans **Sites autorisés**, avec le schéma et le sous-domaine exacts.
2. L’agent est publié et son déploiement est en ligne.
3. La Content Security Policy de la page contient les trois sources ci-dessus.
4. Aucun outil de consentement ne bloque le script.

Le tag n’écrit jamais d’erreur sur votre page. Il laisse une ligne `console.debug` commençant par `nodale tag:` quand il s’arrête.

## Docs

- [API JavaScript : ouvrir l’agent Nodale depuis votre code](https://nodale.ai/fr/docs/api): Les commandes nodale() qu’une page peut appeler : ouvrir l’agent depuis votre bouton ou formulaire, passer un e-mail et du contexte, signaler le consentement. (Markdown: https://nodale.ai/fr/docs/api.md)
- [Serveur MCP : gérer votre espace Nodale depuis Claude Code](https://nodale.ai/fr/docs/mcp): Connectez Claude Code au serveur MCP de Nodale, puis lisez et modifiez votre espace : connaissances, assets de démo, réglages de l’agent, sites, déploiement. (Markdown: https://nodale.ai/fr/docs/mcp.md)
