Clienti

Anagrafica clienti — campi standard e personalizzati, creazione manuale, importazione CSV/XLSX, deduplicazione, unione record, esportazione e cancellazione GDPR.

L'area Clienti è l'anagrafica unificata del tenant: collega le conversazioni, le prenotazioni e i documenti a una singola scheda persona o azienda.

ConsoleClienti

Prima di iniziare

Permesso console:customers:read per consultare le schede
Permesso console:customers:write per creare, modificare e importare
Permesso console:customers:delete per la cancellazione definitiva
Base giuridica documentata per il trattamento dei dati importati

Campi standard

Scheda cliente

Parametro	Tipo	Obblig.	Default	Descrizione
`nome`	`string`	Sì	—	Nome della persona fisica. Da 2 a 60 caratteri.
`cognome`	`string`	Sì	—	Cognome della persona fisica. Da 2 a 60 caratteri.
`email`	`string`	Sì	—	Indirizzo email principale. Univoco nel tenant, usato per la deduplicazione.
`telefono`	`string`	No	—	Numero in formato E.164, ad esempio +393331234567.
`ragioneSociale`	`string`	No	—	Denominazione aziendale per i clienti business.
`partitaIva`	`string`	No	—	P.IVA italiana: 11 cifre, con o senza prefisso IT. Validata con algoritmo di controllo.
`codiceFiscale`	`string`	No	—	Codice fiscale a 16 caratteri per le persone fisiche, 11 cifre per gli enti.
`indirizzo`	`oggetto`	No	—	Via, numero civico, CAP, comune, provincia (sigla a 2 lettere), nazione ISO 3166-1 alpha-2.
`consensoMarketing`	`booleano`	No	`false`	Consenso all’invio di comunicazioni commerciali, con data e origine.
`consensoProfilazione`	`booleano`	No	`false`	Consenso alla profilazione, con data e origine.
`lingua`	`string`	No	`it`	Lingua preferita per le comunicazioni, codice ISO 639-1.
`note`	`string`	No	—	Annotazioni interne, non visibili al cliente.
`tag`	`array`	No	—	Etichette per segmentazione, ad esempio cliente-vip o pubblica-amministrazione.

Consensi tracciabili

Ogni consenso registra data, ora, origine (widget, importazione, operatore) e testo dell'informativa accettata. Non modificare manualmente un consenso salvo richiesta scritta dell'interessato: vedi Conformità.

Campi personalizzati

ConsoleConfigurazioneClientiCampi personalizzati

Crea il campo

Indica etichetta, chiave tecnica (minuscolo, senza spazi, ad esempio codice_paziente) e tipo: testo, numero, data, booleano, elenco a scelta singola o multipla.

Imposta le regole

Definisci obbligatorietà, valore predefinito, espressione di validazione e visibilità per ruolo. I campi marcati riservati sono visibili solo ai ruoli con permesso console:customers:read_sensitive.

Usa il campo

Il campo compare nella scheda cliente, nei filtri, nelle importazioni e nelle API. La chiave tecnica è quella da usare nell'intestazione del CSV.

Limiti

Ogni tenant può definire fino a 50 campi personalizzati. Le chiavi tecniche non sono modificabili dopo la creazione, perché usate da importazioni e integrazioni.

Creazione manuale

ConsoleClientiNuovo cliente

Compila i campi obbligatori

Inserisci nome, cognome ed email. Per i clienti business compila anche ragione sociale e partita IVA.

Registra i consensi

Seleziona i consensi effettivamente raccolti e indica l'origine. Non attivare consensi in assenza di prova documentale.

Salva e verifica i duplicati

Al salvataggio la Console segnala eventuali schede simili. Scegli Crea comunque oppure Unisci al record esistente.

Importazione CSV/XLSX

ConsoleClientiImportaCarica file

Prepara il file

Usa la codifica UTF-8, separatore virgola, prima riga di intestazione. Dimensione massima 20 MB, fino a 50.000 righe per importazione.

Carica e mappa le colonne

La Console propone una mappatura automatica basata sui nomi delle intestazioni. Correggi le associazioni errate e ignora le colonne non necessarie.

Scegli la strategia sui duplicati

Ignora (salta la riga), Aggiorna (sovrascrive i campi valorizzati), Crea sempre (sconsigliata). La chiave di confronto predefinita è l'email.

Esegui l'anteprima

L'anteprima mostra le prime 20 righe elaborate e l'elenco degli errori di validazione. Correggi il file e ricarica finché l'anteprima non è pulita.

Conferma l'importazione

Al termine ricevi un riepilogo con righe importate, aggiornate, saltate e un file di scarto CSV con il motivo di ogni errore.

Intestazione esatta del file e riga di esempio:

clienti-import.csv

