Chatbot du site web

Ce qu’il fait

• Parcours scénarisés créés dans Studio : accueil, boutons, questions et capture de leads.
• Réponses IA tirées du contenu publié de votre propre site, payées avec les crédits IA de votre offre. Lorsqu’il n’y a plus de crédits, le bot affiche son message de repli.
• Apparence et déclencheurs : couleurs, image du lanceur et moment d’ouverture, définis par site dans Studio.
• Protection Turnstile lorsque la conversation semble automatisée.
• Leads : les informations qu’un visiteur partage dans une étape de lead arrivent dans Forms & leads → Leads, comme les demandes de formulaire.

Il n’existe pas encore de transfert en direct vers un agent humain.

Sur le site web live

Les chatbots passent en Production à l’intérieur des releases. Lorsque Production est activé et qu’une release signée est live, le chatbot publié répond à de vrais visiteurs, en s’appuyant sur les connaissances des pages de cette release (jusqu’à 5 000 passages). Les modifications faites dans Development n’atteignent les visiteurs qu’avec la prochaine release approuvée.

Tant que Production est désactivé, les adresses du chatbot répondent 404 CP_NOT_FOUND ; avec Production activé mais sans release live, 403 CP_PRODUCTION_LOCKED.

L’ajouter à un site Next.js

1. Affichez le widget une seule fois dans votre layout racine. Il n’a besoin d’aucun jeton : le navigateur parle directement à Atlas, et Atlas n’accepte que l’origine enregistrée de votre site web.

   app/atlas-chat.tsx

   'use client';
   import { AtlasChat } from '@atlas/chat-widget';
   import '@atlas/chat-widget/styles.css';
   import { usePathname } from 'next/navigation';
   
   export function SiteChat() {
     const path = usePathname();
     return (
       <AtlasChat
         apiOrigin="https://delivery.atlas.example"
         environmentId="env_XXXXXXXX"
         botKey="support"
         path={path}
       />
     );
   }

2. Autorisez Atlas dans votre Content-Security-Policy : ajoutez l’origine de l’API Atlas à connect-src et img-src.

3. Utilisez l’identifiant de l’environnement Production dans votre déploiement live, et celui de Development partout ailleurs.

Le paquet du widget est distribué directement aux clients connectés ; il n’est pas encore sur le registre npm public. Sans React, utilisez le client simple createChatClient({ apiOrigin, environmentId, botKey }), qui propose bot(), start(path) et send(…).

Confidentialité

• Les conversations sont liées à un secret aléatoire conservé dans le stockage de session du visiteur. Il n’y a aucun cookie.
• Les informations d’un lead ne sont stockées que lorsque le visiteur les envoie dans une étape de lead.
• Des limites de débit s’appliquent par adresse IP et par conversation ; voir Limites.

À lire ensuite

Travailler avec les leadsPoints de terminaison navigateur