Download

Collezione Postman, specifica OpenAPI, kit del logo, template CSV, modello di informativa e checklist di go-live.

Materiali pronti all'uso per accelerare integrazione, avvio e adempimenti. Tutte le risorse sono aggiornate a ogni rilascio: verifica sempre di usare l'ultima versione.

Elenco delle risorse

Risorsa	Formato	A chi serve	Aggiornamento
Specifica OpenAPI	JSON	Sviluppatori e system integrator	A ogni rilascio
Collezione Postman	JSON	Sviluppatori	A ogni rilascio
Ambiente Postman	JSON	Sviluppatori	A ogni rilascio
Kit del logo	ZIP (SVG, PNG, EPS)	Marketing e comunicazione	Su variazione dell'identità visiva
Template CSV importazione clienti	CSV	Amministratori e uffici operativi	A ogni variazione dei campi
Modello di informativa privacy	DOCX	DPO e uffici legali	Su variazione normativa
Checklist di go-live	PDF	Responsabili di progetto	Trimestrale
Modello di dichiarazione di accessibilità	DOCX	Pubblica Amministrazione	Annuale

Specifica OpenAPI

Specifica OpenAPI (sempre aggiornata)

https://api.blupantheon.com/openapi.json

Documento OpenAPI 3.1 con tutti gli endpoint pubblici, schemi ed esempi.

Descrive l'intera superficie pubblica delle API: percorsi, parametri, schemi delle richieste e delle risposte, codici di errore e requisiti di autenticazione.

Importa la specifica nel tuo strumento

Postman, Insomnia, Bruno e la maggior parte dei client REST importano direttamente dall'URL, senza scaricare il file.

Genera un client tipizzato

Generazione di un client TypeScript

npx openapi-typescript https://api.blupantheon.com/openapi.json \
  --output ./src/types/blupantheon.d.ts

Integra la validazione nella tua pipeline

Confronta la specifica corrente con quella usata dal tuo client: le differenze segnalano in anticipo modifiche che potrebbero richiedere un intervento.

Versionamento

La specifica riflette sempre la versione in produzione. Le funzioni deprecate sono marcate con deprecated: true e riportano la data di rimozione nella descrizione. Vedi Changelog.

Collezione Postman

https://docs.blupantheon.com/download/blupantheon-postman-collection.json

Richieste pronte all'uso per tutti gli endpoint principali, con esempi.

Ambiente Postman

https://docs.blupantheon.com/download/blupantheon-postman-environment.json

Variabili preconfigurate: URL di base, chiave API, slug del tenant.

Importa collezione e ambiente

In Postman usa Import e incolla i due URL, uno alla volta.

Configura le variabili di ambiente

Seleziona l'ambiente Blu Pantheon e compila:

Variabile	Obbligatoria	Default	Descrizione	Esempio
`baseUrl`	Sì	`https://api.blupantheon.com`	URL di base delle API. Non modificarlo se non usi un ambiente dedicato.	`https://api.blupantheon.com`
`apiKey`	Sì	—	Chiave API con gli ambiti necessari. Impostala come variabile di tipo secret.	`bp_live_7f3a...`
`tenantSlug`	Sì	—	Slug del tuo tenant, visibile in Amministrazione, Impostazioni tenant.	`acme-srl`
`projectKey`	No	—	Chiave pubblica del progetto, per le chiamate relative al widget.	`pk_live_acme_srl_7f3a`

Esegui la richiesta di verifica

La cartella 00 - Verifica contiene una chiamata di controllo: se restituisce 200, la configurazione è corretta.

Esplora le cartelle tematiche

Le richieste sono organizzate per area: autenticazione, contatti, sessioni, progetti, knowledge base, webhook, fatturazione, audit.

Non condividere l'ambiente con la chiave dentro

Se esporti l'ambiente Postman per condividerlo, la chiave API viene esportata con esso. Usa il tipo secret per la variabile e azzerala prima di qualsiasi esportazione.

Kit del logo

Kit del logo Blu Pantheon

https://docs.blupantheon.com/download/blupantheon-logo-kit.zip

Logo in SVG, PNG e EPS, versioni positiva e negativa, monocromatica e a colori.

Contenuto dell'archivio:

Struttura del kit

/svg/          versione vettoriale, preferita per il web
/png/          formato raster a 1x, 2x e 3x, con sfondo trasparente
/eps/          formato per la stampa
/favicon/      icone per browser e dispositivi mobili
linee-guida.pdf  spazi di rispetto, dimensioni minime, usi non consentiti

Regole d'uso essenziali:

rispetta lo spazio di rispetto minimo indicato nelle linee guida;
non modificare proporzioni, colori o composizione del marchio;
non applicare effetti, ombre o contorni;
su fondi scuri usa la versione negativa;
la dimensione minima di leggibilità è 24 pixel di altezza per il web.

Uso del marchio

Il kit è destinato all'indicazione del rapporto commerciale, per esempio nella pagina “Tecnologie” o “Partner” del tuo sito. Per usi promozionali congiunti o comunicati stampa scrivi a support@blupantheon.com.

Template CSV per l'importazione clienti

Template CSV importazione clienti

https://docs.blupantheon.com/download/template-importazione-clienti.csv

File di esempio con intestazione corretta e tre righe dimostrative.

Riga di intestazione esatta da rispettare:

Intestazione del file di importazione

nome;cognome;email;telefono;ragione_sociale;partita_iva;codice_fiscale;indirizzo;cap;citta;provincia;paese;id_esterno;consenso_marketing;consenso_data;etichette;note

