Installer l’agent sur votre site
Une ligne de code, collée une seule fois sur toutes les pages de votre site. Tout le reste se règle dans l’app Nudge, sans retoucher au code.
Comment ça marche
Le Website Agent vit dans un petit widget : la barre de chat en bas de vos pages. Pour l’ajouter à votre site, vous collez une ligne de code (le snippet) une seule fois, dans la partie commune à toutes vos pages. C’est toute l’installation.
Le snippet dit seulement quel widget charger : votre espace et votre formulaire. Tout le reste (apparence, pages où le widget apparaît, règles d’affichage) est lu depuis Nudge à chaque chargement de page. Quand vous modifiez un réglage dans l’app et le publiez, votre site le prend en compte de lui-même, en quelques minutes. Vous ne recollez jamais le code.
Avant de commencer
- Un espace Nudge. La mise en route crée le formulaire conversationnel sur lequel tourne le widget. Le widget appartient toujours à un formulaire.
- Un accès au code de votre site, ou aux réglages de « code personnalisé » de votre outil de création de site.
- Une formule ou un essai actif. Sans cela, le snippet ne charge rien (voir Vérifier l’installation).
Le snippet
Il ressemble à ceci, avec votre espace et votre formulaire à la place des deux valeurs :
<script src="https://app.asknudge.ai/widget/loader.js"
data-org="your-workspace"
data-form="your-form" async></script>| Attribut | Ce que c’est |
|---|---|
src | Le chargeur Nudge. Toujours https://app.asknudge.ai/widget/loader.js. |
data-org | L’identifiant de votre espace, celui de l’adresse de l’app (app.asknudge.ai/w/votre-espace). |
data-form | L’identifiant du formulaire que le widget affiche. |
async | Laisse votre page se charger sans attendre le widget. Gardez-le. |
Copiez toujours le snippet depuis l’app plutôt que de le taper : il contient alors les bonnes valeurs.
Où le copier
Le même snippet est proposé à plusieurs endroits de l’app. Prenez le plus proche :
- Mise en route, dernière étape : Installez l’agent sur votre site. Choisissez votre outil, copiez le code et vérifiez l’installation depuis le même écran.
- Agents › Website Agent › Sur votre site : sur la ligne Widget, cliquez sur Copier le snippet.
- Agents › Website Agent › Personnaliser (l’écran Apparence) : la carte Code d’installation, avec Copier le code.
- Paramètres › Intégrations › Site web : choisissez WordPress, Webflow, Framer, Google Tag Manager ou Code à coller. Chacun affiche le snippet avec le chemin à suivre dans l’outil.
- Formulaires › votre formulaire › Partager : le Code d’intégration de ce formulaire, avec son Lien direct.
Où le coller
Collez le snippet une seule fois, dans le code commun à toutes vos pages :
- juste avant la balise de fermeture
</body>, ou - dans la zone « code personnalisé » ou « code de pied de page » de votre outil.
La fin de la balise <head> fonctionne aussi : le widget attend que la page soit prête.
Puis publiez votre site. La plupart des outils n’exécutent le code personnalisé que sur le site publié, pas dans leur éditeur ni dans l’aperçu.
Collez-le une seule fois
Ne collez pas le snippet page par page, ni deux fois dans la même page (par exemple dans le thème et dans une extension). Une seule copie dans le code commun suffit.
Mode intégré (inline)
Par défaut, le widget est la barre de chat en bas de la page et ne prend aucune place dans votre mise en page. Si un formulaire utilise le mode d’affichage Intégration en ligne, le snippet s’accompagne d’un conteneur : placez le div à l’endroit de la page où le formulaire doit apparaître.
<div data-nudge-embed></div>
<script src="https://app.asknudge.ai/widget/loader.js"
data-org="your-workspace"
data-form="your-form" async></script>L’app ajoute elle-même le div au snippet copié quand le formulaire utilise ce mode.
Guides pas à pas
Framer
Site Settings › General › Custom Code.
Webflow
Project settings › Custom code › Footer code.
WordPress
Votre thème, ou une extension qui insère du code.
Google Tag Manager
Une balise HTML personnalisé sur toutes les pages.
Autres plateformes
HTML, Next.js et React, Shopify, Wix, Squarespace…
Formulaire de RDV
Ajoutez le formulaire de RDV à votre page Contact.
Après l’installation
- Ouvrez une fois une page de votre site publié, dans une fenêtre de navigateur normale.
- De retour dans l’app, cliquez sur Revérifier l’installation. Le statut passe à En ligne dès qu’une page de votre site a chargé le widget.
Détails, statuts et solutions aux problèmes courants : Vérifier l’installation.
Si votre site envoie une Content Security Policy, elle peut bloquer le widget tant que vous n’autorisez pas Nudge : voir Content Security Policy (CSP).
Bon à savoir
- Un site, un domaine. Installez le snippet sur le site que vous avez donné à Nudge pendant la mise en route. Le chat est rattaché à ce site (avec ou sans
www). Pour faire tourner le widget sur un autre domaine, contactez le support. - Où il s’affiche. Pour masquer le widget sur certaines pages (paiement, espace client…), ajoutez des motifs d’URL dans Où il apparaît, sur l’écran Apparence. Inutile de retirer le snippet de ces pages.
- Les anciens snippets fonctionnent toujours. Les snippets copiés avant la version actuelle (avec
?v=5ou des attributs de design commedata-color) fonctionnent encore. Les réglages enregistrés dans l’app priment sur ces attributs. - Rien à mettre à jour. Nudge déploie les mises à jour du widget de son côté. Votre snippet reste le même.