Pubblicazione
Incorpora il tuo agente su qualsiasi sito web con il widget JavaScript o iframe.
Pubblica il tuo agente sul tuo sito web in modo che i visitatori possano interagire con esso. Scegli tra un widget di chat fluttuante o un iframe a pagina intera.
Opzioni di incorporamento
Widget di chat (consigliato)
Una bolla di chat fluttuante che si espande in una finestra di chat. Funziona su qualsiasi sito web.
Embedding con iframe
Incorpora l'interfaccia di chat completa in una sezione della pagina. Utile per pagine di supporto dedicate.
Aggiungere il widget di chat
- Vai alla scheda Pubblica del tuo agente
- Copia lo snippet JavaScript
- Incollalo nell'HTML del tuo sito prima di
</body>:
<script src="https://your-domain.com/widget.js" data-chatbot-id="your-chatbot-id" async ></script>
- Aggiorna il tuo sito web: la bolla di chat appare!
Il widget appare come un pulsante fluttuante (di solito in basso a destra). I visitatori cliccano per aprire la chat.
Guide specifiche per piattaforma
Per istruzioni dettagliate su piattaforme specifiche:
- Widget JavaScript: qualsiasi sito web HTML
- React e Next.js: applicazioni React
- WordPress: siti WordPress
- Embedding con iframe: interfaccia di chat integrata
Personalizzazione del widget
Personalizza l'aspetto nella scheda Design:
Colori
- Colore primario (bolla di chat, intestazione)
- Colori d'accento
- Tema chiaro/scuro
Posizione
- In basso a destra (predefinito)
- In basso a sinistra
- Posizionamento personalizzato tramite CSS
Branding
- Messaggio di benvenuto
- Titolo della chat
- Messaggi suggeriti
- Rimuovi il branding "Powered by" (piani Standard/Pro)
Impostazioni di visibilità
Controlla chi può accedere al tuo agente:
| Impostazione | Descrizione |
|---|---|
| Pubblico | Chiunque può usare il widget incorporato |
| Privato | Accessibile solo nel Playground della dashboard |
Configura in Impostazioni > Sicurezza > Visibilità.
Restrizioni di dominio
Limita quali siti web possono incorporare il tuo agente:
- Vai su Impostazioni > Sicurezza
- Trova Domini consentiti
- Aggiungi i domini che possono incorporare il tuo widget
Una volta configurato, il widget si carica solo sui domini approvati. Questo previene l'uso non autorizzato del tuo agente.
Verificare l'incorporamento
Dopo aver aggiunto il codice:
- Visita il tuo sito web in un browser
- Cerca la bolla di chat
- Clicca per aprire la chat
- Invia un messaggio di prova
- Verifica che la risposta sia corretta
Risoluzione dei problemi
Il widget non appare:
- Controlla che il codice di incorporamento sia prima di
</body> - Verifica che l'ID dell'agente sia corretto
- Svuota la cache del browser
- Controlla la console del browser per eventuali errori
Il widget è nella posizione sbagliata:
- Modifica la posizione nelle impostazioni Design
- Controlla la presenza di conflitti CSS
La chat non risponde:
- Assicurati di avere contenuti di addestramento
- Controlla il limite di messaggi del tuo piano
- Prova prima nel Playground
Checklist per il lancio
Prima di annunciare il tuo agente:
- [ ] Testa nel Playground con le domande più comuni
- [ ] Verifica che i contenuti di addestramento siano completi
- [ ] Personalizza l'aspetto per adattarlo al tuo brand
- [ ] Configura le restrizioni di dominio (opzionale)
- [ ] Configura il limite di frequenza per prevenire gli abusi
- [ ] Rivedi le impostazioni di visibilità