Esempio di riga valorizzata:

Esempio di riga

Mario;Rossi;mario.rossi@acme.it;+393401234567;ACME S.r.l.;IT01234567890;RSSMRA80A01F205X;Via Roma 12;20121;Milano;MI;IT;CRM-0042;true;2026-01-15;cliente;premium;Contratto attivo dal 2025

Descrizione dei campi

Parametro	Tipo	Obblig.	Default	Descrizione
`nome`	`string`	Sì	—	Nome della persona. Massimo 100 caratteri.
`cognome`	`string`	Sì	—	Cognome della persona. Massimo 100 caratteri.
`email`	`string`	No	—	Indirizzo email. Almeno uno fra email e telefono è obbligatorio.
`telefono`	`string`	No	—	Numero in formato E.164 con prefisso internazionale.
`ragione_sociale`	`string`	No	—	Denominazione dell’azienda di appartenenza.
`partita_iva`	`string`	No	—	Con prefisso del Paese, es. IT01234567890.
`codice_fiscale`	`string`	No	—	16 caratteri per le persone fisiche, 11 cifre per le persone giuridiche.
`indirizzo`	`string`	No	—	Via e numero civico.
`cap`	`string`	No	—	Codice di avviamento postale.
`citta`	`string`	No	—	Comune.
`provincia`	`string`	No	—	Sigla della provincia, due lettere maiuscole.
`paese`	`string`	No	`IT`	Codice ISO 3166-1 alfa-2.
`id_esterno`	`string`	No	—	Identificativo nel tuo CRM. È la chiave di correlazione consigliata.
`consenso_marketing`	`boolean`	No	`false`	Valori ammessi: true oppure false. true significa consenso concesso.
`consenso_data`	`string`	No	—	Data di raccolta del consenso in formato AAAA-MM-GG. Obbligatoria se consenso_marketing è true.
`etichette`	`string`	No	—	Elenco separato da virgola. Racchiudi il campo fra virgolette se contiene virgole.
`note`	`string`	No	—	Nota interna. Massimo 500 caratteri.

Requisiti tecnici del file:

Requisito	Valore
Separatore di campo	Punto e virgola
Codifica	UTF-8 con BOM, per la compatibilità con Excel
Terminatore di riga	CRLF
Delimitatore di testo	Virgolette doppie, obbligatorie se il valore contiene il separatore
Righe massime per file	10.000
Dimensione massima	10 MB

ConsoleConsoleClientiImporta da CSV

Scarica e compila il template

Non modificare l'ordine né il nome delle colonne dell'intestazione.

Carica il file e verifica l'anteprima

La Console mostra le prime 20 righe interpretate e segnala le anomalie prima dell'importazione.

Scegli la strategia sui duplicati

Le opzioni sono: ignorare le righe già presenti, aggiornare i record esistenti, oppure interrompere in caso di duplicato.

Conferma e scarica il rapporto

Al termine ricevi un rapporto con righe importate, aggiornate e scartate, con il motivo dello scarto per ciascuna.

Il consenso non si presume

Importare contatti con consenso_marketing valorizzato a true senza disporre di una prova documentata del consenso è una violazione. Se non hai la prova, importa con false e raccogli il consenso attraverso i canali previsti.

Modello di informativa privacy

https://docs.blupantheon.com/download/modello-informativa-privacy.docx

Documento modificabile con le sezioni relative al trattamento tramite la piattaforma.

Il modello copre le sezioni tipicamente rilevanti quando usi Blu Pantheon: identità del Titolare, tipologie di dati raccolti tramite l'assistente conversazionale, finalità, basi giuridiche, destinatari e sub-responsabili, tempi di conservazione, diritti dell'interessato e modalità di esercizio, trasferimenti extra-UE.

È un modello, non un documento pronto

Il modello va completato e adattato al tuo specifico trattamento: i campi da personalizzare sono evidenziati. Non costituisce consulenza legale: fallo validare dal tuo DPO o dal tuo consulente prima della pubblicazione. Vedi GDPR.

Checklist di go-live

https://docs.blupantheon.com/download/checklist-go-live.pdf

Documento di due pagine con tutte le verifiche prima dell'attivazione in produzione.

Copre otto aree, con voci di controllo e spazio per firma e data:

Area	Esempi di verifica
Configurazione	Progetto pubblicato, prompt di sistema definito, comportamento di ripiego configurato
Contenuti	Knowledge base completa, documenti obsoleti rimossi, serie di domande di test superata
Canali	Widget installato su tutte le pagine, domini autorizzati, CSP aggiornata
Integrazioni	Webhook collaudati, firma verificata, endpoint monitorati
Accessi	Ruoli assegnati, MFA attiva, account di emergenza verificato
Conformità	Informativa pubblicata, consensi attivi, retention configurata, DPA sottoscritto
Operatività	Orari e code definiti, operatori formati, escalation documentata
Monitoraggio	Alert configurati, contatti tecnici e di sicurezza aggiornati

Usala come verbale

Compilata e firmata, la checklist è il documento che attesta la corretta messa in esercizio. È utile in sede di audit interno e nei progetti con la Pubblica Amministrazione.

Modello di dichiarazione di accessibilità

https://docs.blupantheon.com/download/modello-dichiarazione-accessibilita.docx

Per i soggetti obbligati ai sensi della Legge 4/2004, secondo il modello AgID.

Include la sezione tecnica relativa a Blu Pantheon: livello di conformità dichiarato, metodologia di valutazione, limitazioni note con motivazione e alternative disponibili, meccanismo di feedback. Dettagli in Accessibilità.