Requisiti e compatibilità
Browser supportati, requisiti di rete, domini da autorizzare, parametri del widget e limiti operativi della piattaforma.
Verifica questi requisiti prima di avviare l'attivazione. Gran parte dei problemi segnalati in fase di avvio dipende da proxy aziendali, WebSocket bloccati o browser non aggiornati.
Browser supportati
Sono supportate le ultime due versioni stabili di:
| Browser | Versioni supportate | Note |
|---|---|---|
| Google Chrome | Ultime 2 | Configurazione di riferimento |
| Microsoft Edge | Ultime 2 | Basato su Chromium |
| Mozilla Firefox | Ultime 2 | Incluse le versioni ESR ancora in supporto |
| Apple Safari | Ultime 2 | macOS e iOS |
Internet Explorer non è supportato
La Console e il widget BluBot non funzionano su Internet Explorer, né in modalità compatibilità di Edge. Se in azienda esistono postazioni ancora vincolate a IE, pianifica la migrazione a Edge prima del go-live.
Requisiti del client
| Requisito | Valore minimo | Consigliato |
|---|---|---|
| Risoluzione schermo | 1280 × 720 | 1920 × 1080 |
| JavaScript | Attivo, obbligatorio | — |
Cookie e localStorage | Attivi per il dominio della Console | — |
| Memoria disponibile | 4 GB di RAM | 8 GB di RAM |
| Connessione | 5 Mbit/s in download | 20 Mbit/s in download |
Il widget BluBot è progettato per funzionare anche su smartphone e su schermi stretti: sotto i 768 pixel di larghezza passa automaticamente alla modalità a schermo intero.
Requisiti di rete
Tutto il traffico è in HTTPS sulla porta 443 in uscita. Non è richiesta alcuna apertura in ingresso verso la rete aziendale, salvo che tu esponga endpoint per strumenti o webhook.
Domini da autorizzare su firewall e proxy
| Dominio | Uso | Protocolli |
|---|---|---|
console.blupantheon.com | Interfaccia operativa | HTTPS 443, WebSocket |
api.blupantheon.com | API REST e canale realtime | HTTPS 443, WebSocket |
static.blupantheon.com | Asset statici, script del widget, avatar | HTTPS 443 |
docs.blupantheon.com | Documentazione | HTTPS 443 |
Elenco domini per il ticket IT
console.blupantheon.com, api.blupantheon.com, static.blupantheon.com, docs.blupantheon.comIncolla questo elenco nella richiesta al reparto sistemi.
Direzione: outbound
Protocollo: TCP/443 (HTTPS + WSS)
Destinazioni: *.blupantheon.com
Ispezione TLS: da escludere per api.blupantheon.comWebSocket
Le sessioni in tempo reale — nuove conversazioni, digitazione in corso, handover, notifiche — usano WebSocket (wss://). Se il proxy aziendale non supporta l'upgrade del protocollo, la Console resta utilizzabile ma gli aggiornamenti non arrivano istantaneamente e gli operatori vedono le conversazioni in ritardo.
Proxy aziendali e ispezione TLS
Molti proxy con ispezione TLS sostituiscono il certificato del server e interrompono la connessione WebSocket o bloccano le risposte in streaming dell'agente. Chiedi al reparto sistemi di inserire api.blupantheon.com nella lista di esclusione dall'ispezione TLS. Se l'ispezione è obbligatoria per policy, verifica che il proxy gestisca l'upgrade HTTP/1.1 Upgrade: websocket e le risposte con Transfer-Encoding: chunked.
Parametri di configurazione del widget BluBot
Il widget si configura con un oggetto passato all'inizializzazione. Questi sono i parametri riconosciuti.
| Variabile | Obbligatoria | Default | Descrizione | Esempio |
|---|---|---|---|---|
BP_PROJECT_KEY | Sì | — | Chiave pubblica del progetto da cui il widget eredita agente, modello e knowledge base. | bp_proj_7f3a9c21 |
BP_API_BASE_URL | No | https://api.blupantheon.com | Endpoint delle API. Da modificare solo in ambienti dedicati o on-premise. | https://api.blupantheon.com |
BP_LOCALE | No | it | Lingua iniziale del widget. Se assente viene usata la lingua del browser. | it |
BP_POSITION | No | bottom-right | Posizione della bolla di apertura sullo schermo. | bottom-left |
BP_THEME | No | auto | Tema del widget: chiaro, scuro oppure allineato alle preferenze di sistema. | light |
BP_AUTO_OPEN_DELAY | No | 0 | Millisecondi prima dell'apertura automatica. Il valore 0 disattiva l'apertura automatica. | 20000 |
BP_USER_TOKEN | No | — | Token firmato per identificare un utente già autenticato sul tuo sito e recuperare lo storico conversazioni. | eyJhbGciOi... |
BP_METADATA | No | {} | Metadati liberi allegati alla sessione e visibili agli operatori in Console. | { "pagina": "listino", "canale": "sito" } |
BP_DEBUG | No | false | Attiva i log diagnostici nella console del browser. Da non usare in produzione. | true |
Il dettaglio dell'installazione è in Pubblicazione del widget e nella sezione BluBot.
Limiti operativi
I limiti dipendono dal piano
I valori riportati sotto sono i limiti di riferimento del piano Business. Piani superiori o accordi dedicati possono avere soglie diverse. Il valore effettivo del tuo tenant è sempre visibile in Fatturazione → Piano e consumi.
Documenti e knowledge base
| Limite | Valore di riferimento |
|---|---|
| Dimensione massima per file | 50 MB |
| File caricabili in un'unica operazione | 25 |
| Pagine massime per documento | 1.500 |
| Documenti per data store | 10.000 |
| Data store per tenant | 50 |
| Tempo tipico di indicizzazione | da 30 secondi a 10 minuti per documento |
Formati supportati per la knowledge base:
| Formato | Estensione | Note |
|---|---|---|
.pdf | OCR automatico per le pagine scansionate | |
| Word | .docx | Il formato .doc legacy non è supportato |
| Excel | .xlsx | Una tabella per foglio, con intestazioni sulla prima riga |
| Testo semplice | .txt | Codifica UTF-8 |
| Markdown | .md | Consigliato: la struttura dei titoli migliora il recupero |
| CSV | .csv | Separatore virgola o punto e virgola, UTF-8 |
| HTML | .html | Vengono rimossi script, stili e menu di navigazione |
Piattaforma
| Limite | Valore di riferimento |
|---|---|
| Progetti per tenant | 25 |
| Utenti attivi per tenant | 100 |
| Domini autorizzati per progetto | 20 |
| Endpoint webhook per progetto | 10 |
| Chiavi API attive per tenant | 20 |
| Richieste API | 600 al minuto per chiave |
| Messaggi per sessione | 200 |
| Conservazione delle sessioni | 24 mesi |
| Conservazione dei log di audit | 24 mesi |
| Conservazione degli allegati | 12 mesi |
Verifica rapida prima di iniziare
Controlla il browser
Apri https://console.blupantheon.com da una postazione aziendale reale, non da una connessione mobile personale. Se la pagina di accesso si carica, DNS e certificati sono a posto.
Verifica il canale realtime
Accedi e apri Sessioni. Se l'indicatore di connessione resta in stato di riconnessione, il WebSocket è bloccato: torna al reparto sistemi con l'elenco domini riportato sopra.
Prova un caricamento
Carica un PDF di prova in un data store. Se il caricamento si interrompe, controlla i limiti di dimensione imposti dal proxy in uscita, spesso più bassi di quelli della piattaforma.