nome,cognome,email,telefono,ragione_sociale,partita_iva,codice_fiscale,indirizzo_via,indirizzo_cap,indirizzo_comune,indirizzo_provincia,indirizzo_nazione,lingua,consenso_marketing,consenso_profilazione,tag,codice_paziente
Mario,Rossi,mario.rossi@acme.it,+393331234567,ACME S.r.l.,IT01234567890,RSSMRA80A01H501U,Via Roma 12,00184,Roma,RM,IT,it,true,false,"cliente-vip;fatturazione",PZ-00417

Modello di intestazione CSV

nome,cognome,email,telefono,ragione_sociale,partita_iva,codice_fiscale,indirizzo_via,indirizzo_cap,indirizzo_comune,indirizzo_provincia,indirizzo_nazione,lingua,consenso_marketing,consenso_profilazione,tag

Aggiungi in coda le chiavi tecniche dei tuoi campi personalizzati.

Mappatura colonna → campo

Colonna CSV	Campo	Formato atteso
`nome`	Nome	Testo, 2–60 caratteri
`cognome`	Cognome	Testo, 2–60 caratteri
`email`	Email	Indirizzo valido, minuscolo
`telefono`	Telefono	E.164 con prefisso internazionale
`ragione_sociale`	Ragione sociale	Testo libero
`partita_iva`	Partita IVA	11 cifre, prefisso `IT` facoltativo
`codice_fiscale`	Codice fiscale	16 caratteri alfanumerici o 11 cifre
`indirizzo_via`	Indirizzo → Via	Testo libero
`indirizzo_cap`	Indirizzo → CAP	5 cifre
`indirizzo_comune`	Indirizzo → Comune	Testo libero
`indirizzo_provincia`	Indirizzo → Provincia	Sigla a 2 lettere maiuscole
`indirizzo_nazione`	Indirizzo → Nazione	ISO 3166-1 alpha-2, ad esempio `IT`
`lingua`	Lingua	ISO 639-1
`consenso_marketing`	Consenso marketing	`true` oppure `false`
`consenso_profilazione`	Consenso profilazione	`true` oppure `false`
`tag`	Tag	Valori separati da punto e virgola
`codice_paziente`	Campo personalizzato	Secondo le regole definite

Excel e i numeri di telefono

Se prepari il file in Excel, formatta come testo le colonne telefono, partita_iva, codice_fiscale e indirizzo_cap: altrimenti gli zeri iniziali e il prefisso + vengono persi al salvataggio in CSV.

Deduplicazione e unione

ConsoleClientiDuplicati

Il rilevamento dei duplicati confronta, in ordine: email esatta, telefono normalizzato, partita IVA, e infine somiglianza fonetica di nome e cognome con lo stesso CAP.

Apri la coda dei duplicati

L'elenco raggruppa le schede sospette con un punteggio di somiglianza da 0 a 100. Sopra 90 la corrispondenza è quasi certa.

Scegli il record principale

Seleziona la scheda da mantenere. È di norma la più completa o la più recente.

Risolvi i conflitti campo per campo

Per ogni campo divergente scegli il valore da conservare. I consensi seguono sempre la regola più restrittiva tra i record uniti.

Conferma l'unione

Conversazioni, prenotazioni, documenti e note dei record secondari vengono trasferiti al record principale. L'operazione è registrata nell'audit log.

L'unione non si annulla

Dopo la conferma i record secondari non sono ripristinabili. Esporta le schede coinvolte prima di procedere se hai dubbi.

Storico del cliente

Aprendo una scheda trovi, nel pannello a destra, la cronologia completa:

Scheda	Contenuto
Conversazioni	Tutte le sessioni collegate, con esito e operatore
Prenotazioni	Appuntamenti passati e futuri, se il modulo prenotazioni è attivo
Documenti	File caricati o classificati e associati al cliente
Consensi	Storico completo di rilascio e revoca con data e origine
Attività	Modifiche alla scheda con attore e timestamp

Esportazione

ConsoleClientiEsporta

L'esportazione applica i filtri attivi e produce un CSV o XLSX con le stesse intestazioni usate per l'importazione: il file esportato può quindi essere reimportato dopo le correzioni.

L'esportazione è un trattamento

Ogni esportazione di dati personali è registrata nell'audit log con attore, filtri applicati e numero di record. Conserva i file esportati su supporti aziendali cifrati ed eliminali quando non servono più.

ConsoleClientiApri schedaAzioniCancella dati personali

Azione	Effetto	Reversibile
Disattiva	La scheda non compare più nelle ricerche operative	Sì
Anonimizza	Sostituisce i dati identificativi con valori pseudonimi, conserva le statistiche	No
Cancella definitivamente	Elimina scheda, conversazioni collegate, allegati e consensi	No

La procedura completa per rispondere a una richiesta di cancellazione, accesso o portabilità è descritta in Diritti dell'interessato.

Obblighi di conservazione

Documenti fiscali e contabili restano soggetti agli obblighi di conservazione previsti dalla normativa italiana anche dopo la cancellazione dell'anagrafica. La cancellazione non si estende ai dati necessari all'adempimento di obblighi di legge.