Personalizzazione AVA - Configura Deployment, Layout e Sicurezza in ConvyAI
Panoramica
La sezione Personalizzazione definisce come AVA viene distribuito e presentato agli utenti finali. Ogni connector collega AVA a un bot specifico, applica il branding visivo, configura le restrizioni di sicurezza e genera lo snippet HTML usato per incorporare o accedere all'istanza.
Vai su AVA → Personalizzazione.
Crea un connector
Clicca sul pulsante +. Appare un form con tre sezioni: configurazione base, Layout e Sicurezza.

Configurazione base
| Campo | Descrizione |
|---|---|
| Nome | Un nome univoco per questo connector. |
| Bot | Il bot ConvyAI da usare per questa istanza AVA. |
| Interfaccia AVA | Il template di interfaccia AVA da applicare. |
| URL personalizzato | Un percorso URL personalizzato opzionale per accedere a questo deployment AVA. |
Layout
La sezione Layout controlla la presentazione visiva e le opzioni di interazione di questo connector.
| Campo | Descrizione |
|---|---|
| Display name | Il nome mostrato agli utenti nell'interfaccia AVA. |
| Logo header | Il logo visualizzato nell'header di AVA. |
| Logo URL | Un URL che punta all'immagine del logo da usare. |
| Mostra input testo | Se visualizzare il campo di input testuale per i messaggi digitati. |
| Mostra footer | Se visualizzare il footer nell'interfaccia AVA. |
| Traduzioni | Override specifici per lingua delle label dell'interfaccia, per deployment multilingua. |
Quick action
Le quick action sono pulsanti preconfigurati che consentono agli utenti di avviare immediatamente un flusso specifico, senza dover seguire il percorso conversazionale. Vengono visualizzate sia nella pagina di ingresso AVA sia nella barra laterale della chat una volta avviata la conversazione.
| Campo | Descrizione |
|---|---|
| Nome | L'etichetta visualizzata sul pulsante della quick action. |
| Icona | L'icona associata alla quick action. |
| Flow | Il flusso bot avviato quando l'utente clicca il pulsante. |
| Versione | La versione del flusso da usare. |
| Hook | L'hook di ingresso nel flusso da cui parte l'esecuzione. |
Sicurezza
La sezione Sicurezza controlla chi può accedere a questo deployment AVA.
| Campo | Descrizione |
|---|---|
| Domain list | Lista dei domini autorizzati da cui AVA può essere raggiunto. Limita l'accesso cross-origin. |
| IP Whitelisting | Abilita per limitare l'accesso ad AVA a indirizzi IP o range specifici. |
Genera lo snippet HTML
Dopo aver salvato il connector, clicca Genera snippet HTML per ottenere il codice di integrazione per questo deployment AVA.
Appare un dialog con due opzioni:
| Campo | Opzioni | Descrizione |
|---|---|---|
| Lingua | Italiano, Inglese, Custom | La lingua predefinita dell'interfaccia AVA. Seleziona Custom per definire manualmente un codice lingua. |
| Modalità di inclusione | URL, Script | Come AVA viene raggiunto o incorporato. |
La modalità URL genera un link diretto a una pagina AVA ospitata da ConvyAI. Condividi o linka questo URL per dare agli utenti accesso ad AVA senza incorporarlo.
La modalità Script genera uno snippet JavaScript da includere in qualsiasi pagina web. Aggiungi lo snippet nell'HTML prima del tag di chiusura </body>:
<script type="text/javascript"
src="https://<dominio>/ava/static/ava/includeAVA_v1.js?rnd=<token>&connectorId=<id>&lang=<lang>">
</script>
| Parametro | Descrizione |
|---|---|
rnd | Token casuale per il cache-busting. |
connectorId | Identificatore univoco del connector. |
lang | Codice lingua per l'interfaccia AVA (es. en, it). |