Installare sul sito

Una volta indicizzato il tuo agente, aggiungerlo al sito è un solo tag script. Trova il tuo snippet in Widget → Script.

Lo snippet di incorporamento

Incolla questo subito prima del tag di chiusura </body> in ogni pagina dove vuoi mostrare il widget di chat:

<script
  src="https://botchata.net/api/widget.js"
  data-api-key="YOUR_KEY"
  data-api-url="https://botchata.net/api"
  defer
></script>

Il widget si carica in modo asincrono (defer) e non rallenta la pagina. Viene reso all'interno di uno Shadow DOM, quindi non può entrare in conflitto con il CSS del tuo sito.

Istruzioni per piattaforma

Piattaforma	Dove incollare
WordPress	Appearance → Theme File Editor → `footer.php`, prima di `</body>` (o un plugin per script header/footer)
Shopify	Online Store → Themes → Edit code → `theme.liquid`, prima di `</body>`
Wix	Settings → Custom Code → Add Custom Code → «Body - end»
Squarespace	Settings → Advanced → Code Injection → Footer
Webflow	Project Settings → Custom Code → Footer Code
Tilda	Impostazioni sito → Altro → Codice HTML per `<body>`
HTML personalizzato	Direttamente prima di `</body>` nel tuo template

Aggiungi lo script a ogni pagina (di solito nel footer/template condiviso), non solo alla home, così il widget è disponibile ovunque.

Verifica che sia attivo

Ricarica il sito — la bolla di chat dovrebbe apparire in basso a destra.

Non la vedi? Visualizza il sorgente della pagina (Ctrl+U) e verifica che il tag script sia presente e che data-api-key non sia vuoto. Controlla la console del browser per errori e assicurati che lo script non sia bloccato da un blocco contenuti.

Passare l'identità del visitatore (facoltativo)

Se il tuo sito sa già chi è il visitatore (è loggato), passa il suo nome ed email così il bot lo saluta per nome e precompila i moduli di contatto e prenotazione:

<script
  src="https://botchata.net/api/widget.js"
  data-api-key="YOUR_KEY"
  data-api-url="https://botchata.net/api"
  data-user-name="Mario Rossi"
  data-user-email="mario@example.com"
  defer
></script>

Renderizza questi attributi lato server dal tuo sistema di autenticazione. I valori vengono passati all'IA come contesto di visitatore identificato.

Persistenza della sessione

Il widget ricorda la conversazione di ogni visitatore per 48 ore (per browser). Quando torna o naviga verso un'altra pagina, la conversazione precedente e la cronologia dei messaggi vengono ripristinate automaticamente.

Le sessioni sono memorizzate nel localStorage del browser, separate per chiave API — quindi se esegui più di un bot sulla stessa pagina, le loro conversazioni non si mescolano mai. Il visitatore può sempre ricominciare con il pulsante «Nuova conversazione» nell'intestazione del widget.

Più bot su una pagina

Puoi inserire più di uno script widget sulla stessa pagina (es. un bot vendite e uno supporto), ciascuno con la propria data-api-key. Funzionano in modo indipendente e mantengono conversazioni separate.

Elimina il tag script dal tuo template. Il widget scompare al successivo caricamento della pagina — non c'è altro da ripulire.