DocTransform
Tutte le guide all'importazione

HubSpot non importa il tuo file di contatti?

Correggi gli errori che HubSpot mostra durante l'importazione CSV dei contatti, poi importa pulito ogni settimana.

Errori mostrati da HubSpot

Manca una proprietà obbligatoria

Proprietà obbligatoria mancante
Centro assistenza HubSpot

Un valore di proprietà univoca è duplicato

Valore della proprietà univoca duplicato
Centro assistenza HubSpot

Una data non corrisponde al formato scelto

Impossibile analizzare la data
Centro assistenza HubSpotCome correggere questo errore

Cosa controlla l'importatore di HubSpot

  • Ogni proprietà che il tuo portale segna come obbligatoria, Email compresa, deve avere un valore.

    segnaliamo una cella vuota non appena marchi la colonna come obbligatoria: menu ⋯ della colonna → Modifica colonna… → Altre opzioni → Campo obbligatorio; il filtro Ha bisogno di affetto sopra la griglia elenca ogni vuoto

    HubSpot salta la riga

    Centro assistenza HubSpot

    Ultimo controllo: 25 ottobre 2026

  • Una proprietà segnata come univoca, come Email, non deve ripetersi nel file.

    DocTransform lo corregge: scrivi

    Scrivi Email in minuscolo e rimuovi le righe con un Email duplicato

    Oppure a mano

    clicca sull’intestazione della colonna Email → minuscolo, poi Rimuovi duplicati; la riga del contatto duplicato viene rimossa

    HubSpot la importa in modo errato, senza errori

    Centro assistenza HubSpot

    Ultimo controllo: 25 ottobre 2026

  • Un numero di telefono («Phone Number») deve essere scritto come +[prefisso internazionale][numero].

    DocTransform lo corregge: scrivi

    Scrivi Phone number come E.164

    Oppure a mano

    apri Stato → Telefoni scritti in modi diversi → Riscrivi 4 valori (il pulsante mostra quanti numeri converte); ogni numero leggibile viene reso come +[prefisso internazionale][numero], e uno illeggibile resta com’è

    HubSpot la importa in modo errato, senza errori

    Centro assistenza HubSpot

    Ultimo controllo: 25 ottobre 2026

  • Il file deve essere un unico foglio CSV, XLSX o XLS con una riga di intestazione, meno di 1.000 colonne e codificato in UTF-8 per i caratteri non inglesi.

    HubSpot rifiuta il file

    Centro assistenza HubSpot

    Ultimo controllo: 25 ottobre 2026

  • Il file ha bisogno di una colonna chiamata Email.

    DocTransform lo corregge: apri il menu ⋯ della colonna → Modifica colonna… → clicca sul nome in alto nel pannello, cambialo in Email e premi Invio

    HubSpot rifiuta il file

    Centro assistenza HubSpot

    Ultimo controllo: 25 ottobre 2026

  • Ogni Email deve essere un indirizzo completo, come nome@example.com.

    lo segnaliamo una volta marcata la colonna come obbligatoria (menu ⋯ della colonna → Modifica colonna… → Altre opzioni → Campo obbligatorio; il filtro Ha bisogno di affetto sopra la griglia elenca ogni riga); cliccare sull’intestazione della colonna Email → Rimuovi spazi, poi minuscolo, rimuove gli spazi e corregge le maiuscole, ma un indirizzo malformato lo correggi tu

    HubSpot salta la riga

    Centro assistenza HubSpot

    Ultimo controllo: 25 ottobre 2026

  • Un Date of birth deve essere scritto come lo legge HubSpot, ad esempio AAAA-MM-GG.

    DocTransform lo corregge: apri il menu ⋯ della colonna Date of birth → Formatta le date… → uscita AAAA-MM-GG (2024-12-31) → Salva regola

    HubSpot la importa in modo errato, senza errori

    Centro assistenza HubSpot

    Ultimo controllo: 25 ottobre 2026

  • Un Date of birth come 03/04/2024 può essere letto con giorno e mese scambiati.

    DocTransform lo corregge: apri il menu ⋯ della colonna Date of birth → Formatta le date… → scegli l’ordine in cui sono scritte le date, uscita AAAA-MM-GG → Salva regola

    HubSpot la importa in modo errato, senza errori

    Centro assistenza HubSpot

    Ultimo controllo: 25 ottobre 2026

  • Un Lead Status deve essere una delle opzioni elencate dal tuo portale, altrimenti HubSpot lo lascia vuoto.

    DocTransform lo corregge: apri il menu ⋯ della colonna Lead Status → Trova e sostituisci…, cerca il valore, Sostituisci con l’opzione del tuo portale, Cella intera → Sostituisci tutto

    HubSpot la importa in modo errato, senza errori

    Centro assistenza HubSpot

    Ultimo controllo: 25 ottobre 2026

  • I valori multipli di Interests sono separati da un punto e virgola, senza spazio accanto.

    DocTransform lo corregge: apri il menu ⋯ della colonna Interests → Trova e sostituisci…, cerca una virgola e lo spazio che la segue, Sostituisci con ;, Corrispondenza parziale → Sostituisci tutto

    HubSpot la importa in modo errato, senza errori

    Centro assistenza HubSpot

    Ultimo controllo: 25 ottobre 2026

  • Una cella oltre 1 MB fa saltare la riga a HubSpot; accorcia i testi molto lunghi nel file di origine.

    HubSpot salta la riga

    Centro assistenza HubSpot

    Ultimo controllo: 25 ottobre 2026

