Manuale Askme Chat

Askme Chat — Versione 1.8.8

---

Il Prodotto

Cos'è Askme Chat

Askme Chat è un sistema completo di instant messaging con intelligenza artificiale avanzata a supporto dei processi aziendali (commerciale/presales, assistenza clienti, ecc.). Integra modelli LLM (Large Language Model) per fornire risposte naturali e intelligenti basate su knowledge base personalizzabili. Supporta chat anonime o con utenti riconosciuti, sia con operatore umano che con bot automatico dotato di intelligenza artificiale.

La piattaforma consente una connessione diretta con gli utenti, costruendo relazioni e rispondendo in modo efficiente alle loro domande. Tutte le conversazioni sono archiviate automaticamente e possono essere convertite in Richieste di assistenza su Askme Desk con pochi passaggi.

---

Accesso e interfaccia

Login

Il login supporta tre meccanismi di autenticazione:

Metodo	Descrizione
Basic Authentication	Inserimento diretto di username e password locali
LDAP	Accesso con le credenziali del dominio aziendale
OAuth2 (Keycloak)	Autenticazione tramite provider esterno

---

Homepage

Dopo il login viene visualizzata la homepage con:

Lista chatbot

• Tutti i bot configurati con data di creazione e nome
• Indicatore di integrazione AskMeAI
• Pulsante "Prova chatbot" per testare il bot direttamente dalla homepage

Menu azioni rapide per ogni chatbot:

• Modifica Knowledge Base: accesso diretto alla configurazione AskMeAI
• Visualizza statistiche: link alle metriche del chatbot
• Configurazione: accesso alle impostazioni

Altre sezioni

• Askme Suite: collegamenti ai prodotti correlati
• Gestione licenza: stato, scadenze e accesso agli upgrade

---

Inbox (area operatori)

Gli operatori gestiscono le chat dall'inbox. L'interfaccia mostra:

