# Perché l’importazione dei contatti non è riuscita?

> Risolvi le importazioni di contatti che non riescono o che importano meno contatti del previsto. Copre il limite di 2500 righe, email non valide, campi personalizzati e limiti delle liste.

Questo articolo ti aiuta quando l’importazione di contatti da un file CSV o Excel mostra un errore, oppure si conclude con meno contatti di quelli presenti nel file.

## Sintomi

La finestra **Import CSV** in **Email Marketing → Contacts** mostra un banner rosso nel passaggio di anteprima, ad esempio:

- `A maximum of 2500 contacts can be imported per request.`
- `Contact #42 has an invalid email address.`
- `Unknown custom field key(s): …`
- `Pay as you go includes 10,000 subscribers per audience.`

Oppure **Continue** resta disattivato con il messaggio **You must map at least one column to the Email field.**

## Causa

Ogni importazione viene controllata nel suo insieme. Se una regola non è rispettata, non viene importato nulla:

- **Più di 2500 righe.** Ogni importazione accetta fino a 2500 contatti.
- **Un indirizzo email non valido.** Un solo indirizzo malformato fa fallire l’intero file. Il numero nel messaggio conta i contatti dopo la rimozione delle righe vuote, quindi può essere diverso dal numero di riga del foglio di calcolo.
- **Un campo personalizzato che non esiste.** Le colonne associate a campi personalizzati richiedono che quei campi siano già stati creati.
- **Nessuna colonna associata a Email.** Email è l’unico campo obbligatorio.
- **La lista supererebbe il limite del piano.** Pay as you go consente 10.000 iscritti per lista, Pro 50.000 e Business 250.000. Il controllo conta tutte le righe del file più gli iscritti attuali della lista.

Se i contatti sono meno del previsto, di solito ci sono righe con la cella email vuota. Vengono saltate senza errori. Di un file Excel viene letto solo il primo foglio.

## Soluzione

1. **Dividi i file grandi.** Suddividi il file in parti da 2500 righe o meno e importale una dopo l’altra.

2. **Pulisci la colonna email.** Rimuovi spazi, punteggiatura finale e indirizzi multipli nella stessa cella. Per trovare gli indirizzi errati o rischiosi, passa prima la lista alla [verifica email](/it/docs/email-verification/lists/).

3. **Crea prima i campi personalizzati.** Aggiungi i campi mancanti in **Workspace → Settings**, sezione **Custom fields**, poi avvia di nuovo l’importazione. Vedi [Campi personalizzati](/it/docs/contacts/custom-fields/).

4. **Controlla l’associazione delle colonne.** Se il file ha una riga di intestazione, lascia attivo **File has header** in modo che le colonne corrispondano per nome. Associa una colonna a **Email**, imposta le colonne inutilizzate su **Exclude** e controlla l’anteprima.

5. **Resta sotto il limite della lista.** Importa in un’altra lista, rimuovi gli iscritti inattivi o passa a un piano superiore. Vedi [Limiti e quote](/it/docs/limits/).

6. **Attendi l’elaborazione.** Le importazioni vengono eseguite in background. Quando la finestra conferma «Contact import has been queued and will be processed shortly.», attendi un minuto e aggiorna l’elenco dei contatti.

> **Le importazioni reiscrivono i contatti:** Importare un contatto in una lista da cui si era disiscritto lo iscrive di nuovo. Prima di importare il file, togli le persone che hanno revocato il consenso.

I contatti già esistenti vengono aggiornati invece che duplicati. I nomi vengono sostituiti solo se il file contiene un valore, e i campi personalizzati vengono uniti. Leggi [Importa ed esporta i contatti](/it/docs/contacts/import-export/) per la guida completa, oppure usa [Crea un contatto](/it/docs/api-reference/contacts/create/) per sincronizzare i contatti dalla tua app.

## Serve ancora aiuto?

[Contatta il supporto](/contact/) o chiedi su [Discord](https://discord.emailit.com) indicando il messaggio di errore e le prime righe del file, senza dati personali.

---
Fonte: https://emailit.com/it/docs/kb/contacts-import-failed/