Risoluzione dei problemi per l'importazione massiva tramite CSV

INDICE

Cos'è l'importazione massiva?
Principali vantaggi di un'importazione CSV riuscita
Checklist per la risoluzione dei problemi di importazione CSV
Elenco completo dei codici errore per l'importazione massiva
Domande frequenti

Cos'è l'importazione massiva?

L'importazione massiva permette di caricare rapidamente grandi volumi di dati di contatto tramite file CSV. È uno strumento potente per l'onboarding, la migrazione di lead e la sincronizzazione di liste, ma gli errori di formattazione possono bloccare il processo. Questa guida ti aiuta a risolverli.

Questo video spiega come navigare nei log degli errori relativi a un'azione massiva di importazione Contatti e come lavorare sugli errori per risolverli:

Navigare nei log degli errori per le importazioni di Contatti

Principali vantaggi di un'importazione CSV riuscita

Padroneggiare la risoluzione dei problemi di importazione massiva può farti risparmiare tempo ed evitare blocchi frustranti. Ecco perché è importante:

Risparmia tempo riducendo il lavoro ripetitivo
Evita la creazione di record di Contatto duplicati o in conflitto
Mantieni dati di Contatti puliti e validati
Previeni errori di importazione che bloccano l'automazione Workflow
Garantisci un'assegnazione corretta del proprietario/utente
Preserva la personalizzazione Campaign e il tagging

Checklist per la risoluzione dei problemi di importazione CSV

Usa questa checklist prima dell'importazione per prevenire gli errori CSV più comuni:

Un solo foglio nel file
Tutti i campi obbligatori compilati e formattati correttamente
Email, numeri di telefono e date formattati correttamente
ID Contatto univoci per ogni riga
I valori di enumerazione/dropdown corrispondono esattamente alle opzioni esistenti
Email utente HITLEAD valide nella colonna Owner
Scegli una colonna primaria affidabile (come Email o ID Contatto)

Elenco completo dei codici errore per l'importazione massiva

Tipo	ID errore (Opzionale)	Codice errore	Cosa significa l'errore	Come risolvere l'errore
Errori di formattazione nel foglio	1001	Errore sconosciuto	HITLEAD non riesce a elaborare il file a causa di un errore sconosciuto. I tuoi dati non sono stati importati.	Verifica che il file soddisfi tutti i requisiti. Prova a reimportare dopo aver svuotato la cache del browser o utilizzando un altro browser.
	1002	Trovati più proprietari in HITLEAD	"Il file di importazione contiene un valore Owner che corrisponde a più di un utente nell'account. Questo si verifica di solito con i nomi (es. ci sono due utenti 'John Doe' nel tuo account HITLEAD e il file contiene il nome 'John Doe'). I record interessati sono stati importati, ma la proprietà Owner non contiene alcun valore."	Sostituisci il nome del proprietario con la sua email nel file di importazione, poi reimporta il file. Puoi anche aggiornare manualmente il valore della proprietà Owner nei record interessati.
	1003	Numero di fogli non valido	"Il file di importazione contiene più di un foglio. I tuoi dati non sono stati importati."	Rimuovi i fogli aggiuntivi dal file di importazione, poi reimporta. Verifica i requisiti aggiuntivi per l'importazione in HITLEAD.
	1004	Proprietà obbligatoria non valida	"Una proprietà obbligatoria nel file di importazione contiene un valore non valido. I dati in quella riga non sono stati importati."	Verifica i requisiti di formato della proprietà specifica o del tipo di proprietà, aggiorna il file con il formato corretto, poi reimporta.
	1005	Opzione di enumerazione non valida	"Il file di importazione contiene un valore che non corrisponde a un'opzione esistente in una proprietà di enumerazione. Si applica a proprietà di tipo multi-select, dropdown, radio select e checkbox. I record interessati sono stati importati, ma la proprietà di enumerazione non contiene alcun valore."	Identifica il valore errato confrontando il file di importazione con la proprietà in HITLEAD. Puoi aggiornare il valore nel file per farlo corrispondere a un'opzione esistente oppure aggiungere il valore come opzione personalizzata. Reimporta il file o aggiorna manualmente il valore della proprietà nei record interessati.
	1006	ID Contatto non valido	"Durante l'importazione, era selezionata la casella per aggiornare i record esistenti tramite ID Contatto. Tuttavia, l'ID Contatto nel file non corrisponde a un ID esistente in HITLEAD. I record non sono stati importati."	Verifica che gli ID [oggetto] siano corretti. Potrebbe essere necessario esportare i record esistenti per ottenere gli ID oggetto corretti. Se non stai aggiornando o associando oggetti esistenti in HITLEAD, non selezionare la casella durante il processo di importazione.
	1007	File non trovato	"Il file selezionato non è stato trovato. I tuoi dati non sono stati importati."	Verifica di aver salvato il file sul computer e che sia del tipo corretto. Poi ricarica il file.