• Chat in attesa di presa in carico
• Chat assegnate all'operatore corrente
• Campo di digitazione con predictive interaction (vede cosa scrive l'utente)
• Pannello destro con dettagli cliente: IP, browser, cronologia pagine visitate

Azioni disponibili per ogni chat:

• Inviare allegati
• Aggiungere tag
• Trasferire a un'altra categoria
• Passare a un altro operatore
• Chiudere la conversazione

---

Archivio

Nell'archivio sono conservate tutte le chat chiuse. È possibile ricercare per:

Filtro	Descrizione
ID	Identificativo univoco della chat
Nome chat	Denominazione assegnata
Categoria	Coda di lavorazione
Canale	Widget, Telegram, WhatsApp
Operatore	Assegnatario o partecipante
Stato	Aperta, chiusa, ecc.
Tag	Etichette associate
Data creazione	Periodo temporale
Valutazione	Punteggio lasciato dall'utente
Lingua	Lingua della conversazione

Il dettaglio di ogni chat mostra: IP, categoria, date di creazione/presa in carico/chiusura, consenso privacy, canale, lingua, durata, conversazione completa ed eventi browser.

Azioni disponibili (menu tre puntini nel dettaglio):

• Rinominare la chat
• Esportare l'intera conversazione
• Esportare i dati del cliente
• Bloccare l'indirizzo IP
• Associare tag
• Eliminare la chat

---

Reportistica

I report mostrano metriche per singolo operatore o di alto livello:

• Filtro temporale in alto a destra
• Filtri per categoria, operatore e stato
• Ogni grafico è esportabile in formato CSV

Tipologie di report disponibili:

• Report statistici
• Report andamentali
• Report valutazione del servizio
• Report performance per operatori

---

Monitor

Il monitor visualizza in tempo reale:

• Chat in attesa
• Chat attive
• Numero di operatori online

Cliccando su "Mostra dettagli" vengono visualizzati tutti i chatbot con i relativi dati di dettaglio.

---

Impostazioni

Da questa schermata ogni utente configura le preferenze personali:

Impostazione	Descrizione
Notifiche	Abilita/disabilita notifiche browser per nuove chat e messaggi
Ordinamento chat	Criterio di ordinamento nell'inbox
Lingua	Lingua dell'interfaccia dell'applicazione

Clicca Salva per applicare le modifiche.

---

Amministrazione

La sezione Amministrazione raccoglie tutte le funzionalità di configurazione della piattaforma, accessibili dal menu laterale.

---

Categorie

Le categorie sono le code di lavorazione delle chat. Ogni categoria rappresenta un canale tematico (es. "Supporto Tecnico", "Vendite", "Preventivi") che l'utente seleziona all'avvio della conversazione.

Creare una categoria

1. Vai su Amministrazione → Categorie
2. Clicca "Inserisci categoria"
3. Compila i campi:

Campo	Descrizione
Titolo	Nome visibile agli utenti nel widget
Colore	Colore associato nell'interfaccia operatore
Icona	Icona identificativa della categoria
Email	Indirizzo email di riferimento (opzionale)
Descrizione	Per uso interno degli operatori (opzionale)

4. Clicca Salva

Configurazione multilingua

Per ogni categoria puoi definire contenuti in più lingue:

1. Apri la categoria esistente
2. Nella sezione Lingue, seleziona la lingua dal menu a tendina
3. Inserisci per ciascuna lingua:
   • Titolo: nome mostrato nel widget
   • Sottotitolo: testo secondario
   • Messaggio fuori orario: testo mostrato fuori dall'orario di servizio

suggerimento

La lingua viene selezionata automaticamente in base alla lingua del browser dell'utente finale.

Orari di servizio

Ogni categoria può avere orari di servizio specifici:

1. Vai su Amministrazione → Orari di servizio
2. Seleziona la categoria da configurare
3. Configura:

Impostazione	Descrizione
Fuso orario	Fuso orario del luogo di riferimento
Giorni e fasce orarie	Orari di apertura per ogni giorno della settimana
Festività	Giorni di chiusura specifici

Fuori dagli orari configurati, il widget mostra automaticamente il messaggio "Fuori orario" impostato nella configurazione multilingua della categoria.

---

Widget

I widget sono i componenti visibili sul sito che gli utenti cliccano per avviare una chat. Ogni widget ha un token univoco da incorporare nel codice HTML del sito.

Creare un widget

1. Vai su Amministrazione → Widgets
2. Clicca "Inserisci widget"

Configura le impostazioni di base:

Campo	Descrizione
Nome	Identificativo interno del widget
Categoria	Coda di lavorazione a cui viene associato
Token	Generato automaticamente, identifica il widget nel codice HTML

Tab Aspetto (Grafica)

Nel tab Aspetto personalizza l'aspetto visivo del widget:

Impostazione	Descrizione
Tema colore	Colore primario (header, pulsanti, accenti)
Logo	Immagine personalizzata nell'header del widget
Posizione	Destra o sinistra dello schermo
Messaggio di benvenuto	Testo iniziale mostrato all'utente quando apre il widget

Tab Configurazioni

Nel tab Configurazioni definisci:

• I campi del form preChat (dati richiesti all'utente prima di avviare la chat)
• Abilitazione/disabilitazione dell'invio allegati
• Comportamento del widget alla chiusura della chat

Campi preChat disponibili:

• Nome
• Email
• Telefono
• Campi personalizzati aggiuntivi

Tab Testi

Nel tab Testi personalizza tutti i testi mostrati nel widget: titoli, sottotitoli, placeholder dei campi, pulsanti e messaggi di stato.

Il widget supporta più lingue: i testi possono essere configurati separatamente per ogni lingua abilitata.

Tab CSS Personalizzato

Il tab CSS permette di inserire regole CSS aggiuntive per personalizzazioni avanzate dell'aspetto del widget, senza modificare la struttura HTML.

Installazione sul sito

1. Apri il widget creato
2. Clicca "Genera codice"
3. Copia lo snippet HTML generato
4. Incollalo nel tuo sito web prima del tag </body>

<script src="https://[tuo-dominio]/widget.js?token=WIDGET_TOKEN" defer></script>

Plugin WordPress

È disponibile un plugin WordPress dedicato che semplifica l'installazione del widget senza necessità di modificare il codice HTML del tema.

---

Chatbot

I chatbot automatizzano le risposte alle domande frequenti e gestiscono flussi conversazionali strutturati. Possono operare in autonomia completa o in affiancamento agli operatori umani.

Per ogni chatbot nella lista sono disponibili le azioni:

Azione	Descrizione
Modifica	Apre il form di configurazione
Editor	Apre l'editor visuale del workflow
Duplica	Crea una copia del chatbot con le stesse impostazioni
Elimina	Rimuove definitivamente il chatbot

Creare un chatbot

1. Vai su Amministrazione → Chatbot
2. Clicca "Inserisci chatbot"

Compila il form:

Campo	Descrizione
Nome	Identificativo dell'assistente virtuale
Lingua predefinita	Italiano o inglese
Categoria	Coda di lavorazione associata
Attivo	Abilita o disabilita il bot
Consenti concorrenza con operatore	Se attivo, bot e operatore possono rispondere contemporaneamente nella stessa chat

Clicca Salva per creare il chatbot.

Tab Informazioni generali

Le impostazioni principali del chatbot (nome, lingua, categoria, stato, concorrenza) sono configurate nella sezione Informazioni generali.

Se la concorrenza con l'operatore non è consentita, quando un operatore umano entra nella chat il chatbot smette automaticamente di rispondere.

Tab AskMeAI

Il tab AskMeAI configura l'integrazione con l'intelligenza artificiale avanzata (disponibile con licenza che include AskMeAI).

Abilitazione: Attiva l'opzione "Rendi il tuo Chatbot più intelligente grazie all'uso del modello LLM".

Selezione Agente: Seleziona l'agente AskMeAI dal menu a tendina. Ogni agente è associato a una knowledge base specifica con contenuti e configurazioni differenti.

Dettagli Knowledge Base: Dopo la selezione vengono mostrati automaticamente:

• Nome e descrizione della knowledge base
• Elenco dei file PDF utilizzati per l'addestramento
• Lista dei siti web indicizzati

Modalità ibrida: Quando AskMeAI è abilitato, il bot risponde combinando:

1. Intenti configurati (con priorità): risposte strutturate per domande note
2. AI generativa (fallback): risposte naturali dalla knowledge base per qualsiasi altra domanda

Modifica Knowledge Base: Il pulsante "Modifica su AskMeAI" apre l'interfaccia AskMeAI in una nuova finestra per aggiornare contenuti e configurazioni.

Tab Intenti

Gli intenti descrivono le intenzioni degli utenti in una conversazione. Ogni intento è una macro-categoria che raccoglie:

• Tutte le domande che l'utente potrebbe porre su quell'argomento
• Tutte le risposte che il bot deve fornire

Configurazione di un intento:

1. Clicca "Aggiungi intento" e assegnagli un nome (es. "Assistenza tecnica", "Orari di apertura")
2. Tab Domande: inserisci le frasi di esempio che l'utente potrebbe digitare
3. Tab Risposte: inserisci una o più risposte (supporto multilingua: italiano e inglese)

NLP integrato

Anche senza AskMeAI, Askme Chat include un motore NLP interno che riconosce le domande degli utenti e fornisce risposte automatiche basate sugli intenti configurati.

Tab Addestramento

La sezione Addestramento è l'ambiente di test del chatbot:

Pannello sinistro: simula una conversazione digitando domande. Per ogni risposta vengono mostrati:

• Intento riconosciuto
• Lingua
• Percentuale di accuratezza

Soglia di accuratezza minima: percentuale sotto cui il bot mostra un messaggio generico di non comprensione. Si regola trascinando la barra orizzontale.

Gestione errori: se il bot risponde in modo errato, riclassifica manualmente l'intento selezionando quello corretto dal menu a tendina.

Pannello destro: mostra le frasi non classificate, ovvero le domande degli utenti a cui il bot non ha saputo rispondere.

Tab Testi

Definisce i messaggi generici mostrati quando il bot non raggiunge la soglia di accuratezza minima (messaggi di fallback).

Aggiunta lingue

Per aggiungere una lingua al chatbot, aggiungila prima da questo tab tramite il pulsante in alto a destra. Dopo aver selezionato la lingua, salva il chatbot.

Tab Integrazioni

Integrazione Telegram

Accedi da Amministrazione → Integrazioni → Telegram e configura:

Campo	Descrizione
Username Chatbot	Nome utente del bot creato con BotFather su Telegram
Token di accesso API	Token fornito da BotFather
Messaggio di benvenuto	Testo inviato all'utente prima del selettore categoria
Messaggio di chiusura	Testo inviato al termine della chat

Integrazione WhatsApp Business

Accedi da Amministrazione → Integrazioni → WhatsApp e configura:

Campo	Descrizione
Username Chatbot	Nome utente del bot WhatsApp Business
Account Business Unique Code	Codice identificativo univoco dell'account
Gateway API endpoint	URL dell'endpoint API del gateway
Messaggio di benvenuto	Testo inviato prima del selettore categoria
Messaggio di chiusura	Testo inviato al termine della chat
Categorie abilitate	Selezione delle categorie per cui attivare l'integrazione

Prerequisiti WhatsApp

Per l'integrazione WhatsApp Business sono necessari: un'app Meta con Account WhatsApp Business associato e la registrazione del business code nel gateway Askme Chat. Per questa configurazione è richiesto un intervento del team di supporto Askme.

---

Tags

I tag permettono agli operatori di categorizzare le chat per analisi e reportistica.

Creare un tag

1. Vai su Amministrazione → Tags
2. Clicca "Inserisci tag"
3. Definisci:
   • Nome: es. "Problema risolto", "Vendita completata", "Reclamo"
   • Colore: per riconoscimento visivo rapido nell'interfaccia

Uso durante le chat

Gli operatori aggiungono tag direttamente durante o dopo una conversazione dal pannello laterale dell'interfaccia. I tag associati sono visibili nell'archivio e filtrabili nei report.

---

Campagne

Le campagne inviano messaggi proattivi agli utenti che navigano sul sito, prima che avviino una chat.

Creare una campagna

1. Vai su Amministrazione → Campagne
2. Clicca "Inserisci campagna"
3. Configura:

Campo	Descrizione
Nome	Identificativo interno della campagna
Widget	Widget sul quale la campagna si attiva
Messaggio	Testo del messaggio proattivo inviato all'utente
URL	Pagine dove attivare la campagna (supporta espressioni regex)
Delay	Secondi di attesa dalla navigazione alla pagina prima dell'invio del messaggio
Date di validità	Periodo di attivazione della campagna
Categoria	Coda di lavorazione a cui assegnare le risposte degli utenti

Esempio pratico

Messaggio proattivo su pagina prodotti e prezzi:

• URL: /prodotti|/prezzi
• Delay: 15 secondi
• Messaggio: "Hai domande sui nostri prodotti? Sono qui per aiutarti!"
• Categoria: Vendite

---

Risposte veloci

Le risposte veloci sono template di testo preconfigurati che gli operatori richiamano con una scorciatoia per rispondere velocemente alle domande frequenti.

Creare una risposta veloce

1. Vai su Amministrazione → Risposte veloci
2. Clicca "Inserisci risposta"
3. Compila:

Campo	Descrizione
Shortcode	Codice abbreviato (es. saluto, prezzi, chiusura)
Testo	Contenuto completo della risposta
Categoria	Ambito di utilizzo (opzionale)

Uso durante le chat

Durante una conversazione, l'operatore digita / seguito dallo shortcode. Il sistema mostra un elenco di risposte corrispondenti (autocomplete) e sostituisce automaticamente con il testo completo al momento dell'invio.

---

Orari di servizio

Gli orari di servizio definiscono quando il widget è attivo per ogni categoria. Si configurano separatamente per ogni coda di lavorazione.

1. Vai su Amministrazione → Orari di servizio
2. Seleziona la categoria
3. Configura fuso orario, fasce orarie per giorno della settimana e festività

Fuori dagli orari, il widget mostra il messaggio "Fuori orario" configurato nella sezione multilingua della categoria.

---

Editor Workflow

L'Editor Workflow è lo strumento visuale per creare flussi conversazionali del chatbot. Permette di disegnare la struttura di dialogo come un diagramma a nodi interconnessi.

Come accedere

1. Vai su Amministrazione → Chatbot
2. Sulla riga del chatbot desiderato, clicca "Editor"

Layout dell'editor

Area	Descrizione
Toolbar	Salva, undo/redo, zoom, ricerca nodi, auto-layout
Canvas	Area di lavoro dove si disegna il flusso
Minimap	Anteprima completa del workflow (attivabile in basso a destra)
Pannello Validazione	Errori e warning (attivabile in basso a destra)
Pulsante +	Crea un nuovo nodo

---

Navigazione del canvas

Azione	Metodo
Sposta la vista	Tieni Spazio + trascina, oppure scroll con mouse
Zoom avanti	Ctrl + rotella su, o pulsante +
Zoom indietro	Ctrl + rotella giù, o pulsante -
Reset zoom	Doppio click pulsante zoom, o Ctrl+0
Cerca nodo	Clicca 🔍 nella toolbar, poi digita il testo
Auto-layout	Pulsante account_tree — riordina automaticamente i nodi

---

Creare un flusso

Aggiungere un nodo

Clicca il pulsante + nella toolbar. Il nodo appare al centro della vista corrente.

Configurare un nodo

Fai doppio click sul nodo per aprire il pannello di configurazione. Le impostazioni sono organizzate in quattro tab.

Tab Configurazioni

Messaggio: testo inviato dal bot all'utente. Supporta formattazione rich-text ed emoji.

Comportamento chat — flag selezionabili:

Flag	Effetto
Nodo di partenza	Primo nodo eseguito all'avvio della conversazione (obbligatorio averne uno)
Chiusura chat	Termina la conversazione al raggiungimento di questo nodo
Passa ad operatore	Trasferisce la chat a un operatore umano
Chiudi widget	Riduce il widget a icona lato cliente (dopo 25 secondi)
Nodo silenzioso	Non invia messaggi; usato come nodo tecnico di instradamento del flusso
Disabilita input	L'utente non può digitare quando raggiunge questo nodo
Abilita allegati	Permette il caricamento di file anche se il widget ha la funzione disabilitata globalmente

Tab Opzioni

Definisce come l'utente risponde dopo aver ricevuto il messaggio del nodo.

Tipo	Quando usarlo
Nessuna	Il bot attende testo libero dall'utente
Bottone	Presenta all'utente scelte cliccabili (raccomandato: max 5 opzioni)
Intento	Riconoscimento linguistico tramite NLP (usa gli intenti configurati)
Condizionale	Percorsi diversi in base a condizioni predefinite

Per ogni opzione di tipo Bottone definisci:

• Testo: etichetta visibile all'utente sul pulsante
• Nodo successivo: il nodo verso cui saltare quando l'utente clicca

Tab Variabili

Raccoglie dati dall'utente e li salva come variabili di sessione, utilizzabili nei messaggi degli altri nodi con la sintassi {{nome_variabile}}.

Campo	Descrizione
Nome	Identificativo (es. email, telefono, nome)
Tipo	Costante / Input utente / Selezione singola / Selezione multipla
Validazione	Formato richiesto (vedi lista)
Obbligatorio	Se l'inserimento è obbligatorio

Validazioni disponibili:

Validazione	Formato atteso
Testo	Qualsiasi stringa
Email	Indirizzo email valido
Telefono	Numero di telefono
Numero	Valore numerico decimale
Intero	Numero intero
Valuta	Importo monetario
Data	Formato data
Ora	Formato ora
Data/Ora	Data e ora combinati
Codice Fiscale	CF italiano
Partita IVA	P.IVA italiana
CAP	Codice di avviamento postale
IBAN	Coordinate bancarie internazionali
Carta di credito	Numero carta di credito
URL	Indirizzo web
Pattern (regex)	Espressione regolare personalizzata

Tab Azione

Esegue operazioni automatiche al raggiungimento del nodo (es. apertura ticket su Askme Desk, chiamate a servizi esterni via webhook).

1. Abilita "Esegui azione"
2. Seleziona l'azione dalla lista
3. Configura:

Campo	Descrizione
Esegui immediatamente	L'azione si esegue appena il nodo è raggiunto, senza attendere input utente
Nodo successo	Nodo verso cui andare se l'azione riesce
Nodo errore	Nodo verso cui andare in caso di errore dell'azione

Collegare i nodi

Metodo A — Dalle opzioni del nodo Nella tab Opzioni, seleziona il "Nodo successivo" per ogni bottone. Le frecce di collegamento si creano automaticamente nel canvas.

Metodo B — Trascinamento Trascina il cerchio di connessione (punto di uscita) da un nodo sorgente verso il nodo destinazione.

Salvare il workflow

Clicca Salva nella toolbar. Il sistema:

1. Valida il workflow (controlla presenza di errori)
2. Salva la configurazione
3. Aggiorna il bot con il nuovo flusso

---

Organizzare il workflow

Colori dei nodi

Nelle impostazioni avanzate del nodo, assegna un colore per:

• Raggruppare visivamente i nodi per tema
• Evidenziare punti critici o particolari del flusso
• Facilitare la navigazione in workflow con molti nodi

Titolo del nodo

Nelle impostazioni avanzate, aggiungi un titolo descrittivo che:

• Appare sopra il nodo nel canvas
• Aiuta a distinguere nodi con contenuti simili
• Comparisce nei risultati della ricerca

Sub-workflow

Per flussi molto complessi, è possibile suddividere il bot in chatbot separati collegati tra loro:

1. Crea un chatbot secondario con il suo workflow
2. In un nodo del chatbot principale, seleziona il tipo Sub-workflow
3. Scegli il chatbot secondario da invocare
4. Definisci il nodo di ritorno (dove tornare dopo l'esecuzione del sub-workflow)

---

Validazione

Il pannello di validazione (icona ✓ in basso a destra) segnala:

Tipo	Descrizione	Azione consigliata
Errore	Problema che impedisce il corretto funzionamento	Da correggere prima di salvare
Warning	Possibile miglioramento o caso limite	Consigliato
Info	Suggerimento opzionale	Facoltativo

Errori comuni:

• Nodo orfano (senza connessioni in entrata o in uscita)
• Nodo di partenza mancante
• Opzione che punta a un nodo inesistente o eliminato

Cliccando su un errore, il canvas si posiziona automaticamente sul nodo problematico.

---

Scorciatoie da tastiera

Tasto	Azione
Ctrl + Z	Annulla ultima azione
Ctrl + Y	Ripeti azione annullata
Ctrl + F	Apri ricerca nodi
Spazio (tenuto)	Attiva pan — trascina la vista
Delete	Elimina il nodo selezionato
Ctrl + S	Salva il workflow

---

Best practices

1. Inizia semplice: crea prima un flusso lineare base, poi aggiungi diramazioni
2. Usa i titoli: dai nomi descrittivi ai nodi per orientarti in workflow complessi
3. Colori per tema: usa colori diversi per flussi informativi, raccolta dati, chiusure e successi
4. Fallback sempre presente: per ogni nodo con intenti, definisci sempre un percorso di fallback per le domande non previste
5. Testa spesso: salva e testa dopo poche modifiche per individuare subito i problemi
6. Auto-layout: usa periodicamente il pulsante auto-layout per mantenere il workflow ordinato e leggibile

---

Esempio: flusso base di supporto

[Nodo 1: Benvenuto]  ← Nodo di partenza
  Bottoni:
  ├─ "Ho un problema tecnico"   → [Nodo 2: Raccolta dettagli]
  ├─ "Informazioni sui prezzi"  → [Nodo 3: Invia listino]
  └─ "Parla con un operatore"   → [Nodo 4: Trasferimento]

[Nodo 2: Raccolta dettagli]
  Variabile: descrizione_problema (Input utente)
  ↓ → [Nodo 4: Trasferimento]

[Nodo 3: Invia listino]
  Bottone: "Vuoi sapere altro?"
  ↓ → [Nodo 1: Benvenuto]   ← collegamento di ritorno

[Nodo 4: Trasferimento]
  Flag "Passa ad operatore" attivo

---

Salvataggio automatico

L'editor salva una bozza automatica ogni pochi secondi. Se chiudi accidentalmente la finestra:

1. Riapri l'editor
2. Il sistema chiede se ripristinare la bozza salvata automaticamente
3. Verifica che sia la versione corretta prima di confermare il salvataggio definitivo

---

Gestione Utenti e Team

Utenti

La sezione Amministrazione → Utenti permette di gestire gli operatori e gli amministratori della piattaforma.

[Placeholder immagine: lista utenti con colonne username, nome, ruolo, stato]

Creare un utente

1. Clicca su Nuovo utente
2. Compila i campi:
   • Username: nome utente per il login
   • Nome e Cognome
   • Email: indirizzo email dell'utente
   • Password: password iniziale (min. 8 caratteri)
   • Nickname: nome visualizzato nelle chat
3. Assegna i ruoli (Amministratore, Operatore, ecc.)
4. Assegna le categorie di chat che l'utente può gestire
5. Salva

Ruoli e permessi

I ruoli definiscono le funzionalità accessibili all'utente:

Ruolo	Descrizione
Amministratore	Accesso completo a tutte le funzionalità, configurazione e amministrazione
Operatore	Gestione delle chat nelle categorie assegnate, utilizzo risposte veloci e tag

I permessi specifici includono:

• Accesso alle chat per categoria
• Riassegnazione chat ad altri operatori
• Gestione widget e configurazioni
• Accesso alla reportistica

Profilo operatore

Ogni operatore può personalizzare il proprio profilo da Impostazioni → Profilo:

• Modifica del nickname visualizzato nelle chat
• Caricamento avatar personale
• Cambio password
• Configurazione notifiche personali

Team

I team permettono di organizzare gli operatori in gruppi di lavoro e assegnare categorie di chat a ciascun team.

[Placeholder immagine: configurazione team con assegnazione categorie]

Creare un team

1. Vai su Amministrazione → Team
2. Clicca su Nuovo team
3. Inserisci codice e descrizione
4. Assegna i membri (operatori)
5. Assegna le categorie gestite dal team
6. Salva

Gruppi

I gruppi definiscono insiemi di permessi riutilizzabili. Assegna un gruppo a più utenti per garantire gli stessi permessi in modo uniforme.

---

Blacklist

La sezione Amministrazione → Blacklist permette di bloccare indirizzi IP specifici per impedire l'accesso alla chat.

[Placeholder immagine: lista indirizzi bloccati con stato attivo/disattivo]

Bloccare un indirizzo

1. Clicca su Aggiungi alla blacklist
2. Inserisci l'indirizzo IP da bloccare
3. Inserisci una motivazione (opzionale, utile per riferimento futuro)
4. Salva

Gestione

• Attiva/Disattiva: puoi temporaneamente disattivare un blocco senza eliminarlo
• Elimina: rimuove definitivamente l'indirizzo dalla blacklist

Le connessioni tentate da indirizzi in blacklist vengono registrate automaticamente per il monitoraggio.

---

API Keys

La sezione Amministrazione → API Keys permette di generare e gestire le chiavi di accesso per le API REST di Askme Chat.

Creare una API Key

1. Clicca su Nuova API Key
2. Assegna un nome descrittivo (es. "Integrazione CRM")
3. Salva — la chiave verrà generata automaticamente

Sicurezza

La chiave API viene mostrata una sola volta al momento della creazione. Conservala in un luogo sicuro. Se persa, dovrai generarne una nuova.

Gestione

• Attiva/Disattiva: disattiva temporaneamente una chiave senza eliminarla
• Elimina: revoca definitivamente la chiave

Usa la chiave nell'header X-AskmeToken per autenticarti alle API REST. Per maggiori dettagli consulta la documentazione API.

---

Knowledge Base

La Knowledge Base è l'archivio di articoli e risposte che il chatbot e gli operatori possono consultare durante le conversazioni.

[Placeholder immagine: lista articoli knowledge base con titolo, lingua e tag]

Creare un articolo

1. Vai su Amministrazione → Knowledge Base
2. Clicca su Nuovo articolo
3. Compila:
   • Titolo: titolo dell'articolo
   • Contenuto: testo completo dell'articolo (supporta formattazione)
   • Lingua: lingua dell'articolo (IT, EN, ES, PT)
   • Tag: etichette per la categorizzazione
4. Salva

Gli articoli della Knowledge Base possono essere utilizzati:

• Dagli operatori durante le chat per fornire risposte rapide e accurate
• Dal chatbot per rispondere automaticamente alle domande più frequenti
• Da Askme AI come base di conoscenza per le risposte generative

Askme AI

Per configurare la Knowledge Base basata su siti web e documenti PDF con intelligenza artificiale, consulta la documentazione di Askme AI.

---

Template Email

La sezione Amministrazione → Template Email permette di personalizzare le email inviate automaticamente dalla piattaforma.

Email automatiche disponibili

Template	Descrizione
Trascrizione chat	Email con la trascrizione completa inviata al cliente
Richiesta di contatto	Notifica all'operatore quando un cliente richiede di essere ricontattato
Recupero password	Email per il reset della password
Attivazione account	Email di benvenuto per nuovi utenti

Personalizzare un template

1. Seleziona il template da modificare
2. Personalizza oggetto e corpo dell'email
3. Utilizza le variabili dinamiche disponibili (es. {{nome_utente}}, {{data_chat}})
4. Salva

---

Notifiche

Askme Chat supporta diversi tipi di notifiche per tenere gli operatori sempre aggiornati.

Notifiche browser

Le notifiche desktop vengono inviate quando:

• Arriva una nuova chat nella coda dell'operatore
• Un cliente invia un nuovo messaggio in una chat attiva
• Una chat viene trasferita all'operatore

Per attivarle, consenti le notifiche dal browser alla prima richiesta.

Notifiche push (PWA)

Askme Chat supporta le notifiche push tramite Firebase Cloud Messaging (FCM) per la versione Progressive Web App (PWA):

1. Installa Askme Chat come app dal browser (opzione "Aggiungi alla schermata home")
2. Accetta le notifiche push quando richiesto
3. Riceverai notifiche anche quando la pagina non è aperta in primo piano

Configurazione suoni

Da Impostazioni, ogni operatore può personalizzare:

• Tipo di suono per le notifiche
• Attivazione/disattivazione dei suoni
• Ordinamento delle chat (per data o priorità)

---

Privacy e GDPR

Askme Chat include strumenti per la conformità al GDPR:

Consenso privacy

Il widget chat può essere configurato per richiedere il consenso al trattamento dei dati personali prima di avviare la conversazione. Il consenso viene tracciato con i seguenti stati:

Stato	Descrizione
Accettazione esplicita	L'utente ha esplicitamente accettato il trattamento
Accettazione implicita	L'utente ha accettato implicitamente (es. continuando a usare il servizio)
Non accettato	L'utente non ha fornito il consenso

Cancellazione dati

La funzione Elimina permanentemente (/api/chat/erase/{idChat}) consente di cancellare definitivamente una chat e tutti i dati associati, in conformità con il diritto all'oblio (Art. 17 GDPR).

---

Licenza

La sezione Amministrazione → Licenza mostra le informazioni sulla licenza attiva e le funzionalità abilitate.

Le informazioni visualizzate includono:

• Tipo di piano attivo
• Data di scadenza
• Numero massimo di operatori
• Funzionalità abilitate

Per aggiornare o rinnovare la licenza, contatta il supporto Askme.