Vai al contenuto
Docs

Risoluzione dei problemi

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.

Aggiornato il 1 ott 2026

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 MarketingContacts 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.

  3. Crea prima i campi personalizzati. Aggiungi i campi mancanti in WorkspaceSettings, sezione Custom fields, poi avvia di nuovo l’importazione. Vedi Campi personalizzati.

  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.

  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.

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 per la guida completa, oppure usa Crea un contatto per sincronizzare i contatti dalla tua app.

Serve ancora aiuto?

Contatta il supporto o chiedi su Discord indicando il messaggio di errore e le prime righe del file, senza dati personali.

Questa pagina ti è stata utile?

Grazie del feedback.

Grazie, leggiamo ogni messaggio.