Démarrage rapide : votre première réponse en 5 minutes
De rien à un chat sur votre site qui répond à partir de votre propre contenu, avec des sources.
1. Créez un agent et donnez-lui des connaissances (2 minutes)
- Inscrivez-vous. Votre espace de travail est créé pour vous.
- Cliquez sur New agent, puis sur Knowledge › Add source et saisissez l'URL de votre site web. Vérifiez les pages trouvées, décochez celles que vous ne voulez pas, puis confirmez. Vous pouvez aussi importer des fichiers (PDF, DOCX, TXT, MD, CSV), coller du texte ou ajouter des paires de questions-réponses.
- Les réponses commencent à fonctionner dès que les premières pages sont lues. Vous n'avez pas à attendre le site entier.
Essayez avant d'intégrer : l'aperçu à côté des paramètres de l'agent est le vrai chat. Posez-lui une question à laquelle votre site répond, et vous verrez la réponse avec ses sources. Les réponses de l'aperçu sont gratuites.
2. Autorisez votre domaine et mettez en ligne (1 minute)
Dans les Settingsde l'agent, sous Allowed domains, ajoutez les domaines sur lesquels le chat peut apparaître, par exemple example.com. Utilisez *.example.com pour les sous-domaines. Le navigateur refuse d'afficher le chat partout ailleurs.
Activez ensuite le commutateur Live en haut à droite de l'agent.
3. Collez une ligne (1 minute)
L'onglet Add to your website de l'agent vous guide en cinq étapes (modèle, apparence, emplacement, code, vérification). L'étape du code vous donne une ligne. Ajoutez-la avant </body> sur chaque page qui doit afficher le chat :
<script src="https://widget.onetype.ai/v1/embed.js" data-agent="YOUR_AGENT_ID" defer></script>Rechargez votre page. Le lanceur apparaît dans le coin. Cliquez dessus et posez votre première question. La réponse s'affiche progressivement, avec ses sources.
Le chargeur pèse moins de 3 Ko et ne charge le chat que lorsqu'un visiteur le survole, le sélectionne ou l'ouvre.
4. Personnalisez-le
- Apparence : choisissez un modèle (bulle, intégré, page d'aide, palette ⌘K, panneau latéral de documentation) et ajoutez votre logo, votre nom et votre message d'accueil.
- Comportement : sous General, définissez les instructions de l'agent, s'il répond uniquement à partir de vos connaissances (activé par défaut) et ce qui se passe quand il ne sait pas : proposer une personne, recueillir des coordonnées ou s'excuser.
5. Aller plus loin
| Je veux… | Lire |
|---|---|
| Faire arriver les leads et les conversations dans mes systèmes | Webhooks · REST API |
| Interroger mes docs depuis Claude Code ou Cursor | MCP |
| Discuter depuis mon backend, sans le widget | REST API › Discuter depuis votre backend |
Utiliser un framework
Le script d'une ligne fonctionne sur n'importe quel site : HTML statique, WordPress, Webflow, thèmes Shopify, React, Vue, Next.js. Pour les applications monopages, chargez-le une seule fois dans votre layout racine. Le chargeur suit lui-même la navigation côté client, vous n'avez donc pas besoin de le réinitialiser à chaque changement de route.
Le chat ne fonctionne que sur les pages servies en https. Pour les tests, vous pouvez ajouter localhost ou 127.0.0.1 aux Allowed domains ; ceux-ci fonctionnent aussi en http simple.
// Next.js (app/layout.tsx)
import Script from "next/script";
export default function RootLayout({ children }: { children: React.ReactNode })
{
return (
<html lang="en">
<body>
{children}
<Script src="https://widget.onetype.ai/v1/embed.js" data-agent="YOUR_AGENT_ID" strategy="afterInteractive" />
</body>
</html>
);
}Le script d'une ligne fonctionne aujourd'hui dans les applications React et Vue.