Integra un Chatbot IA su il tuo sito web

Incorporamento nel Sito Web

Questo è il metodo universale per aggiungere il tuo chatbot a qualsiasi sito web. Basta incollare due brevi righe nell'HTML del tuo sito: un tag <script> che carica il widget e un elemento <web-chat-agent> che specifica quale chatbot mostrare. Tutto qui, il pulsante di chat mobile apparirà nell'angolo di ogni pagina in cui viene eseguito il codice.

Se utilizzi WordPress, TYPO3, Shopify, Wix, Squarespace o Webflow, consulta la guida dedicata alla tua piattaforma, che mostra esattamente dove incollare questo stesso codice.

Dove trovare il tuo ID del chatbot

Non è necessario digitare l'ID a mano. Nella dashboard di WebChatAgent:

  1. Apri il tuo chatbot.
  2. Vai su Canali → Widget di chat ed espandi Mostra dettagli di installazione.
  3. Fai clic sul pulsante copia nel riquadro del codice.

Lo snippet copiato contiene già il tuo ID del chatbot, quindi basta incollarlo. (Se hai bisogno dell'ID non elaborato da solo, corrisponde alla stringa lunga nell'URL della dashboard: /dashboard/<your-chatbot-id>.)

Il codice da incollare

Incolla questo codice appena prima del tag di chiusura </body> del tuo sito:

<script src="https://webchatagent.com/widget/web-chat-agent.js" async></script>
<web-chat-agent chatbot-id="YOUR_ID"></web-chat-agent>

Sostituisci YOUR_ID con il tuo ID del chatbot (oppure, per semplicità, copia lo snippet pronto dalla dashboard in modo che l'ID sia già inserito). Il widget si carica in modo asincrono, evitando di rallentare la pagina, e appare come un pulsante di chat mobile nell'angolo inferiore.

Attributi opzionali

Il widget recupera i colori, il titolo, il messaggio di benvenuto e il comportamento dalle impostazioni della dashboard, quindi normalmente è necessario solo chatbot-id. Per sovrascrivere alcune opzioni direttamente nell'HTML, aggiungi questi attributi all'elemento <web-chat-agent>:

  • chatbot-id, Il tuo ID del chatbot. Obbligatorio.
  • theme, Stile visivo: "default" o "modern". Il valore predefinito è "default".
  • initially-open, Imposta su "true" per aprire la chat automaticamente al caricamento della pagina. Il valore predefinito è "false" (chiusa).
  • tracking-consent, Segnale di consenso opzionale per la personalizzazione persistente: "unknown", "denied" o "granted". Se omesso, il valore predefinito è "unknown" e i trigger locali anonimi continuano a funzionare.
  • context-data, Contesto di sessione dalla pagina per l'IA (ad es. "Customer=Acme GmbH;OrderID=A-1023"), utile quando il widget è eseguito all'interno di un CRM o di un'area riservata. Formati, limiti e note sulla sicurezza sono disponibili nella guida per sviluppatori.
<web-chat-agent
  chatbot-id="YOUR_ID"
  theme="modern"
  initially-open="false"
></web-chat-agent>

Tutto il resto, ovvero colore del brand, avatar, font, posizione e comportamento, viene configurato in Canali → Widget di chat, senza dover modificare nuovamente il codice per cambiare lo stile del widget. La personalità dell'assistente viene configurata in Impostazioni → Stile di risposta e ruolo.

Il widget non aggiunge un secondo banner dei cookie. Senza un segnale di consenso viene eseguito in Privacy Mode anonima: i trigger di tempo, scorrimento, intenzione di uscita, inattività, URL, visibilità e rage-click vengono elaborati localmente in memoria. Il riconoscimento dei visitatori di ritorno, i contatori persistenti, le analisi proattive e i saluti generati dall'IA attendono un segnale granted.

Consulta Consenso sui cookie e trigger proattivi anonimi per la matrice completa dei comportamenti, gli esempi di CMP e la documentazione sull'archiviazione.

Incorporare la chat all'interno della pagina

Lo snippet precedente genera un pulsante mobile. Se preferisci posizionare la chat all'interno del layout della pagina, ad esempio come pannello di chat completo in una pagina di supporto dedicata, utilizza il widget integrato. Questo carica uno script e un elemento diversi:

<script src="https://webchatagent.com/widget/chat-widget-inline.js" async></script>
<web-chat-agent-inline chatbot-id="YOUR_ID"></web-chat-agent-inline>

La chat integrata viene visualizzata esattamente nel punto in cui inserisci l'elemento, quindi posizionala all'interno del contenitore desiderato. Consulta la guida alla Chat integrata per i dettagli sul layout.

Funziona ovunque

Entrambi gli snippet sono costituiti da semplice HTML e da un custom element, quindi funzionano su qualsiasi piattaforma per siti web: WordPress, TYPO3, Shopify, Wix, Squarespace, Webflow e siti HTML/JS personalizzati. Incolla il codice nell'HTML del tuo sito e pubblica.

Risoluzione dei problemi

  • Il widget non compare? Assicurati che il codice si trovi nell'HTML della pagina (prima di </body>) e di aver pubblicato le modifiche o svuotato la cache di eventuali plugin. Controlla nella console del browser se sono presenti script bloccati.
  • Viene visualizzato solo su una pagina? Inserisci lo snippet in una posizione valida a livello globale (footer o codice globale) e non su una singola pagina.