Documentation
Configurez un agent, entraînez-le sur vos contenus et ajoutez-le à votre site.
Vue d'ensemble
intoCHAT place sur votre site un agent IA qui répond aux questions des visiteurs à partir des contenus que vous fournissez : pages de votre site, documents et paires de questions-réponses que vous rédigez vous-même.
Vous configurez l'agent dans le tableau de bord et l'installez avec une seule balise script. Les modifications ultérieures de ses connaissances, de ses instructions ou de son apparence atteignent votre site sans retoucher le code.
Démarrage rapide
D'un nouveau compte à un agent opérationnel sur votre site.
- 1
Créer un agent
Créez un compte, ouvrez Agents et choisissez New agent.
- 2
Ajouter des connaissances
Dans l'onglet Knowledge, ajoutez votre site, importez des documents ou collez du texte et des questions-réponses. L'agent répond à partir de ce qu'il y trouve et de ses instructions.
- 3
Copier le code d'intégration
Dans l'onglet Share, copiez la balise script. Elle contient déjà l'identifiant de votre agent.
- 4
L'ajouter à votre site
Collez le script juste avant la balise de fermeture
</body>, sur chaque page où l'agent doit apparaître. - 5
Vérifier
Rechargez votre site. Le bouton de chat apparaît dans le coin inférieur, avec les couleurs et la position définies dans l'onglet Appearance.
<script
src="https://www.intochat.ai/api/embed.js"
data-chatbot-id="YOUR_AGENT_ID"
></script>Comment les réponses sont produites
Lorsque vous ajoutez des connaissances, intoCHAT les découpe en passages et les indexe. Pour chaque question d'un visiteur, les passages les plus pertinents sont récupérés et transmis au modèle de langage avec vos instructions, et le modèle rédige sa réponse à partir de ce contenu.
Si rien de pertinent n'est trouvé, l'agent indique qu'il ne peut pas confirmer la réponse plutôt que de deviner, et propose un moyen de contact si vous en avez configuré un. Votre base de connaissances est traitée comme du contenu de référence, jamais comme des instructions : le texte d'une page ne peut donc pas modifier le comportement de l'agent.
Termes utilisés dans le tableau de bord
- Instructions
- Le rôle, le ton et les limites de l'agent, rédigés simplement. Par exemple : répondre dans la langue du visiteur, rester bref, orienter les questions de facturation vers l'adresse du support.
- Actions
- Des appels à une API HTTP que vous configurez, par exemple pour retrouver une commande, ou des fonctions exécutées sur votre propre page. L'agent n'utilise chacune que pour les demandes auxquelles elle est destinée.
- Collecte de leads
- Un formulaire dans la conversation qui demande une adresse e-mail ou un numéro de téléphone. Voir Collecte de leads pour savoir quand il apparaît.
Balise script
Fonctionne sur tout site dont vous pouvez modifier le HTML, y compris via les réglages de code personnalisé de Webflow, Squarespace et Wix. Ajoutez-la une seule fois, dans un pied de page ou un gabarit global, pour qu'elle se charge sur chaque page.
<script
src="https://www.intochat.ai/api/embed.js"
data-chatbot-id="YOUR_AGENT_ID"
></script>Next.js et React
Dans un projet Next.js avec l'App Router, chargez le script une seule fois dans le layout racine avec next/script. La stratégie lazyOnload le garde hors du chemin de rendu critique.
import Script from 'next/script'
export default function RootLayout({ children }: { children: React.ReactNode }) {
return (
<html lang="en">
<body>
{children}
<Script
src="https://www.intochat.ai/api/embed.js"
data-chatbot-id="YOUR_AGENT_ID"
strategy="lazyOnload"
/>
</body>
</html>
)
}Dans d'autres applications React, comme Vite ou Create React App, ajoutez la balise script à index.html. Elle se charge une fois et reste en place lors des changements de page côté client.
WordPress
Utilisez l'extension officielle, qui ajoute le script à chaque page pour vous : intochat.ai sur WordPress.org
- 1
Dans l'administration WordPress, allez dans Extensions → Ajouter.
- 2
Recherchez intochat.ai, puis installez et activez l'extension.
- 3
Allez dans Réglages → intochat.ai et saisissez l'identifiant d'agent affiché dans l'onglet Share.
Shopify
Ajoutez la balise script à votre thème pour qu'elle se charge sur chaque page de votre boutique.
- 1
Dans l'administration Shopify, allez dans Boutique en ligne → Thèmes, ouvrez le menu de votre thème actif et choisissez Modifier le code.
- 2
Dans le dossier Layout, ouvrez
theme.liquid. - 3
Collez le script juste avant la balise de fermeture
</body>et enregistrez.
<script
src="https://www.intochat.ai/api/embed.js"
data-chatbot-id="YOUR_AGENT_ID"
></script>Intégration dans la page et lien direct
Pour afficher le chat dans une page plutôt que sous forme de bouton flottant, intégrez-le dans une iframe. Les deux extraits figurent aussi dans l'onglet Share, avec l'identifiant de votre agent déjà renseigné.
<iframe
src="https://www.intochat.ai/agent/YOUR_AGENT_ID"
width="100%"
height="600px"
frameborder="0"
></iframe>Lien direct
Chaque agent dispose aussi de sa propre page, que vous pouvez partager sous forme de lien ou de code QR :
https://www.intochat.ai/agent/YOUR_AGENT_IDAttributs du script d'intégration
Le script lit un seul attribut. Tout le reste, comme les couleurs, la position du bouton, l'icône et le message d'accueil, se règle dans l'onglet Appearance et se charge à l'ouverture de la page : les modifications s'appliquent sans toucher à votre site.
| Attribut | Obligatoire | Description |
|---|---|---|
data-chatbot-id | Oui | L'identifiant de l'agent à charger, affiché dans l'onglet Share. |
Sources de connaissances
Ajoutez des sources dans l'onglet Knowledge. Le volume possible dépend de votre offre ; voir Tarifs.
| Source | Détails |
|---|---|
| Site web | Saisissez une URL, puis choisissez quelles pages trouvées sur ce site lire. Jusqu'à 500 pages sont trouvées par exploration. |
| Fichiers | PDF, Word, PowerPoint, Excel, OpenDocument, RTF, EPUB, CSV, texte brut et Markdown. |
| Texte | Tout texte collé, comme une politique ou une description de produit. |
| Questions-réponses | Des paires de questions et de réponses, pour les réponses dont la formulation doit être exacte. |
Collecte de leads
Lorsque la collecte de leads est activée, l'agent peut afficher dans la conversation un formulaire demandant les champs activés : adresse e-mail, numéro de téléphone ou les deux. Le déclencheur détermine quand il apparaît.
| Déclencheur | Comportement |
|---|---|
| Manuel | Uniquement lorsque le visiteur demande à être contacté ou propose ses coordonnées. |
| IA | L'agent décide quand demander, d'après votre description d'un bon lead. |
| Règles | Après un nombre défini de messages du visiteur, ou lorsqu'il emploie l'un de vos mots-clés (jusqu'à 20). |
| Hybride | Règles et IA combinées. |
Le formulaire apparaît au maximum trois fois par conversation, toujours sous la réponse de l'agent. Les coordonnées envoyées apparaissent dans l'onglet Leads.
Besoin d'aide ?
Écrivez à support@intochat.ai en indiquant l'identifiant de votre agent.