Il widget di chat
Il widget è il componente di chat incorporabile in un sito web: uno script JavaScript che aggiunge un pulsante flottante e una finestra di conversazione collegata alla console operatore, ai chatbot e, se attivo, all'agente Askme AI del tenant.
Ogni widget è una configurazione indipendente (testi, grafica, opzioni di comportamento, CSS) identificata da un token univoco. Uno stesso tenant può creare più widget per gestire, ad esempio, siti o brand diversi.
Che cos'è il widget
Dal punto di vista dell'amministratore, il widget è l'oggetto configurabile in Amministrazione › Widget; dal punto di vista del visitatore del sito, è il pulsante di chat e la finestra che si apre al clic. La configurazione definisce quali funzioni sono attive (code, valutazioni, allegati, ingresso vocale…), i testi mostrati nelle lingue previste, i colori e, per chi ha il permesso adeguato, il CSS personalizzato.
L'elenco dei widget
L'elenco (Amministrazione › Widget) mostra, per ciascun widget, titolo, stato (Attivo/Disattivo) e le azioni disponibili:
| Azione | Effetto |
|---|---|
| Modifica | Apre il wizard di configurazione a 5 passi |
| Visualizza codice | Mostra lo snippet di incorporamento con il token del widget |
| Duplica | Crea una copia con le stesse configurazioni, testi, colori e CSS |
| Elimina | Rimuove definitivamente il widget |
Limiti di licenza
Il numero massimo di widget creabili è determinato dal piano di licenza del tenant. Una volta raggiunto il limite, la creazione di un nuovo widget non è consentita finché non se ne elimina uno esistente o non si aggiorna il piano.
Il wizard in 5 passi
La configurazione di un widget avviene tramite un wizard a cinque passi, ciascuno approfondito in una pagina dedicata:
| Passo | Contenuto | Pagina |
|---|---|---|
| 1. Generale | Titolo, stato, widget padre | Creare un widget |
| 2. Configurazioni | Opzioni di comportamento raggruppate per area | Creare un widget |
| 3. Testi | Stringhe multilingua del widget | Testi del widget e lingue |
| 4. Grafica | Colori, font, dimensione e posizione del pulsante | Personalizzazione grafica |
| 5. CSS | Editor CSS avanzato (permesso dedicato) | CSS personalizzato |
Per ogni passo, se il widget ha un widget padre associato, è possibile scegliere di ereditarne la configurazione invece di definirne una propria: vedi Widget padre e figlio.
Varianti del widget: grafica nuova e classica
Ogni widget può essere pubblicato in una di due varianti grafiche, entrambe correnti e mantenute:
| Variante | Bundle generato | Caratteristiche |
|---|---|---|
| Nuova (default) | askme.chat.widget.js | Accessibilità estesa, editing dei messaggi inviati, effetto di digitazione sullo streaming delle risposte, lingua aggiuntiva (spagnolo) |
| Classica | askmechat.widget.js | Grafica precedente, funzionalità di base equivalenti |
La scelta tra le due varianti si effettua nel passo Configurazioni del wizard (vedi Creare un widget) e determina automaticamente quale file JavaScript viene incluso nello snippet di incorporamento.
Le varianti storiche del widget (bundle distinti dai due sopra, distribuiti in passato con nomi diversi da quello del modulo corrente) non sono più mantenute e non ricevono aggiornamenti. I siti che le utilizzano ancora devono essere migrati verso la variante nuova o classica descritte sopra.