Prima e dopo

8204 contatti

newsletter_signups.xlsx
EmailFirst namePhone numberEmail subscriptions
Ines@SolyMar.example1Ines Ruiz+34 600-123-4562Newsletter, Events3
ines@solymar.example4Ines Ruiz+34600123456Webinars
marc.bloch@nordic.exampleMarc Bloch+46701234567Newsletter
julia.novak@praha.exampleJulia Novak+420.601.234.567Events
tomas.silva@lisboa.exampleTomas Silva+351 912 345 6785Newsletter, Webinars
anna.keller@wien.exampleAnna Keller+436601234567Webinars
leo.martin@paris.exampleLeo Martin+33 6 12 34 56 78Newsletter

    Correggi in DocTransform

    A mano: 14 passaggiDocTransform: 1 frase

    1. 1. Carica newsletter_signups.xlsx in DocTransform.
    2. 2. Scrivi

      Scrivi Email in minuscolo, rimuovi le righe con un Email duplicato, sostituisci la virgola seguita da uno spazio in Email subscriptions con un punto e virgola e scrivi Phone number come E.164

      e premi Invia. Controlla i passaggi che aggiunge; Annulla li annulla tutti.
      Oppure a mano

      Applica le correzioni: clicca sull’intestazione della colonna Email → minuscolo, poi Rimuovi duplicati per rimuovere il contatto duplicato; apri il menu ⋯ della colonna Email subscriptions → Trova e sostituisci…, cerca una virgola e lo spazio che la segue, sostituisci con ;, Corrispondenza parziale → Sostituisci tutto per unire gli argomenti attesi da HubSpot. Poi apri Stato → Telefoni scritti in modi diversi → Riscrivi 4 valori per ottenere ogni numero di telefono come +[prefisso internazionale][numero].

    3. 3. Scarica il file pulito come CSV, pronto per l'importatore di HubSpot.
    “Scrivi Email in minuscolo, rimuovi le righe con un Email duplicato, sostituisci la virgola seguita da uno spazio in Email subscriptions con un punto e virgola e scrivi Phone number come E.164” scritta in DocTransform; quattro passaggi applicati, una riga duplicata rimossa, gli argomenti di Email subscriptions separati da punto e virgola, i numeri di telefono scritti in E.164 con il prefisso internazionale; Annulla visibile
    1. Scrivi la modifica in una frase, con parole tue.
    2. Attendi circa 5 secondi mentre i passaggi vengono scritti. Interrompi annulla.
    3. Controlla ogni passaggio e quante celle o righe modifica.
    4. Il file è pulito. Non era quello che volevi? Un Annulla ripristina tutto.

    Salva questa correzione una volta e rilanciala sull’esportazione della settimana prossima.

    Correggi a mano in Excel o Sheets

    1. Fai clic destro sull’intestazione della colonna B e scegli Inserisci per aggiungere una colonna di appoggio vuota accanto a Email.
    2. In B2, scrivi =MINUSC(A2) e premi Invio.
    3. Fai doppio clic sul quadratino di riempimento in basso a destra di B2 per estendere la formula fino all’ultima riga.
    4. Con le celle riempite della colonna B ancora selezionate, premi Ctrl+C per copiarle.
    5. Seleziona A2, scegli Home → Incolla → Incolla speciale → Valori e fai clic su OK, così Ines@SolyMar.example diventa ines@solymar.example.
    6. Fai clic destro sull’intestazione della colonna B e scegli Elimina per togliere la colonna di appoggio.
    7. Fai clic su una cella della tabella, scegli Dati → Rimuovi duplicati, fai clic su Deseleziona tutto, spunta Email e fai clic su OK per togliere la riga ripetuta di Ines Ruiz.
    8. Fai clic sull’intestazione della colonna D (Email subscriptions), poi scegli Home → Trova e seleziona → Sostituisci.
    9. Scrivi una virgola e uno spazio in Trova, scrivi ; in Sostituisci con e fai clic su Sostituisci tutto, così Newsletter, Events diventa Newsletter;Events.
    10. Seleziona una colonna che segnerai come obbligatoria in HubSpot, poi scegli Home → Trova e seleziona → Vai a formato speciale → Celle vuote → OK.
    11. Scrivi a mano un valore in ogni cella vuota evidenziata, e ripeti entrambi i passaggi per ogni colonna obbligatoria.
    12. Fai clic destro sull’intestazione della colonna C (Phone number), scegli Formato celle → Testo e fai clic su OK, così Excel mantiene il + iniziale.
    13. Riscrivi a mano ogni numero di telefono senza spazi né punteggiatura, ad esempio +34 600-123-456 come +34600123456.
    14. Scegli File → Salva con nome, seleziona CSV UTF-8 (delimitato da virgole) (*.csv) e fai clic su Salva; se Excel avvisa di più fogli, fai clic su OK.

    Domande

    DocTransform divide il mio file se supera i limiti di HubSpot?
    Sì, per righe. In Export Studio scegli Dividi in file → Per numero di righe… e imposta quante righe al massimo ha ogni file: scarichi uno .zip e carichi i file uno alla volta. Divide per righe, non per dimensione, quindi non può garantire che un file resti sotto un limite di dimensione: controlla ogni file prima di caricarlo.
    DocTransform conosce le proprietà richieste da HubSpot?
    In parte. Conosce i controlli che HubSpot pubblica per un file di contatti, elencati sopra con la data dell’ultimo controllo. Le proprietà obbligatorie del tuo portale le indichi tu: segnale nel pannello Salute, e ti segnala le celle vuote.
    Posso riutilizzare questa correzione la prossima volta?
    Sì — salvala una volta in DocTransform e rilanciala sull’esportazione di contatti della settimana prossima.
    Prova questa frase gratis

    Piano gratuito, senza carta.

    Salesforce, HubSpot, Shopify, QuickBooks, Mailchimp, Pipedrive, WooCommerce, Klaviyo, Google Contacts, ActiveCampaign, Brevo, Zendesk, Square, Zoho CRM e Xero sono marchi dei rispettivi proprietari. DocTransform non è affiliato con loro.