Inizi gratis

Guida rapida: la sua prima risposta in 5 minuti

Da zero a una chat sul suo sito che risponde in base ai suoi contenuti, con le fonti.

1. Crei un agente e gli fornisca le conoscenze (2 minuti)

  1. Si registri. Il suo workspace viene creato per Lei.
  2. Clicchi su New agent, poi su Knowledge › Add source e inserisca l'URL del suo sito. Controlli le pagine trovate, deselezioni quelle che non desidera e confermi. Può anche caricare file (PDF, DOCX, TXT, MD, CSV), incollare testo o aggiungere coppie di domande e risposte.
  3. Le risposte iniziano a funzionare non appena vengono lette le prime pagine. Non deve attendere l'intero sito.

Provi prima di incorporare: l'anteprima accanto alle impostazioni dell'agente è la chat reale. Chieda qualcosa a cui il suo sito risponde e vedrà la risposta con le sue fonti. Le risposte dell'anteprima sono gratuite.

2. Autorizzi il suo dominio e vada online (1 minuto)

Nelle Settings dell'agente, sotto Allowed domains, aggiunga i domini su cui la chat può comparire, come example.com. Usi *.example.com per i sottodomini. Il browser rifiuta di mostrare la chat in qualsiasi altro luogo.

Poi attivi l'interruttore Live in alto a destra nell'agente.

3. Incolli una riga (1 minuto)

La scheda Add to your website dell'agente la guida in cinque passi (modello, aspetto, dove, codice, verifica). Il passo del codice le fornisce una riga. La aggiunga prima di </body> su ogni pagina che deve mostrare la chat:

<script src="https://widget.onetype.ai/v1/embed.js" data-agent="YOUR_AGENT_ID" defer></script>

Ricarichi la pagina. Il lanciatore compare nell'angolo. Ci clicchi e ponga la sua prima domanda. La risposta arriva in streaming con le sue fonti.

Il loader pesa meno di 3 KB e carica la chat solo quando un visitatore passa sopra, mette a fuoco o la apre.

4. La personalizzi

  • Aspetto: scelga un modello (bolla, integrata, pagina di aiuto, palette ⌘K, barra laterale della documentazione) e aggiunga il suo logo, il suo nome e il suo messaggio di benvenuto.
  • Comportamento: in General, imposti le istruzioni dell'agente, se risponde solo in base alla sua conoscenza (attivo per impostazione predefinita) e cosa accade quando non sa: proporre una persona, raccogliere dati di contatto o scusarsi.

5. Vada oltre

Voglio…Leggere
Portare lead e conversazioni nei miei sistemiWebhooks · API REST
Interrogare la mia documentazione da Claude Code o CursorMCP
Chattare dal mio backend, senza il widgetAPI REST › Chat dal suo backend

Se utilizza un framework

Lo script di una riga funziona in qualsiasi sito: HTML statico, WordPress, Webflow, temi Shopify, React, Vue, Next.js. Per le app a pagina singola, lo carichi una sola volta nel layout principale. Il loader segue da solo la navigazione lato client, quindi non deve reinizializzarlo a ogni cambio di percorso.

La chat funziona solo sulle pagine servite tramite https. Per i test può aggiungere localhost o 127.0.0.1 ai domini consentiti (Allowed domains); anche questi funzionano con http semplice.

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

Lo script di una riga funziona oggi nelle app React e Vue.