Voci duplicate in HITLEAD/File	1008	Validazione email fallita	"Il file di importazione contiene un indirizzo email che non rispetta il formato standard (es. nome@dominio.com). L'importazione non ha creato né aggiornato i record."	"Per i Contatti, aggiorna il file di importazione con l'email corretta, assicurandoti che il formato contenga '@' e '.com', poi reimporta il file."
	1009	Valore proprietà univoca mancante nel file	"Il file di importazione contiene una riga con dati che non possono essere elaborati perché manca il valore dell'identificatore univoco (colonna primaria)."	Verifica che il valore corrisponda al formato corretto della proprietà che stai importando, poi reimporta il file. Puoi anche aggiornare manualmente il valore della proprietà nei record interessati.
	1010	Valore proprietà univoca duplicato in HITLEAD	"Lo stesso valore della colonna primaria è presente in più record. I tuoi dati sono stati importati in tutti i record HITLEAD, ma potrebbero esserci duplicati dello stesso record in HITLEAD."	"Scegli un'altra intestazione di colonna come colonna primaria o correggi gli errori, poi reimporta i file."
	1011	Valore proprietà univoca duplicato nel file	"Lo stesso valore univoco è stato utilizzato più volte nel file. I tuoi dati sono stati importati, ma potrebbero esserci duplicati dello stesso record in HITLEAD. Se stavi cercando di associare i record, questi non sono stati associati."	"Scegli un'altra intestazione di colonna come valore univoco o correggi gli errori, poi reimporta i file."
	1012	ID Contatto duplicato nel file	"Lo stesso ID Contatto è stato utilizzato più volte nel file. I record interessati non sono stati aggiornati né associati in HITLEAD."	Aggiorna il file di importazione in modo che ci sia una sola riga con quell'ID Contatto. Mantieni la riga con le informazioni più aggiornate. Dopo aver rimosso i duplicati, reimporta i file.
Varie	1013	Impossibile analizzare il numero di telefono	"Il file di importazione contiene un valore per una proprietà numerica con caratteri non numerici o numeri non formattati secondo il formato E.164. I record interessati sono stati importati, ma la proprietà numerica non contiene alcun valore."	"Aggiorna il file di importazione con il valore numerico corretto e reimporta, oppure aggiorna manualmente il valore della proprietà nei record interessati. Se i record devono corrispondere al campo numerico, scopri come formattare correttamente il file - ULTERIORI INFORMAZIONI-,Phone%20Number,-For%20the%20vast)"
	1014	Impossibile analizzare la data	"Il file di importazione contiene un valore data che non corrisponde al formato selezionato durante il processo di importazione. I record interessati sono stati importati, ma la proprietà data non contiene alcun valore."	"Aggiorna il file di importazione con il valore corretto e reimporta, oppure aggiorna manualmente il valore della proprietà nei record interessati. Se i record devono corrispondere al campo data, scopri come formattare correttamente il file - ULTERIORI INFORMAZIONI"
	1015	Proprietario non trovato	"Il file di importazione contiene un proprietario del record che non corrisponde a un utente in HITLEAD. I record interessati sono stati importati, ma il campo Owner non contiene alcun valore."	"Aggiorna i dati nella colonna Owner del file di importazione con il nome e cognome o l'email di un utente nell'account. Se la persona a cui vuoi assegnare il record non è ancora un utente nell'account, aggiungila come utente, poi reimporta con il suo nome o email così come appare nell'account. Se i record devono corrispondere ai proprietari dei Contatti, scopri come formattare correttamente il file - ULTERIORI INFORMAZIONI"
	1016	Opzione di enumerazione ambigua in HITLEAD	"Lo stesso record corrisponde a più di una delle opzioni esistenti definite per una proprietà di enumerazione. Si applica a proprietà di tipo multi-select, dropdown, single-choice select e checkbox. I record interessati sono stati importati, ma la proprietà di enumerazione non contiene alcun valore."	"Identifica il valore errato confrontando il file di importazione con la proprietà in HITLEAD. Aggiorna il valore nel file per farlo corrispondere a una sola opzione esistente, poi reimporta. Puoi anche aggiornare manualmente il valore della proprietà nei record interessati. Se i record devono corrispondere a più opzioni, scopri come formattare correttamente il file - ULTERIORI INFORMAZIONI"
	1017	La posizione non consente Contatti duplicati - usa 1010 e 1011
	1018	CustomField non supportato → valida durante la mappatura stessa - file e firma
	1019	Valore Custom Field non valido → usa 1005 invece
	1020	Impossibile creare il Contatto
	1021	Non sono stati creati: email, telefono, nome, cognome e tipo
	1022	Contatto non trovato
	1023	Impossibile aggiornare il Contatto
	1024	Impossibile aggiungere Campaign/Workflow

