Importare Dati

BladeCRM ti permette di importare contatti e aziende da diverse fonti: file CSV/Excel, HubSpot, Google Contacts.

Accesso all'Import

Vai su Importa nel menu laterale per accedere alla pagina di importazione unificata.

Metodi di Import

1. Import da File (CSV/Excel)

Importa contatti da file CSV o Excel.

Preparare il File

Il file deve avere:

• Prima riga: Nomi delle colonne (header)
• Righe successive: Dati
• Formato: CSV (separato da virgola/punto e virgola) o Excel (.xlsx)

Esempio CSV:

nome,cognome,email,telefono,azienda
Mario,Rossi,mario@esempio.it,+39 123 456 7890,Acme Srl
Anna,Bianchi,anna@test.com,+39 098 765 4321,Tech Corp

Processo di Import

1. Carica il file

   • Clicca Scegli file o trascina il file
   • Formati: .csv, .xlsx, .xls
   • Max 10 MB

2. Mappa i campi

   • BladeCRM suggerisce automaticamente la mappatura
   • Verifica e correggi se necessario
   • Ogni colonna del file → campo BladeCRM

   Colonna File	Campo BladeCRM
   nome	Nome
   cognome	Cognome
   email	Email
   telefono	Telefono
   azienda	Azienda

3. Gestione duplicati Scegli come gestire i duplicati (basati su email):

   • Salta: Non importa record con email esistente
   • Aggiorna: Sovrascrivi dati esistenti

4. Anteprima

   • Verifica i primi record
   • Controlla la mappatura
   • Identifica errori

5. Importa

   • Clicca Importa
   • Attendi il completamento
   • Visualizza il riepilogo

2. Import da HubSpot

Importa contatti e aziende direttamente da HubSpot.

Connettere HubSpot

1. Dalla pagina Import, sezione Integrazioni CRM
2. Clicca Connetti HubSpot
3. Autorizza l'accesso (OAuth)
4. Verrai reindirizzato a BladeCRM

Importare da HubSpot

1. Clicca sulla card HubSpot (mostra "Connesso")
2. Seleziona cosa importare:
   • Contatti: Persone
   • Aziende: Companies
3. Visualizza l'anteprima dei record
4. Cerca per trovare record specifici
5. Seleziona i record da importare:
   • Checkbox singole
   • "Seleziona tutti" per tutti i record
6. Configura gestione duplicati
7. Clicca Importa selezionati

TIP

Per importare tutti i record HubSpot, usa "Seleziona tutti" e poi "Importa selezionati".

3. Import da Google Contacts

Importa i tuoi contatti Google.

Connettere Google

1. Dalla pagina Import, sezione Integrazioni CRM
2. Clicca Connetti Google Contacts
3. Autorizza l'accesso (OAuth)
4. Seleziona l'account Google

Importare da Google

1. Clicca sulla card Google Contacts
2. Visualizza i contatti disponibili
3. Seleziona i contatti da importare
4. Configura mappatura campi
5. Clicca Importa

Nota

Google Contacts non ha un concetto di "Azienda" separato. Il campo azienda viene importato nel contatto.

Mappatura Campi

Mappatura Automatica

BladeCRM riconosce automaticamente campi comuni:

Nomi riconosciuti	Campo BladeCRM
nome, first_name, firstname	Nome
cognome, last_name, lastname, surname	Cognome
email, e-mail, mail	Email
telefono, phone, tel	Telefono
cellulare, mobile, cell	Cellulare
azienda, company, società	Azienda
ruolo, title, job_title, posizione	Titolo
sito, website, url	Sito Web
indirizzo, address	Indirizzo
città, city	Città
cap, zip, postal_code	CAP

Mappatura Manuale

Per campi non riconosciuti:

1. Nella colonna "Campo BladeCRM"
2. Seleziona il campo corretto dal dropdown
3. Oppure seleziona "Non importare" per saltare

Campi Personalizzati

Se hai creato campi personalizzati:

1. Appaiono nel dropdown di mappatura
2. Seleziona il campo personalizzato appropriato
3. Il dato verrà importato in quel campo

Gestione Duplicati

Identificazione

BladeCRM identifica i duplicati basandosi su:

• Email (campo primario)
• Opzionalmente: Nome + Cognome + Telefono

Opzioni

Opzione	Comportamento
Salta	Il record esistente non viene modificato
Aggiorna	I campi del record esistente vengono sovrascritti

Quando Usare

• Salta: Prima importazione, dati già puliti
• Aggiorna: Sincronizzazione periodica, dati aggiornati

Anteprima e Validazione

Controlli Automatici

Prima dell'import, BladeCRM verifica:

• ✅ Email valide (formato corretto)
• ✅ Telefoni validi (formato base)
• ✅ Campi obbligatori compilati
• ⚠️ Duplicati identificati

Errori Comuni

Errore	Soluzione
Email non valida	Correggi nel file e ricarica
Campo obbligatorio mancante	Aggiungi i dati mancanti
Formato data errato	Usa formato GG/MM/AAAA
Encoding errato	Salva file come UTF-8

Anteprima Righe

Puoi vedere le prime 10-20 righe:

• Verifica che i dati siano corretti
• Controlla che la mappatura sia giusta
• Identifica problemi prima dell'import completo

Processo Import

Durante l'Import

1. I record vengono elaborati in background
2. Vedi una barra di progresso
3. Puoi navigare altrove (l'import continua)

Al Termine

Ricevi un riepilogo:

• ✅ Record importati con successo
• ⚠️ Record saltati (duplicati)
• ❌ Record con errori
• 📊 Tempo impiegato

Storico Import

In Importa → Storico vedi tutti gli import effettuati:

• Data e ora
• Origine (file, HubSpot, Google)
• Conteggi
• Possibilità di vedere dettagli

Best Practices

Prima dell'Import

• ✅ Pulisci i dati nel file sorgente
• ✅ Rimuovi duplicati evidenti
• ✅ Standardizza i formati (date, telefoni)
• ✅ Verifica l'encoding (UTF-8)
• ✅ Testa con un piccolo campione prima

Preparazione File

✅ Buon file CSV:
nome,cognome,email,telefono
Mario,Rossi,mario@test.it,+39 02 1234567
Anna,Bianchi,anna@demo.com,+39 333 9876543

❌ Problemi comuni:
- Celle unite in Excel
- Formule invece di valori
- Caratteri speciali non UTF-8
- Righe vuote intermedie

Dopo l'Import

• ✅ Verifica un campione di record importati
• ✅ Controlla la mappatura dei campi
• ✅ Esegui ricerca duplicati
• ✅ Completa dati mancanti manualmente

Troubleshooting

Il file non viene caricato

• Verifica il formato (.csv, .xlsx)
• Controlla la dimensione (max 10 MB)
• Prova un browser diverso

Caratteri strani dopo l'import

• Il file non è in UTF-8
• Risalva il file con encoding UTF-8
• In Excel: Salva con nome → CSV UTF-8

Campi non mappati correttamente

• Usa nomi colonna standard
• Mappa manualmente nel passaggio di mappatura
• Verifica che i campi personalizzati esistano

Import lento

• File molto grandi richiedono tempo
• L'import avviene in background
• Riceverai notifica al termine

---

Suggerimento

Per import grandi (>5000 record), considera di dividere il file in parti più piccole per un controllo migliore.