Integrazione nel Sito - Incorpora il Bot ConvyAI nel tuo Sito Web
Panoramica
Dopo aver creato un connettore web chat, genera uno snippet HTML e includilo nelle pagine del tuo sito in cui vuoi che il bot appaia. Lo snippet carica l'interfaccia web chat di ConvyAI e la collega al bot configurato.
Generare lo snippet HTML
Nelle impostazioni del connettore, clicca Generate HTML snippet.

Configura le seguenti opzioni prima di generare:
| Opzione | Descrizione |
|---|---|
| Interface | Il tema visivo o il layout da usare per il widget chat. |
| Bot language | La lingua in cui il bot comunicherà con il cliente. |
| Bot version | Seleziona la versione dell'interfaccia. La versione 2021 espone opzioni comportamentali aggiuntive (vedi sotto). |
Clicca il pulsante verde per generare lo snippet, poi incollalo nel <head> o prima del tag </body> della pagina HTML.
Comportamenti versione 2021
Quando è selezionata la versione 2021, diventano disponibili le seguenti opzioni comportamentali:
| Opzione | Descrizione |
|---|---|
| Autostart conversation | Avvia automaticamente la conversazione quando lo script viene caricato nella pagina, senza attendere che il cliente clicchi il pulsante di engagement. |
| Autostart delay | Da usare insieme ad Autostart conversation. Imposta un ritardo in millisecondi tra il caricamento dello script e l'avvio della conversazione. |
| Hide engagement button | Nasconde il pulsante di engagement. Richiede Autostart conversation abilitato oppure un'integrazione personalizzata tramite il Web SDK. |
| Fullpage bot | L'interfaccia del bot occupa l'intera pagina. Adatto per totem o installazioni kiosk. |
| Include on load | Include l'UI del bot automaticamente al caricamento della pagina. Se disabilitato, l'UI viene iniettata solo quando lo script viene caricato dinamicamente. |
Lo snippet generato ha questa forma:
<script
type="text/javascript"
src="https://your-instance.example.com/convy/static/include_v2/interfaces/CustomerGUI2021/includeConvyAI_v1.js?rnd=xxxxxxxxxx&publicationId=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx&lang=en&ui=xxxxxxxxxx">
</script>
| Parametro | Descrizione |
|---|---|
rnd | Token casuale generato alla creazione dello snippet. Non modificare. |
publicationId | Identificatore univoco della pubblicazione web chat. |
lang | Codice lingua per l'interfaccia del bot (es. en, it). |
ui | Identificatore interno del tema di interfaccia selezionato. |
fullpage | Impostare a true per abilitare la modalità fullpage. Omettere o impostare a false per il widget standard. |