Quando carichi un elenco di contatti e visualizzi un messaggio "registro degli errori" nel registro delle azioni, significa che qualcosa nell'elenco di contatti non è corretto.
I motivi che possono dare luogo a un registro degli errori:
• File dei contatti (CSV) formattato in modo errato *
• Numero errato di colonne di intestazione
• Troppe poche colonne su una determinata riga (o separatori di campo mancanti)
• Uno o più indirizzi email non sono nel formato: nome@sito web.com
• Indirizzi email duplicati (l'indirizzo duplicato verrà scartato)
• Impossibile convertire il valore (formati di data errati)
• Importazione interrotta dal sistema a causa di un errore "critico"
Per scaricare il registro degli errori, clicca sul pulsante "Scarica il registro degli errori". Esamina i messaggi di errore nel file di registro e correggi l'elenco di contatti. Nota: se non ci sono errori nel prossimo caricamento, il registro degli errori scomparirà.
* Per informazioni su come creare un file CSV per caricare i contatti, leggi le nostre FAQ.
Spiegazione dei registri degli errori
Il numero di proprietà del contatto supera il limite di X
L'importazione del tuo CSV sta cercando di creare/associare più proprietà del contatto (campi personalizzati) di quante ne consenta il sistema. Il limite massimo è 200 (incluso il campo e-mail).
Esempio tipico
Il limite è di 200 proprietà, ma il tuo file ha 260 colonne personalizzate:
e-mail,field_01,field_02,field_03,...,field_260 john@esempio.com,a,b,c,...,z
→ Lo strumento di importazione avrebbe bisogno di 260 proprietà (una per colonna), valore che supera il limite → Il numero di proprietà del contatto supera il limite di 200.
Soluzione: rimuovi/unisci colonne o esegui più caricamenti, specificando proprietà diverse in ogni file:
- CSV 1 - proprietà 1-199
- CSV 2 - proprietà 200-260
Colonna e-mail non trovata
Significa che lo strumento di importazione non è riuscito a identificare alcuna colonna nel CSV come campo e-mail, quindi non sa quale valore usare come identificatore unico del contatto.
Questo di solito accade in uno di questi casi:
1) Il file non contiene alcuna colonna e-mail
Intestazione:
nome,cognome,città
Semplicemente non c'è una colonna che contenga le e-mail → Colonna e-mail non trovata.
Soluzione: aggiungi una colonna e-mail:
e-mail,nome,cognome,città
2) Il file contiene le e-mail, ma il nome dell'intestazione non viene riconosciuto
L'intestazione dell'esempio utilizza un nome non standard:
contact_address,firstname,lastname john@esempio.com,John,Doe
Lo strumento di importazione rileva automaticamente solo intestazioni come email / Email → Colonna e-mail non trovata.
Soluzione: rinomina l'intestazione in email.
3) Il file non ha una riga di intestazione (la prima riga contiene dati)
john@esempio.com,John,Doe jane@esempio.com,Jane,Doe
Se lo strumento di importazione si aspetta una riga di intestazione, non può “vedere” una colonna e-mail → Colonna e-mail non trovata.
Soluzione: aggiungi una riga di intestazione:
e-mail,nome,cognome john@esempio.com,John,Doe
4) Un delimitatore errato rende l'intestazione illeggibile
L'intestazione utilizza il punto e virgola come separatore, ma il resto del CSV utilizza la virgola (o viceversa):
e-mail;nome;cognome john@esempio.com,John,Doe
Questo fa sì che le righe vengano analizzate in modo diverso dall'intestazione e porta a un errore.
Soluzione: utilizza un solo delimitatore in tutto il file (intestazione + tutte le righe).
Importazione annullata
In genere, quando si riscontrano troppi errori (1000 errori o il 10% della lista importata, a seconda di quale valore sia più alto).
Carattere UTF-8 non valido alla riga X
Il file non è in formato UTF-8 valido (codifica errata o caratteri danneggiati) in quella riga.
Esempio 1 (tipico): file salvato in Windows-1252, contiene “virgolette intelligenti”
La riga del tuo CSV potrebbe sembrare a posto in Excel, ma le virgolette sono “curve”:
john@esempio.com,John,“Marketing team”
Queste virgolette curve (“ ”) sono comuni quando il testo viene copiato da Word/Outlook e il file non viene salvato in formato UTF-8. Lo strumento di importazione segnala quindi: Carattere UTF-8 non valido alla riga X.
Soluzione: riesporta come CSV UTF-8 (o apri il file in un editor di testo e salvalo come UTF-8).
Esempio 2 (comune con il cirillico): file salvato in Windows-1251, contiene caratteri cirillici
ivan@esempio.com,Иван,София
Se il file è in formato Windows-1251 ma lo strumento di importazione si aspetta il formato UTF-8, i byte per Иван / София non verranno decodificati correttamente e riceverai: Carattere UTF-8 non valido alla riga X.
Soluzione: salva/esporta il CSV come UTF-8.
Esempio 3 (byte danneggiato): compare un “carattere di sostituzione” o un simbolo strano
john@esempio.com,John,ACME Ltd
Il carattere indica spesso byte danneggiati/non validi durante la conversione. Quella riga può triggerare l'errore UTF-8.
Soluzione: rimuovi/sostituisci il simbolo errato e salva in formato UTF-8.
Troppe colonne alla riga X
Quella riga contiene più valori di quanto richiesto dall'intestazione, di solito a causa di delimitatori mancanti o virgolette/interruzioni di riga interrotte.
Ecco come appare in pratica
Intestazione (prevede 3 colonne, separate da virgole):
email,nome,cognome
Riga errata (, in più → 4 colonne):
john@esempio.com,John,,Doe
Se il valore centrale non è intenzionale, correggilo:
john@esempio.com,John,Doe
Se si tratta di un campo centrale vuoto che è intenzionale, anche l'intestazione/la mappatura deve includere quella colonna.
Troppo poche colonne alla riga X
Quella riga contiene meno valori di quanto richiesto dall'intestazione, di solito a causa di delimitatori mancanti o virgolette/interruzioni di riga interrotte.
Ecco come appare in pratica
Intestazione (prevede 4 colonne):
email,nome,cognome,città
Riga errata (solo 3 colonne → “troppo poche colonne”):
john@esempio.com,John,Sofia
Qui, il valore lastname è mancante (o manca un delimitatore), quindi la riga ha solo 3 campi invece di 4.
Formato email errato (campo: email)
Il valore dell'email in quella riga non è un indirizzo email valido (@ mancante, spazi, caratteri non validi, più email, ecc.).
Esempi comuni che lo provocano
Mancante @:
john.esempio.com
Parte del dominio mancante:
john@
Spazi (spesso da copia/incolla):
john @esempio.com
Spazi iniziali/finali (possono essere invisibili):
" john@esempio.com "
Caratteri non validi:
john<>@esempio.com
Due email in una cella:
john@esempio.com; jane@esempio.com
Nome visualizzato invece di indirizzo grezzo:
John Doe
Come risolvere
Assicurati che la cella contenga una sola email in formato standard:
john@example.com
(Elimina gli spazi, rimuovi nomi/parentesi e dividi le email multiple in righe separate.)
Email duplicata (campo: email)
La stessa email compare più di una volta nel file caricato.
Parte locale troppo lunga (campo: email)
La parte prima di @ è più lunga del consentito, spesso a causa di una mappatura errata delle colonne o di dati non validi nella colonna dell'email. Mappa la colonna email corretta e correggi il valore.
Dominio troppo lungo (campo: email)
La parte dopo @ è più lunga del consentito, spesso a causa di una mappatura errata o di valori email non validi. Esegui la mappatura correttamente e correggi l'email.
Impossibile convertire il valore (FieldName)
Questi errori indicano che la proprietà esiste, ma il valore nella riga non può essere archiviato perché non corrisponde al tipo della proprietà nel database. Formatta il valore correttamente (ad es. date valide, numeri solo numerici).
Esempio (proprietà integer)
Proprietà: age è integer
La riga CSV contiene:
email,age john@esempio.com,abc
→ la conversione non riesce perché abc non è un integer.
Soluzione:
john@esempio.com,43
Esempio (proprietà data)
Proprietà: birthdate prevede una data
email,birthdate john@esempio.com,oggi
→ formato/valore della data non valido.
Soluzione (usa il formato previsto):
john@esempio.com,2026-03-06
Errore di convalida della proprietà (FieldName)
Questo errore indica che il nome della proprietà del contatto preso dall'intestazione del CSV non è consentito, quindi il sistema non può creare/mappare quella proprietà.
1) Carattere non valido nel nome alla posizione N: X
Significato: il nome della proprietà (intestazione della colonna) contiene un carattere proibito alla posizione N.
Esempio (intestazione errata):
email,first-name john@esempio.com,John
Se - non è consentito → carattere non valido.
Soluzione: rinomina l'intestazione utilizzando i caratteri consentiti (in genere lettere/trattino basso):
email,first_name
2) I numeri non possono essere usati come nomi: X
Significato: il nome della proprietà non può essere solo numerico (o non può iniziare con un numero, a seconda delle regole).
Esempio (intestazione errata):
email,123 john@esempio.com,test
Soluzione:
email,field_123
3) Nome non valido: X è una parola riservata.
Significato: l'intestazione corrisponde a una parola chiave riservata che il sistema non consente come nome di proprietà.
Esempio (intestazione errata):
email,class john@esempio.com,A
Soluzione: rinomina l'intestazione:
email,customer_class
L'intestazione mappata ha meno colonne dell'intestazione nel file
Quando importi un file CSV, il sistema legge prima la riga di intestazione, ovvero i nomi delle colonne nella parte superiore del file. Nella schermata di importazione, tenta quindi di abbinare ogni colonna a una proprietà del contatto esistente o suggerisce di crearne una nuova con un tipo di dati appropriato.
Questo processo è chiamato intestazione mappata. Definisce come le colonne del file CSV corrispondono ai campi che Mailjet utilizzerà durante l'importazione.
Se l'intestazione mappata non corrisponde all'intestazione effettiva nel file, l'importazione non può continuare e si interrompe immediatamente.
Se riscontri questo errore, contatta il nostro team di assistenza per ulteriore aiuto.
L'intestazione mappata ha più colonne dell'intestazione nel file
Quando importi un file CSV, il sistema legge prima la riga di intestazione, ovvero i nomi delle colonne nella parte superiore del file. Nella schermata di importazione, tenta quindi di abbinare ogni colonna a una proprietà del contatto esistente o suggerisce di crearne una nuova con un tipo di dati appropriato.
Questo processo è chiamato intestazione mappata. Definisce come le colonne del file CSV corrispondono ai campi che Mailjet utilizzerà durante l'importazione.
Se l'intestazione mappata non corrisponde all'intestazione effettiva nel file, l'importazione non può continuare e si interrompe immediatamente.
Se riscontri questo errore, contatta il nostro team di assistenza per ulteriore aiuto.