Aller au contenu

Documentation

Configurez un agent, entraînez-le sur vos contenus et ajoutez-le à votre site.

Sommaire

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. 1

    Créer un agent

    Créez un compte, ouvrez Agents et choisissez New agent.

  2. 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. 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. 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. 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.

HTML
<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.

HTML
<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.

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://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. 1

    Dans l'administration WordPress, allez dans Extensions → Ajouter.

  2. 2

    Recherchez intochat.ai, puis installez et activez l'extension.

  3. 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. 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. 2

    Dans le dossier Layout, ouvrez theme.liquid.

  3. 3

    Collez le script juste avant la balise de fermeture </body> et enregistrez.

layout/theme.liquid
<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é.

HTML
<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 :

URL
https://www.intochat.ai/agent/YOUR_AGENT_ID

Attributs 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.

AttributObligatoireDescription
data-chatbot-idOuiL'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.

SourceDétails
Site webSaisissez une URL, puis choisissez quelles pages trouvées sur ce site lire. Jusqu'à 500 pages sont trouvées par exploration.
FichiersPDF, Word, PowerPoint, Excel, OpenDocument, RTF, EPUB, CSV, texte brut et Markdown.
TexteTout texte collé, comme une politique ou une description de produit.
Questions-réponsesDes 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éclencheurComportement
ManuelUniquement lorsque le visiteur demande à être contacté ou propose ses coordonnées.
IAL'agent décide quand demander, d'après votre description d'un bon lead.
RèglesAprès un nombre défini de messages du visiteur, ou lorsqu'il emploie l'un de vos mots-clés (jusqu'à 20).
HybrideRè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.