Panoramica dell'ecosistema
Come sono organizzati Console, BluBot, Identity, Billing, Booking e GeneraFAQ e come i dati si muovono tra loro.
Blu Pantheon è una piattaforma SaaS multi-tenant per l'automazione conversazionale e la gestione documentale. Non è un prodotto unico: è un insieme di servizi indipendenti che condividono identità, fatturazione e configurazione del tenant.
Questa pagina spiega cosa fa ogni prodotto, chi lo usa e come i dati passano da un servizio all'altro. Leggila prima di iniziare la guida rapida.
I prodotti della piattaforma
Console
L'applicazione web da cui si governa tutto. È il punto di ingresso quotidiano per chi lavora sulla piattaforma.
URL della Console
https://console.blupantheon.comAggiungi il dominio ai preferiti: è l'unico indirizzo di accesso.
Contiene: dashboard operativa, sessioni e conversazioni con presa in carico da parte di un operatore, anagrafica clienti, classificazione documentale, statistiche, configurazione (modelli AI, avatar, progetti, widget builder, flussi conversazionali, strumenti, webhook), knowledge base e data store, membri del tenant, fatturazione e preferenze.
Chi la usa: amministratori di tenant, responsabili di reparto, operatori di front office, team IT.
BluBot
Il widget di chat incorporabile che i visitatori vedono sul sito aziendale. Si installa con un singolo tag script (build UMD) prima della chiusura del body e non richiede framework specifici.
Chi lo usa: i visitatori del sito. Chi lo installa è il webmaster o l'agenzia che gestisce il sito.
Identity Service
Il servizio di autenticazione e autorizzazione: utenti, tenant, ruoli, permessi, sessioni, chiavi API, MFA e SSO. Espone le API sotto /identity/v1 e definisce i permessi nel formato {servizio}:{risorsa}:{azione}, per esempio identity:users:read.
Chi lo usa: indirettamente tutti; direttamente i team IT che integrano SSO o automatizzano il provisioning degli utenti.
Billing Service
Gestisce abbonamenti, piani, consumi e fatture tramite Stripe. Espone in Console lo stato del piano, il metodo di pagamento e lo storico documenti.
Chi lo usa: amministrazione, ufficio acquisti, titolari di studio o azienda.
Booking
Il modulo di prenotazione appuntamenti, progettato sul contesto sanitario italiano: distingue il regime SSN con ricetta elettronica (numero ricetta elettronica e codice fiscale dell'assistito) dal regime privato (listino, disponibilità, acconto). Si integra con l'agente conversazionale per la prenotazione self-service.
Chi lo usa: segreterie di studi medici, poliambulatori, cliniche, sportelli di enti pubblici.
GeneraFAQ
Il motore di knowledge base: acquisizione documenti, parsing con OCR per PDF scansionati, suddivisione in chunk, indicizzazione vettoriale e ricerca semantica. È ciò che permette all'agente di rispondere citando i tuoi contenuti invece di improvvisare.
Chi lo usa: chi cura i contenuti — ufficio qualità, marketing, direzione sanitaria, ufficio protocollo.
Libreria Widgets
Il pacchetto di componenti condivisi usato dalla Console e dalle applicazioni satellite (console mobile, portali dedicati). Garantisce che tabelle, filtri, grafici e form si comportino allo stesso modo ovunque.
Chi la usa: i team di sviluppo che estendono la piattaforma con interfacce personalizzate.
Dove trovo la funzione che mi serve
| Cosa vuoi fare | Prodotto | Dove si trova |
|---|---|---|
| Rispondere a un cliente in chat in tempo reale | Console | Sessioni → Conversazioni |
| Mettere la chat sul sito aziendale | BluBot | Configurazione → Widget builder |
| Cambiare modello AI o prompt di sistema | Console | Configurazione → Modelli AI |
| Caricare manuali, listini, regolamenti | GeneraFAQ | Knowledge base → Data store |
| Invitare un collega e dargli un ruolo | Identity | Tenant → Utenti |
| Attivare MFA o SSO aziendale | Identity | Tenant → Sicurezza |
| Vedere fatture e consumi | Billing | Fatturazione → Documenti |
| Prendere appuntamenti da chat o da sportello | Booking | Prenotazioni → Agenda |
| Inviare eventi al CRM aziendale | Console | Configurazione → Webhook |
| Automatizzare operazioni via codice | API | Vedi documentazione API |
Come si muovono i dati
Il percorso tipico di una richiesta, dal visitatore fino ai sistemi aziendali:
Il visitatore apre la chat
Il tag script di BluBot carica il widget dal CDN e apre una sessione associata al progetto identificato dalla chiave pubblica. La sessione porta con sé lingua, pagina di origine ed eventuali metadati che hai passato nell'inizializzazione.
L'agente AI elabora il messaggio
Il messaggio arriva all'agente configurato sul progetto. L'agente applica il prompt di sistema, i vincoli del modello (temperatura, token massimi) e le regole del flusso conversazionale.
L'agente interroga la knowledge base
Prima di rispondere, l'agente esegue una ricerca semantica sui data store collegati al progetto. Recupera i frammenti più pertinenti e li usa come contesto. Se nessun documento è rilevante, l'agente lo dichiara invece di inventare.
L'agente usa gli strumenti
Se la richiesta lo richiede, l'agente invoca uno strumento: verifica di disponibilità in agenda, apertura di un ticket, lettura di uno stato ordine. Gli strumenti chiamano i tuoi endpoint con autenticazione dedicata.
Eventuale handover a un operatore
Quando la conversazione supera le competenze dell'agente, o quando l'utente lo chiede esplicitamente, la sessione passa in coda in Console. Un operatore la prende in carico e continua a scrivere nella stessa finestra di chat, senza che il visitatore debba ripetere nulla.
Gli eventi raggiungono i sistemi aziendali
Ogni passaggio significativo genera un evento webhook firmato in HMAC verso gli endpoint che hai registrato: creazione sessione, richiesta di handover, chiusura conversazione, caricamento documento, prenotazione confermata. È così che CRM, gestionale o ticketing restano allineati.
Un solo tenant, molti progetti
I dati non attraversano mai il confine del tenant. Progetti, data store, utenti e conversazioni appartengono a un tenant specifico e non sono visibili agli altri. Vedi Concetti fondamentali.
Schema del flusso
Visitatore
│
▼
BluBot (widget sul sito)
│ sessione + messaggio
▼
Agente AI ──► Knowledge base (data store)
│ ──► Strumenti (API aziendali)
│
├──► Risposta automatica al visitatore
│
└──► Handover ──► Console (operatore umano)
│
▼
Webhook firmati HMAC
│
▼
CRM / gestionale / ticketingDa dove continuare
Concetti fondamentali
Tenant, progetto, agente, data store: il vocabolario minimo.
Requisiti e compatibilità
Browser, rete, domini da autorizzare, limiti di piattaforma.
Guida rapida
Dal primo accesso alla pubblicazione del widget in 15 minuti.
Console
Le funzioni operative quotidiane: sessioni, clienti, statistiche.
Configurazione
Modelli AI, avatar, progetti, flussi, strumenti e webhook.
API
Endpoint REST, autenticazione e integrazione applicativa.
Benvenuto in Blu Pantheon
La documentazione ufficiale della piattaforma Blu Pantheon — guide operative, configurazione, automazioni RPA, API e conformità per il mercato italiano.
Concetti fondamentali
Tenant, progetto, agente, sessione, data store, ruoli e permessi: il vocabolario minimo per usare Blu Pantheon.