Ultimo aggiornamento: 10 dicembre 2025
Disponibile con uno qualsiasi dei seguenti abbonamenti, tranne dove indicato:
Prima di importare i dati in HubSpot, verifica che i tuoi file rispettino i requisiti di formato e i limiti tecnici richiesti. Alcuni limiti dipendono dal tipo di abbonamento. Informati sui tipi di file supportati, su come strutturare e formattare i valori delle proprietà e su quanti file e righe puoi importare in un determinato periodo.
Esamina il funzionamento dello strumento di importazione e utilizza file di esempio o file generati automaticamente per preparare i tuoi dati. Se il tuo file è pronto, scopri come importarlo.
Requisiti tecnici e limiti
Tutti i file importati in HubSpot devono:- Essere file .csv, .xlsx o .xls.
- Avere un solo foglio.
- Includere una riga di intestazione in cui ogni intestazione di colonna corrisponda a una proprietà in HubSpot. Le intestazioni delle colonne possono essere organizzate in qualsiasi ordine senza influire sull'importazione. È possibile verificare se esiste già una proprietà predefinita corrispondente all 'intestazione o creare una proprietà personalizzata prima dell'importazione. Ulteriori informazioni sui requisiti delle proprietà.
- Contenere meno di 1000 colonne.
- Essere codificato in UTF-8 se sono inclusi caratteri in lingua straniera.
- Se stai importando un file Excel:
- Contenere dati che rimangono entro i limiti massimi del foglio di lavoro e della cartella di lavoro di Excel.
- Contenere celle in formato numerico quando si importano le proprietà del selettore di data e ora.
Esistono ulteriori limiti tecnici per lo strumento di importazione a seconda dell'abbonamento HubSpot. Questi limiti includono le dimensioni e il numero di righe di un file di importazione, nonché il numero di file e righe che è possibile importare al giorno.
- Se utilizzi gli strumenti gratuiti di HubSpot, puoi:
- Importare file fino a 20 MB.
- Completare fino a 50 importazioni al giorno.
- Importare fino a 500.000 righe al giorno. Se importi un file contenente più di 500.000 righe, saranno necessari diversi giorni per completare l'operazione.
- Se il tuo account dispone di un abbonamento Smart CRM o Starter, Professional o Enterprise, puoi:
- Importare file fino a 512 MB.
- Completare fino a 500 importazioni al giorno.
- Importare fino a 10.000.000 di righe al giorno, con un limite di 1.048.576 righe per file. Se stai importando tramite l'API di importazione, puoi importare fino a 80.000.000 di righe al giorno.
Questi limiti si applicano a un periodo di 24 ore consecutive e non vengono azzerati a un'ora specifica del giorno. Scopri di più sul tuoabbonamento HubSpot e sui suoi limiti.
Formattazione dei valori
Per ogni riga del tuo file di importazione, puoi aggiungere valori per le colonne delle proprietà. La formattazione di un valore dipende dal tipo di campo della proprietà e dall'obiettivo dell'importazione.
Formattazione dei valori in base al tipo di campo della proprietà
A seconda del tipo di campo della proprietà, esistono requisiti di formattazione specifici:
| Tipo di campo | Requisiti |
| Selettore di date Selettore di data e ora |
I mesi possono essere un numero, tre lettere o un nome completo (10, OCT, Oct, OCTOBER, October), gli anni possono essere a due o quattro cifre (2023, 23) e i separatori possono essere una barra, un trattino o un punto (10/28/2023, 10-28-2023, 10.28.2023). I formati di data validi sono giorno mese anno (ad esempio, 28/10/2023), mese giorno anno (ad esempio, 10-28-23) o anno mese giorno (ad esempio, 2023.OCT.28). Se sono state impostate regole di convalida, i valori importati devono rispettare tali regole, altrimenti non verranno importati. |
| Selettore di data e ora |
I timestamp possono essere aggiunti come hh:mm (28/10/2020 14:30) in tutti i tipi di file o come timestamp UNIX in millisecondi nei file CSV o in un file Excel con celle in formato numerico testo. Se non si include un timestamp, l'ora viene impostata di default a mezzanotte. |
| Durata |
Per le proprietà che contengono una durata, come la proprietà Durata della chiamata, i valori devono essere formattati come timestamp UNIX in millisecondi. Ulteriori informazioni su come formattare i valori dei timestamp e su come convertire una data nel formato UNIX. |
| Enumerazione |
I valori nel file di importazione devono corrispondere all'etichetta o al valore interno delle opzioni definite della proprietà. Per le proprietà di enumerazione predefinite di HubSpot (ad esempio, Fase del ciclo di vita, Settore), i valori devono corrispondere al valore interno o all'etichetta in inglese. |
| File |
Per aggiungere file esistenti a una proprietà file, includi l'ID file come valore. Puoi trovare l'ID di un file nella sezione Generale dei dettagli del file. |
| Caselle di controllo multiple |
Per importare più valori, aggiungi un punto e virgola tra ogni valore senza spazi (valore 1;valore 2). Queste opzioni di proprietà devono essere create prima dell'importazione. Per aggiungere o appendere valori, aggiungere un punto e virgolaprima del primo valore (;valore 3;valore 4). In questo modo il valore verrà appeso invece di sovrascrivere il valore della proprietà esistente. Ulteriori informazioni sull'importazione di valori di caselle di controllo multiple. |
| Numero |
Formatta il valore in base al tipo di proprietà numerica creata:
|
| Casella di controllo singola |
Crea una colonna per il campo casella di controllo singola e imposta il valore su ogni riga su TrueoYesper visualizzarlo come Yes o selezionato in HubSpot, oppuresu FalseoNoper visualizzarlo come No o non selezionato in HubSpot. |
| Proprietà del termine |
La proprietà della voce Termini deve essere aggiunta nei formati di periodo ISO-8601 PnYnMnD o PnW. Ad esempio, P12M o P24M per i termini annuali. Se lasciato vuoto, verranno impostati i termini predefiniti. |
| Testo |
Se hai impostato regole di convalida, i valori importati devono seguire le regole, altrimenti non verranno importati. |
| Utente (proprietario) |
Per assegnare un proprietario a un record o a un'attività durante l'importazione:
|
Indirizzi e-mail di contatto aggiuntivi o domini aziendali
Se stai importando contatti con più di un indirizzo e-mail, includi una colonna Indirizzi e-mail aggiuntivi con i loro indirizzi e-mail secondari. Se stai importando aziende con più di un nome di dominio, includi una colonnaDomini aggiuntivi con i loro domini secondari. Per includere più indirizzi e-mail o domini in una cella, separa i valori con punti e virgola (ad esempio, email@email.com; emailtwo@email.com).
Se stai importando per creare contatti o aziende, non puoi impostare l'indirizzo e-mail di un nuovo contatto o il nome di dominio di una nuova azienda su un indirizzo e-mail o un dominio che è già un indirizzo e-mail/dominio aggiuntivo esistente per un altro record.
Celle vuote
Lo strumento di importazione ignora le celle vuote in un foglio di calcolo, quindi quando importi nuovi dati di proprietà, lascia le celle vuote per i record senza un valore per la proprietà. Se un record esistente ha già un valore per la proprietà all'interno di HubSpot, le celle vuote non cancelleranno il valore della proprietà esistente. Per cancellare in blocco i valori delle proprietà esistenti, puoi modificare manualmente i valori o utilizzare l'azionedel flusso di lavoro Modifica record .Collaboratori dell'opportunità
Se stai aggiungendo collaboratori a un'opportunità tramite importazione, includi un' intestazioneCollaboratori dell'opportunità. Per ogni cella, devi includere due o più utenti, separati da punti e virgola (ad esempio, user1@example.com;user2@example.com).Durata del prodotto e frequenza di fatturazione
Se si importa un valore della proprietà Durata, è possibile formattare il valore nella colonna Durata come un numero in mesi (ad esempio, 10 per 10 mesi), come PXM dove X è il numero di mesi (ad esempio, P6M, per una durata di 6 mesi) o PXYdove X è il numero di anni (ad esempio, P1Y, per una durata di 1 anno).
Se si importa un valore della proprietà Frequenza di fatturazione, utilizzare mensile, annuale o trimestrale se il prodotto ha un tipo di prezzo ricorrente. Lasciare la cella vuota se il prodotto ha un prezzo una tantum.
Proprietà richieste
A seconda degli oggetti o delle attività che si stanno importando, le seguenti proprietà sono necessarie per creare record e devono essere incluse come intestazioni di colonna nei file. Se si aggiornano i record, è necessario includere un identificatore univoco (ad esempio, ID record, e-mail, nome di dominio dell'azienda).
Sebbenenon sia obbligatorio, è possibile importare proprietà aggiuntive per ogni oggetto, comprese le proprietà personalizzate e predefinite. Fare riferimento alle proprietà predefinite per contatti, aziende, trattative, ticket, chiamate, e-mail, riunioni, note e attività. È inoltre possibile visualizzare tutte le proprietà e i relativi valori nelle impostazioni delle proprietà.
- Contatti: almeno uno tra Nome, Cognome o E-mail.
- Aziende: almeno uno tra Nome o Nome di dominio dell'azienda.
Nota: la proprietà Nome di dominio dell'azienda accetta solo valori fino al dominio di primo livello (ad esempio, .com, .edu). I valori con stringhe successive (ad esempio, .edu/home) verranno automaticamente rimossi durante l'importazione.
- Offerte: se stai creando nuove offerte,nome dell'offerta, pipeline e fase dell'offerta.
- Ticket: se stai creando nuovi ticket, nome del ticket, pipeline e stato del ticket.
- Appuntamenti: Inizio appuntamento. L'inizio dell'appuntamento deve essere formattato comeproprietà data-ora.
- Corsi: nome del corso.
- Annunci: nome.
- Servizi: nome, pipeline e fase della pipeline.
- Prodotti: se stai aggiornando i prodotti, ID record o SKU.
- Se stai aggiornando i prodotti in un account con una sola valuta,Prezzo unitario e Nome.
- Se stai aggiornando i prodotti in un account con più valute,Prezzo [abbreviazione della valuta] (ad esempio, Prezzo USD) e Nome.
- Ordini: nome, pipeline e fase della pipeline.
- Carrelli: nome.
- Voci: nome, quantità, prezzo e ID record o nome dell'affare associato. Includi l'ID prodotto se stai associando la voce anche a un prodotto, che verrà mappato come proprietà della voce durante l'importazione.
Nota: quando si importano voci di riga con offerte, l'importazione non aggiornerà l'importo dell'offerta. Per aggiornare l'importo dell'offerta associata, è possibile modificare manualmente le voci di riga o associare le voci di riga a un'offerta in HubSpot.
- Chiamate: note sulle chiamate. Quando si importano nuove chiamate, si consiglia anche di includere Data dell'attività.
- Email: corpo dell'emaile direzione dell'email.
- Riunioni:descrizione della riunione, ora di inizio della riunione e ora di fine della riunione. Quando si importano nuove riunioni, si consiglia anche di includere la data dell'attività. I valori relativi all'ora di inizio, all'ora di fine e alla data dell'attività devono essere formattati come proprietà data-ora.
- Note: corpo della nota.
- Attività:titolo dell'attivitàedata di scadenza. La data di scadenza deve essere formattata come proprietà data-ora.
Nota: sebbene non sia obbligatorio, si consiglia di includere la data dell'attività quando si importano nuove attività per specificare la data e l'ora in cui si è svolta l'attività. Se non si include questa proprietà, i valori della data dell'attività vengono automaticamente impostati sulla data e l'ora dell'importazione.
Requisiti per aggiornare i record esistenti o evitare duplicati
Per aggiornare i record esistenti ed evitare duplicati, i file devono includere una proprietà identificativa univoca per ogni oggetto. Per tutti gli oggetti, è possibile esportare i record esistenti e utilizzare l'ID record come identificativo univoco, oppure utilizzare una proprietà personalizzata che richiede valori univoci. Per i contatti, è anche possibile utilizzare l'indirizzo e-mail. Per le aziende, è anche possibile utilizzare il nome di dominio dell'azienda.
Se si importano più oggetti e si includono gli ID record, si consiglia di differenziare le intestazioni delle colonne del file in modo da abbinare l'ID all'oggetto corretto (ad esempio, una colonna denominata ID record - Contatti e un'altra denominata ID record - Aziende).
Nota: ilseguente comportamento si applica se nel file sono inclusi l'indirizzo e-mail o il nome di dominio dell'azienda :
- Se si utilizza una proprietà con valore univoco personalizzato per deduplicare i contatti, la proprietà Email richiederà comunque valori univoci.
- Se utilizzi una proprietà con valore univoco personalizzato per deduplicare le aziende, la proprietà Nome dominio azienda non richiederà valori univoci. Ciò significa che puoi importare domini aziendali duplicati. Se non desideri avere più aziende con lo stesso dominio, dovresti rimuovere i domini duplicati dal tuo file prima dell'importazione oppure utilizzare il nome dominio azienda come identificatore univoco.
- Puoi utilizzare un'e-mail secondaria come identificatore univoco per i contatti esistenti che hanno un indirizzo e-mail secondario elencato in HubSpot. Se utilizzi un'e-mail secondaria e non includi la colonnaID record nel tuo file, l'e-mail secondaria non sostituirà l'e-mail principale. Tuttavia, se includi sia l'e-mail secondaria che l'ID record come colonne nel tuo file, l'e-mail secondaria sostituirà l'e-mail principale.
Requisiti per associare i record
Importa le associazioni in un unico file
In un unico file, puoi associare due o più record per riga. Includi le informazioni sui record associati e/o sulle attività nella stessa riga e includi un identificatore univoco per ogni oggetto. Per associare un record a più attività o record di un altro oggetto, includi l'identificatore univoco del record in più righe per ogni record che desideri associare.
Ad esempio, Luke Danes è un manager presso Luke's Diner, ma un appaltatore presso The Dragonfly Inn. Per associarlo a entrambe le aziende, è necessario includere due righe per Luke Danes con le colonne Email (o ID record) e Nome dominio azienda (o ID record) per ciascuna azienda.
Nota: se non si includono identificatori univoci (ad esempio, Email, Nome dominio azienda, ID record), l'importazione creerà record duplicati invece di associare ciascuno allo stesso record.
Se stai importando associazioni dello stesso oggetto, ci sono requisiti aggiuntivi.
Importa associazioni in due file
Per associare i record di due oggetti in due file, utilizza una colonna comune per collegare i record in ciascun file. Puoi fare riferimento ai file di esempio per ulteriore assistenza nell'importazione e nell'associazione dei record.
Associazioni dello stesso oggetto
Puoi importare un file per associare in blocco i record dello stesso oggetto. Durante il processo di importazione, dovrai selezionare una casella di controllo per includere le associazioni dello stesso oggetto.
Quando configuri il tuo file, includi le informazioni sui record associati nella stessa riga e includi un identificatore univocoper ogni record. I seguenti requisiti aggiuntivi sono specifici per le importazioni dello stesso oggetto:
- Almeno un record in una coppia di record deve già esistere in HubSpot prima dell'importazione. Ad esempio, puoi importare un nuovo contatto e associarlo a un contatto esistente, manonpuoi importare per creare e associare due nuovi contatti.
- Quando associ contatti/aziende esistenti, puoi utilizzare solo l'indirizzoe-mail/dominio aziendale principale come identificatore univoco. Gli indirizzi e-mail o i domini secondari non sono supportati.
- Se si associano più record a un unico record, separare i valori degli identificatori univoci dei record con un punto e virgola nella stessa cella (ad esempio,luke@lukesdiner.com;rory@yale.edu;sookie@dragonfly.com).
Nel file di esempio riportato di seguito, Rory e Jackson sono nuovi contatti associati a etichette univoche a contatti esistenti, utilizzando i loro valorie-mailcome identificatori univoci. Sookie è un contatto esistente associato a due contatti esistenti con la stessa etichetta. Nella prima riga, l'etichetta di associazione fa parte di una coppia di etichette, il che significa che una volta completata l'importazione, il record associato avrà l'etichettaGenitore e Roryavrà l'etichetta abbinata,Figlio.
Associazioni padre/figlio
Per creare associazioni tra società figlie e società madri tramite importazione, scopri di più sull'importazione delle società figlie.
Etichette di associazione personalizzate
Abbonamento richiesto Per utilizzare le etichette di associazione personalizzate è necessario un abbonamento Professional o Enterprise.
Per importare le etichette di associazione, includi una colonna Etichetta di associazione. Questa colonna deve essere aggiunta solo se desideri aggiungere etichette per descrivere le associazioni. Se non hai bisogno di etichettare le associazioni, la colonna non è necessaria.
- È necessario creare le etichette di associazione in HubSpot prima dell'importazione.
- Per impostare un'associazione aziendale come primaria, includi il valore Primaria nella colonna Etichetta di associazioneper quella riga.
- Per impostare più etichette per descrivere la relazione tra due record, puoi includere più valori di etichetta di associazione in una cella, separati da un punto e virgola (ad esempio, Manager; Contatto di fatturazione).
- Se stai importando etichette di associazione in un'importazione di più file, devi includere la colonna Etichetta di associazione e un identificatore univoco per l'oggetto che stai associando nello stesso file.
- Se stai importandoetichette accoppiate:
- Per le associazioni tra oggetti diversi, includere solo una delle etichette nella colonna Etichetta di associazione. Le etichette verranno assegnate all'oggetto corretto durante il processo di importazione.
- Per le associazioni dello stesso oggetto, il record nellacolonna Associato [identificatore univoco] riceverà l'etichetta aggiunta nelprocesso di importazione o inclusa nella colonna Etichetta del file. L'altro record nella riga riceverà l'altra etichetta della coppia.
File di esempio
All'inizio del processo di importazione, puoi generare un file di esempio con le proprietà richieste per gli oggetti e le attività selezionati. Se desideri esaminare altri esempi con proprietà aggiuntive, consulta questo articolo con i file di esempio.
