Blu Pantheon
Introduzione

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.com

Aggiungi 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 fareProdottoDove si trova
Rispondere a un cliente in chat in tempo realeConsoleSessioni → Conversazioni
Mettere la chat sul sito aziendaleBluBotConfigurazione → Widget builder
Cambiare modello AI o prompt di sistemaConsoleConfigurazione → Modelli AI
Caricare manuali, listini, regolamentiGeneraFAQKnowledge base → Data store
Invitare un collega e dargli un ruoloIdentityTenant → Utenti
Attivare MFA o SSO aziendaleIdentityTenant → Sicurezza
Vedere fatture e consumiBillingFatturazione → Documenti
Prendere appuntamenti da chat o da sportelloBookingPrenotazioni → Agenda
Inviare eventi al CRM aziendaleConsoleConfigurazione → Webhook
Automatizzare operazioni via codiceAPIVedi 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

Percorso di una conversazione
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 / ticketing

Da dove continuare

In questa pagina