Domande frequenti

D: Quale tipo di file devo caricare?

Sono accettati solo file .csv. Se lavori in Excel o Google Sheets, esporta prima i dati come file CSV.

D: Posso annullare un'importazione massiva?

Non esiste un'opzione di annullamento diretta, ma puoi applicare un Tag ai Contatti importati durante il caricamento. Usa quel Tag per filtrare ed eliminare i record se necessario.

D: Qual è la dimensione massima del file per l'importazione?

Il limite è 20 MB o 10.000 righe, a seconda di quale si raggiunge prima.

D: Come posso validare i numeri di telefono prima del caricamento?

Usa formule del foglio di calcolo o strumenti online per assicurarti che seguano il formato E.164.

D: Cosa devo scegliere come colonna primaria?

Usa un identificatore univoco come Email o ID Contatto che non si ripeta su più Contatti.

D. La mia lista CSV è mista: alcuni Contatti hanno solo email o telefono, altri hanno entrambi. Come devo procedere?

Usa l'opzione 'secondary preference' per un CSV misto. Il sistema cercherà prima il valore della prima preferenza, poi il secondo se non trova il primo. Nell'esempio sopra la prima preferenza è 'Email' e la seconda è 'Phone'.

In questo modo possiamo trovare i Contatti esistenti anche in base al campo secondario: se un record ha solo il numero di telefono, può comunque essere caricato!

Schermata 1 — Risoluzione dei problemi per l'importazione massiva tramite CSV

D. Alcuni dei miei Contatti hanno più email e/o numeri di telefono. Come devo procedere?

Se un Contatto ha più numeri di telefono o email, suddividi il Contatto in più righe in modo che vengano caricati tutti. Esempio:

Originale con due colonne di numero di telefono:

Nome	Telefono 1	Telefono 2	Email
Josephine	810-292 9388	810-374-9840	josephine_darakjy@darakjy.org

Versione ripulita per il caricamento:

Nome	Telefono	Email
Josephine	810-292-9388	josephine_darakjy@darakjy.org
Josephine	810-374-9840

Lascia l'email vuota per il secondo lead con un numero di telefono diverso: avere la stessa email su più righe creerebbe duplicati quando si caricano Contatti con il numero di telefono come campo univoco.

D. Nota importante per chi usa Keap:

Il campo telefono dell'esportazione CSV da Keap è incompatibile con HITLEAD. Le parentesi '()' e i trattini '-' lo rendono incompatibile. È necessario selezionare l'intera colonna nel file CSV, assicurarsi che sia formattata come numero, rimuovere le parentesi e i trattini, e poi importare senza corrompere i dati nel CRM.

D. Quando importo i numeri di telefono, ottengo il codice errore 1007 'proprietà obbligatoria non valida':

Aggiungi un prefisso internazionale per i numeri fuori dal paese del sub-account durante l'importazione. Se il paese del sub-account è impostato su US, non è necessario aggiungere +1 (prefisso USA) ai numeri di telefono importati. Tuttavia, se stai importando numeri fuori dagli USA, dovrai aggiungere il prefisso internazionale.

Esempio: un sub-account con sede negli USA deve aggiungere '+44 per chiamare il Regno Unito. Se il paese del sub-account è impostato su un paese diverso dagli USA (come UK, Australia, ecc.), per chiamare/inviare SMS a numeri USA dovrai aggiungere '+1 al prefisso internazionale nel file CSV.

D. Sto cercando di importare un CSV con una colonna DND, ma tutti i Contatti vengono impostati su DND per TUTTI i canali.

Quando importi Contatti con una colonna DND nel CSV, i Contatti verranno impostati su DND per TUTTI i canali. Se vuoi impostare il DND per canali specifici, configura prima un Workflow e usa i Tag per ogni canale.

Esempio: voglio che il Contatto Giovanni sia DND solo per SMS. Creo un Workflow che imposta un Contatto come DND quando viene aggiunto il Tag 'DND SMS'. Nel CSV, aggiungo il Tag 'DND SMS' accanto al nome di Giovanni. Durante l'importazione, questo attiverà l'automazione per impostare Giovanni come DND solo per SMS.

D. Sto cercando di importare un CSV con Note, ma non riesco a generare più di una nota per record contatto.

Quando importi note di Contatti, puoi avere solo una nota per record contatto con un limite di 5000 caratteri. Usa il campo personalizzato di testo lungo se hai più di una nota o più caratteri di quelli consentiti.

D. Sto cercando di esportare un CSV con Note.

Al momento non c'è alcun limite per l'importazione CSV delle note. Per l'esportazione, il comportamento attuale supporta un massimo di 255 caratteri per l'ultima nota.