Importazione CSV

Formato del file CSV e processo di importazione contatti.

Formato del file

Il CSV deve avere almeno la colonna email. Le colonne first_name e last_name sono opzionali. Qualsiasi altra colonna viene salvata come metadato del contatto (es. provincia, tipo_contratto, importo_richiesto).

Requisito	Valore
Colonna obbligatoria	email
Colonne opzionali	first_name, last_name
Colonne extra	salvate nei metadata JSONB
Encoding	UTF-8
Separatore	virgola
Prima riga	nomi delle colonne

Esempio CSV

email,first_name,last_name,provincia,tipo_contratto
mario.rossi@example.com,Mario,Rossi,MI,dipendente_pubblico
anna.bianchi@example.com,Anna,Bianchi,RM,pensionato

Processo di importazione

1. Vai su Contatti > Importa CSV
2. Carica il file e seleziona la base giuridica del consenso
3. (Opzionale) Assegna tag ai contatti importati
4. Il sistema valida le email, deduplica e importa

Report post-importazione

Dopo l'importazione il sistema mostra:

• Importati — contatti inseriti con successo
• Duplicati — email già presenti nel tenant (skippate)
• Errori — righe con email non valida o dati mancanti
• Esclusi — contatti con status non attivo (bounce, spam precedente)