Questo articolo ti aiuterà a risolvere gli errori che potresti incontrare durante l'importazione di contatti tramite un file CSV in GoHighLevel / Squadd. Ogni codice di errore è accompagnato da una causa specifica e dalla relativa soluzione. Comprenderli garantirà che la tua importazione massiva sia pulita, fluida e riuscita.
INDICE DEI CONTENUTI
- Cos'è l'importazione massiva?
- Vantaggi chiave di un'importazione CSV riuscita
- Checklist per la risoluzione dei problemi di importazione CSV
- Elenco completo dei codici di errore dell'importazione massiva
- Domande frequenti
Cos'è l'importazione massiva?
L'importazione massiva consente agli utenti 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 collegati a una determinata azione di importazione massiva dei Contatti (Contact Import Bulk Action) e come lavorare sugli errori per risolverli:
Vantaggi chiave di un'importazione CSV riuscita
Padroneggiare la risoluzione dei problemi di importazione massiva può far risparmiare tempo ed evitare ostacoli frustranti. Ecco perché è importante:
- Risparmia tempo riducendo le rilavorazioni
- Evita la creazione di record di contatto duplicati o in conflitto
- Mantieni dati di contatto puliti e validati
- Previeni i fallimenti di importazione che bloccano l'automazione dei Workflow
- Garantisci un'assegnazione corretta del proprietario/utente
- Preserva la personalizzazione delle campagne e l'assegnazione dei Tag
Checklist per la risoluzione dei problemi di importazione CSV
Usa questa checklist pre-importazione per prevenire gli errori CSV più comuni:
- Un solo foglio nel file
- Assicurati che tutti i campi obbligatori siano compilati e formattati correttamente
- Formatta correttamente email, numeri di telefono e date
- Usa ID Contatto univoci per ogni riga
- Verifica che i valori di enumerazione/menu a tendina corrispondano esattamente
- Usa email utente valide di GoHighLevel / Squadd per la colonna Proprietario
- Scegli una Colonna Primaria affidabile (come Email o ID Contatto)
Elenco completo dei codici di errore dell'importazione massiva
Categoria principale | ID Errore (Opzionale) | Codice errore | Cosa significa l'errore | Passaggi per risolvere l'errore |
Errori di formattazione durante l'inserimento dei valori nel foglio di calcolo | 1001 | Errore sconosciuto | GoHighLevel / Squadd non è in grado di 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 usando un altro browser. |
1002 | Trovati più proprietari in GoHighLevel / Squadd | "Il file di importazione contiene un valore Proprietario che corrisponde a più di un utente nell'account. Di solito accade con i nomi (es. ci sono due utenti Mario Rossi nel tuo account GoHighLevel / Squadd e il file di importazione conteneva il nome 'Mario Rossi'). I record interessati sono stati importati, ma il campo Proprietario non contiene alcun valore." | Sostituisci il nome del proprietario con il suo indirizzo email nel file di importazione, poi reimporta il file. Puoi anche aggiornare manualmente il valore del campo Proprietario 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. Controlla i requisiti aggiuntivi per l'importazione in GoHighLevel / Squadd. | |
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 in modo che corrisponda al 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 alle proprietà di tipo selezione multipla, menu a tendina, selezione radio e casella di controllo. I record interessati sono stati comunque importati, ma la proprietà di enumerazione non contiene alcun valore." | Identifica il valore errato confrontando il file di importazione con la proprietà in GoHighLevel / Squadd. Puoi scegliere di aggiornare il valore nel file di importazione in modo che corrisponda a un'opzione esistente, oppure aggiungere il valore come opzione personalizzata alla proprietà. Una volta terminato, 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 indicato nel file non corrisponde a un ID esistente in GoHighLevel / Squadd. I record non sono stati importati." | Assicurati 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 GoHighLevel / Squadd, 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. Dopodiché, carica nuovamente il file. | |
Voci duplicate in GoHighLevel / Squadd o nel file | 1008 | Convalida email fallita | "Il file di importazione contiene un indirizzo email che non è conforme al formato di un tipico indirizzo email (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 sia corretto con '@' e '.com', poi reimporta il file. |
1009 | Valore della proprietà univoca vuoto nel file | "Il file di importazione contiene una riga con dati che non possono essere elaborati perché non è presente alcun valore per il campo identificativo univoco del record (colonna primaria)." | Verifica che il valore dei dati corrisponda al formato corretto per la proprietà che stai importando, poi reimporta il file. Puoi anche aggiornare manualmente il valore della proprietà nei record interessati. | |
1010 | Valore della proprietà univoca duplicato in GoHighLevel / Squadd | "Lo stesso valore della colonna primaria è presente in più record. I tuoi dati sono stati importati in tutti i record di GoHighLevel / Squadd, ma potrebbero esserci duplicati dello stesso record." | "Scegli un'intestazione di colonna diversa come colonna primaria o correggi eventuali errori, poi reimporta i file." | |
1011 | Valore della proprietà univoca duplicato nel file | "Lo stesso valore univoco è stato utilizzato più volte nei tuoi file. I dati sono stati importati, ma potrebbero esserci duplicati dello stesso record in GoHighLevel / Squadd. Se stavi cercando di associare i record, l'associazione non è avvenuta." | "Scegli un'intestazione di colonna diversa come valore univoco o correggi eventuali errori, poi reimporta i file." | |
1012 | ID Contatto duplicato nel file | "Lo stesso ID Contatto è stato utilizzato più volte nei tuoi file. I record interessati non sono stati aggiornati né associati in GoHighLevel / Squadd." | 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 che desideri includere in GoHighLevel / Squadd. Una volta rimossi 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 tuoi record devono corrispondere al campo numerico, scopri come formattare il file per importare correttamente i dati in proprietà con caselle di controllo multiple - SCOPRI DI PIÙ" |
1014 | Impossibile analizzare la data | "Il file di importazione contiene un valore di 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 tuoi record devono corrispondere al campo data, scopri come formattare il file per importare correttamente i dati in proprietà con caselle di controllo multiple - SCOPRI DI PIÙ" | |
1015 | Proprietario non trovato | "Il file di importazione contiene un proprietario del record che non corrisponde a nessun utente in GoHighLevel / Squadd. I record interessati sono stati importati, ma il campo Proprietario non contiene alcun valore." | "Aggiorna i dati nella colonna Proprietario del file di importazione includendo il nome e il cognome o l'email di un utente nel tuo account. Se la persona a cui desideri assegnare il record non è ancora un utente dell'account, aggiungila come utente, poi reimporta con il suo nome o email come appare nell'account. Se i tuoi record devono corrispondere ai proprietari dei contatti, scopri come formattare il file per importare correttamente i dati in proprietà con caselle di controllo multiple - SCOPRI DI PIÙ" | |
1016 | Opzione di enumerazione ambigua in GoHighLevel / Squadd | "Lo stesso record corrisponde a più di una delle opzioni esistenti definite per una proprietà di enumerazione. Si applica alle proprietà di tipo selezione multipla, menu a tendina, selezione singola e casella di controllo. 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 GoHighLevel / Squadd. Aggiorna il valore nel file di importazione in modo che corrisponda a una sola opzione esistente, poi reimporta il file. Puoi anche aggiornare manualmente il valore della proprietà nei record interessati.
Se i tuoi record devono corrispondere a più opzioni, scopri come formattare il file per importare correttamente i dati in proprietà con caselle di controllo multiple - SCOPRI DI PIÙ" | |
| 1017 | La Location non consente contatti duplicati - usa 1010 & 1011 | |||
| 1018 | Campo personalizzato non supportato -> validare durante il mapping stesso - file e firma | |||
1019 | Valore campo personalizzato non valido -> usa 1005 | |||
| 1020 | Creazione contatto fallita | |||
| 1021 | Non sono stati forniti email, telefono, nome, cognome e tipo | |||
| 1022 | Contatto non trovato | |||
| 1023 | Aggiornamento contatto fallito | |||
| 1024 | Aggiunta campagna/workflow fallita |
Domande frequenti
D: Quale tipo di file devo caricare?
Sono accettati solo file .csv. Se stai lavorando in Excel o Google Sheets, esporta prima i dati come file CSV.
D: Posso annullare un'importazione massiva?
Non esiste un'opzione "annulla" diretta, ma puoi taggare i contatti importati durante il caricamento. Usa quel Tag per filtrare ed eliminare i contatti se necessario.
D: Qual è la dimensione massima del file per l'importazione?
Il limite è 20 MB o 10.000 righe, a seconda di quale viene raggiunto per primo.
D: Come posso validare i numeri di telefono prima del caricamento?
Usa formule di 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 tra più contatti.
D. La mia lista CSV è mista: alcuni contatti hanno solo un'email o un numero di telefono, altri hanno entrambi. Come devo procedere?
Usa l'opzione 'preferenza secondaria' per un CSV misto. Il sistema cercherà prima la prima preferenza e poi la seconda se non riesce a trovare la prima. Nell'esempio sopra, la prima preferenza è 'Email' e la seconda è 'Telefono'.
In questo modo è possibile trovare i contatti esistenti anche in base al campo secondario: se il record del contatto ha solo il numero di telefono, potremo comunque caricarlo!
D. Alcuni 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 correttamente. Esempio:
Originale con due colonne per il numero di telefono:
|
| 810-374-9840 |
|
Versione pulita per il caricamento:
Josephine | 810-292-9388 | josephine_darakjy@darakjy.org |
Josephine | 810-374-9840 |
Lascia il campo email vuoto per il secondo lead con un numero di telefono diverso, perché causerebbe duplicati quando si importano contatti con il numero di telefono come campo univoco.
D. Nota importante per chi usa Keap:
Il campo telefono dell'esportazione CSV di Keap non è compatibile con GoHighLevel / Squadd. Le parentesi '()' e i trattini '-' lo rendono incompatibile. È necessario selezionare l'intera colonna nel file CSV, assicurarsi che contenga solo numeri, rimuovere eventuali parentesi e trattini, e poi procedere all'importazione senza corrompere i dati nel CRM.
D. Quando importo i numeri di telefono, ricevo il codice di errore 1007 'proprietà obbligatoria non valida':
Aggiungi il prefisso internazionale per i numeri al di fuori del paese della Location durante l'importazione. Se il paese della Location è impostato su US, non sarà necessario aggiungere il +1 (prefisso internazionale USA) ai numeri di telefono importati. Tuttavia, se stai importando numeri al di fuori degli USA, dovrai aggiungere il prefisso internazionale
Ad esempio: Una Location con sede impostata sugli USA dovrà aggiungere '+44 per chiamare il Regno Unito. Se il paese della Location è impostato su un paese diverso dagli USA (come Regno Unito, Australia, ecc.), per chiamare/inviare SMS a numeri USA, sarà necessario aggiungere il '+1 al prefisso di area del paese nel file CSV.
D. Sto cercando di importare un CSV con una colonna DND, ma tutti i contatti risultano DND per TUTTI i canali.
Quando importi contatti con una colonna DND nel CSV, tieni presente che i contatti saranno impostati come DND per TUTTI i canali. Se desideri impostare il DND per canali specifici, crea prima un Workflow e usa i Tag per ogni canale.
Ad esempio: Se voglio che John sia DND solo per SMS, creo un Workflow che imposta il DND di un contatto quando viene aggiunto il Tag 'DND SMS'. Nel CSV, aggiungo il Tag 'DND SMS' accanto al nome di John. Durante l'importazione, questo avvierà l'automazione per impostare John 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 dei contatti, è possibile inserire una sola nota per record contatto, con un limite di 5000 caratteri. Usa il campo personalizzato testo esteso se hai più di una nota o più caratteri di quanti consentiti.
D. Sto cercando di esportare un CSV con Note.
Al momento non esiste un limite per l'importazione CSV delle note; per quanto riguarda il comportamento attuale dell'esportazione, supportiamo un massimo di 255 caratteri per l'ultima nota.