Vai al contenuto
intoCHAT

Documentazione

Configura un agente, addestralo sui tuoi contenuti e aggiungilo al tuo sito.

Indice

Panoramica

intoCHAT mette sul tuo sito un agente AI che risponde alle domande dei visitatori usando i contenuti che fornisci: pagine del sito, documenti e coppie di domande e risposte scritte da te.

Configuri l'agente nella dashboard e lo installi con un solo tag script. Le modifiche successive a conoscenza, istruzioni o aspetto arrivano sul sito senza dover toccare di nuovo il codice.

Avvio rapido

Da un nuovo account a un agente funzionante sul tuo sito.

  1. 1

    Crea un agente

    Crea un account, apri Agents e scegli New agent.

  2. 2

    Aggiungi la conoscenza

    Nella scheda Knowledge, aggiungi il tuo sito, carica documenti o incolla testo e Q&A. L'agente risponde in base a ciò che trova lì e alle sue istruzioni.

  3. 3

    Copia il codice di incorporamento

    Nella scheda Share, copia il tag script. Contiene già l'ID del tuo agente.

  4. 4

    Aggiungilo al sito

    Incolla lo script subito prima del tag di chiusura </body>, in ogni pagina in cui deve comparire l'agente.

  5. 5

    Verifica

    Ricarica il sito. Il pulsante della chat compare nell'angolo in basso, con i colori e la posizione impostati nella scheda Appearance.

HTML
<script
  src="https://www.intochat.ai/api/embed.js"
  data-chatbot-id="YOUR_AGENT_ID"
></script>

Come vengono prodotte le risposte

Quando aggiungi conoscenza, intoCHAT la suddivide in passaggi e li indicizza. Per ogni domanda di un visitatore vengono recuperati i passaggi più pertinenti, che il modello linguistico riceve insieme alle tue istruzioni e usa per scrivere la risposta.

Se non trova nulla di pertinente, l'agente dice che non può confermare la risposta invece di tirare a indovinare, e indica un contatto se ne hai configurato uno. La tua base di conoscenza è trattata come materiale di riferimento, mai come istruzioni, quindi il testo di una pagina non può cambiare il comportamento dell'agente.

Termini usati nella dashboard

Istruzioni
Ruolo, tono e limiti dell'agente, scritti in linguaggio semplice. Per esempio: rispondere nella lingua del visitatore, essere brevi, indirizzare le domande sulla fatturazione all'indirizzo del supporto.
Azioni
Chiamate a un'API HTTP che configuri, per esempio per cercare un ordine, oppure funzioni eseguite sulla tua pagina. L'agente usa ciascuna solo per le richieste a cui è destinata.
Raccolta lead
Un modulo nella conversazione che chiede un indirizzo email o un numero di telefono. Vedi Raccolta lead per sapere quando compare.

Tag script

Funziona su qualsiasi sito di cui puoi modificare l'HTML, comprese le impostazioni di codice personalizzato di Webflow, Squarespace e Wix. Aggiungilo una volta, in un footer o layout globale, così si carica su ogni pagina.

HTML
<script
  src="https://www.intochat.ai/api/embed.js"
  data-chatbot-id="YOUR_AGENT_ID"
></script>

Next.js e React

In un progetto Next.js con App Router, carica lo script una sola volta nel layout principale con next/script. La strategia lazyOnload lo tiene fuori dal percorso di rendering critico.

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>
  )
}

In altre app React, come Vite o Create React App, aggiungi il tag script a index.html. Si carica una volta e resta attivo durante i cambi di pagina lato client.

WordPress

Usa il plugin ufficiale, che aggiunge lo script a ogni pagina per te: intochat.ai su WordPress.org

  1. 1

    Nell'amministrazione di WordPress, vai su Plugin → Aggiungi nuovo.

  2. 2

    Cerca intochat.ai, poi installa e attiva il plugin.

  3. 3

    Vai su Impostazioni → intochat.ai e inserisci l'ID dell'agente indicato nella scheda Share.

Shopify

Aggiungi il tag script al tuo tema, così si carica su ogni pagina del negozio.

  1. 1

    Nell'amministrazione di Shopify, vai su Negozio online → Temi, apri il menu del tema attivo e scegli Modifica codice.

  2. 2

    Nella cartella Layout, apri theme.liquid.

  3. 3

    Incolla lo script subito prima del tag di chiusura </body> e salva.

layout/theme.liquid
<script
  src="https://www.intochat.ai/api/embed.js"
  data-chatbot-id="YOUR_AGENT_ID"
></script>

Incorporamento in pagina e link diretto

Per mostrare la chat all'interno di una pagina invece che come pulsante flottante, incorporala in un iframe. Entrambi gli snippet sono anche nella scheda Share, con l'ID del tuo agente già inserito.

HTML
<iframe
  src="https://www.intochat.ai/agent/YOUR_AGENT_ID"
  width="100%"
  height="600px"
  frameborder="0"
></iframe>

Link diretto

Ogni agente ha anche una propria pagina, che puoi condividere come link o codice QR:

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

Attributi dello script

Lo script legge un solo attributo. Tutto il resto, come colori, posizione del pulsante, icona e saluto, si imposta nella scheda Appearance e viene caricato all'apertura della pagina, quindi le modifiche valgono senza toccare il sito.

AttributoObbligatorioDescrizione
data-chatbot-idSìL'ID dell'agente da caricare, indicato nella scheda Share.

Fonti di conoscenza

Aggiungi le fonti nella scheda Knowledge. Quanto puoi aggiungere dipende dal piano; vedi Prezzi.

FonteDettagli
Sito webInserisci un URL, poi scegli quali delle pagine trovate su quel sito leggere. Per ogni scansione vengono trovate fino a 500 pagine.
FilePDF, Word, PowerPoint, Excel, OpenDocument, RTF, EPUB, CSV, testo semplice e Markdown.
TestoQualsiasi testo incollato, come una policy o la descrizione di un prodotto.
Q&ACoppie di domande e risposte, per risposte che vuoi formulate esattamente.

Raccolta lead

Con la raccolta lead attiva, l'agente può mostrare nella conversazione un modulo che chiede i campi abilitati: indirizzo email, numero di telefono o entrambi. L'attivazione decide quando compare.

AttivazioneComportamento
ManualeSolo quando il visitatore chiede di essere contattato o offre i propri dati.
AIL'agente decide quando chiedere, in base alla tua descrizione di un buon lead.
RegoleDopo un certo numero di messaggi del visitatore, o quando usa una delle tue parole chiave (fino a 20).
IbridaRegole e AI insieme.

Il modulo compare al massimo tre volte per conversazione, sempre sotto la risposta dell'agente. I dati inviati compaiono nella scheda Leads.

Serve aiuto?

Scrivi a support@intochat.ai indicando l'ID del tuo agente.