- Knowledge base
- CRM
- Importazione ed esportazione
- Impostazione dei file di importazione
Impostazione dei file di importazione
Ultimo aggiornamento: 2 ottobre 2025
Disponibile con uno qualsiasi dei seguenti abbonamenti, tranne dove indicato:
-
Postazioni richieste per determinate funzionalità
Prima di importare i dati in HubSpot, è necessario verificare i seguenti limiti e requisiti. È inoltre possibile accedere a file di esempio o generare file di esempio per iniziare.
Per saperne di più sullo strumento di importazione, consultare questo articolo. Se il vostro file è pronto, imparate a importare.
Requisiti tecnici e limiti
Tutti i file importati in HubSpot devono:- Essere un file .csv, .xlsx o .xls.
- Avere un solo foglio.
- Includere una riga di intestazione in cui ogni intestazione di colonna corrisponde a una proprietà di HubSpot. Le intestazioni delle colonne possono essere organizzate in qualsiasi ordine senza influenzare l'importazione. È possibile verificare se esiste già una proprietà predefinita che corrisponde all'intestazione o creare una proprietà personalizzata prima dell'importazione. Per saperne di più sui requisiti delle proprietà.
- Contenere meno di 1000 colonne.
- Essere codificato UTF-8 se sono inclusi caratteri di lingue straniere.
- Se si importa un file Excel:
- Contenere dati che non superino i limiti massimi del foglio di lavoro e della cartella di lavoro di Excel.
- Contenere celle in formato Numero quando si importano le proprietà del selezionatore di data e ora.
Esistono ulteriori limiti tecnici per lo strumento di importazione a seconda dell'abbonamento a HubSpot. Questi limiti includono le dimensioni e le righe di un file di importazione, nonché il numero di file e righe che è possibile importare al giorno.
- Se si utilizzano solo gli strumenti gratuiti o Smart CRM Professional o Enterprise di HubSpot, è possibile:
- Importare file fino a 20 MB.
- Completare fino a 50 importazioni al giorno.
- Importare fino a 500.000 righe al giorno. Se si importa un file contenente più di 500.000 righe, il completamento richiederà più giorni.
- Se l'account ha un abbonamento Starter, Professional o Enterprise, è possibile:
- 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 si importa tramite l'API delle importazioni, è possibile importare fino a 80.000.000 di righe al giorno.
Questi limiti si applicano a un periodo mobile di 24 ore e non si azzerano a un'ora specifica del giorno. Per saperne di più sull'abbonamento a HubSpot e sui suoi limiti.
Formattazione dei valori
Per ogni riga del file di importazione, è possibile 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 delle proprietà
A seconda del tipo di campo proprietà, esistono requisiti specifici di formattazione:
Tipo di campo | Requisiti |
Selezionatore di data Selezionatore 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 di due o quattro cifre (2023, 23) e i separatori possono essere una barra in avanti, 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 delle regole di convalida, i valori importati devono seguire tali regole, altrimenti non verranno importati. |
Selezionatore 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 nel formato Numero di testo. Se non si include un timestamp, l'ora è impostata di default a mezzanotte. |
Durata |
Per le proprietà che contengono una durata, come la proprietà Call duration, i valori devono essere formattati come timestamp UNIX in millisecondi. Per saperne di più su come formattare i valori timestamp e su come convertire una data in formato UNIX. |
Enumerazione |
I valori del 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, includere l'ID del file come valore. L'ID di un file si trova nella sezione Generale dei dettagli di un file. |
Caselle di controllo multiple |
Per importare più valori, aggiungere 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 aggiungere valori, aggiungere un punto e virgola prima del primo valore (;valore 3;valore 4). In questo modo il valore verrà aggiunto invece di sovrascrivere il valore della proprietà esistente. |
Numero |
Formatta il valore in base al tipo di proprietà numero creata:
|
Casella di controllo singola |
Creare una colonna per il campo casella di controllo singola e impostare il valore di ogni riga su True o Yes per visualizzarlo come Yes o checked in HubSpot o False o No per visualizzarlo come No o not checked in HubSpot. |
Proprietà Term |
La proprietà dell'elemento di riga Termine deve essere aggiunta nei formati di periodo ISO-8601 PnYnMnD o PnW. Ad esempio, P12M o P24M per i termini annuali. Se lasciata vuota, verranno impostati i termini predefiniti. |
Testo |
Se sono state impostate delle regole di convalida, i valori importati devono seguire le regole o non saranno importati. |
Utente (proprietario) |
Per assegnare un proprietario a un record o a un'attività durante l'importazione:
|
Email di contatto o domini aziendali aggiuntivi
Se si importano contatti con più di un indirizzo e-mail, includere una colonna Indirizzi e-mail aggiuntivi con i loro indirizzi e-mail secondari. Se si importano aziende con più di un nome di dominio, includere una colonnaDomini aggiuntivi con i loro domini secondari. Per includere più e-mail o domini in una cella, separare i valori con un punto e virgola (ad esempio, email@email.com; emailtwo@email.com).
Se si importa per creare contatti o aziende, non è possibile impostare il nome di dominio Email di un nuovo contatto o Azienda di una nuova azienda su un'email o un dominio che è un'email/dominio aggiuntivo esistente per un altro record.
Celle vuote
Lo strumento di importazione ignora le celle vuote in un foglio di calcolo, quindi quando si importano i dati di un nuovo immobile, lasciare le celle vuote per i record senza un valore per l'immobile. Se un record esistente ha già un valore per la proprietà in HubSpot, le celle vuotenon cancelleranno il valore della proprietà esistente. Per cancellare i valori delle proprietà esistenti in blocco, è possibile modificare manualmente i valori o utilizzare l'azione del flusso di lavoroModifica record .Collaboratori
Se si aggiungono collaboratori a un affare tramite l'importazione, includere un'intestazioneCollaboratore affare. Per ogni cella, è necessario includere due o più utenti, separati da un punto e virgola (ad esempio, user1@example.com;user2@example.com).Termine del prodotto e frequenze di fatturazione
Se si importa il valore di una proprietà Termine, è possibile formattare il valore nella colonna Termine come un numero in mesi (ad esempio, 10 per 10 mesi), come PXM dove X è il numero di mesi (ad esempio, P6M, per un termine di 6 mesi) o PXY dove X è il numero di anni (ad esempio, P1Y, per un termine 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 unico.
Proprietà richieste
A seconda degli oggetti o delle attività che si stanno importando, le seguenti proprietà sono necessarie per creare i 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 della società).
Anche senon è obbligatorio, è possibile importare proprietà aggiuntive per ogni oggetto, comprese le proprietà personalizzate e predefinite. Le proprietà predefinite per i contatti, le aziende, le transazioni, i biglietti, le chiamate, le e-mail, le riunioni, le note e le attività. È inoltre possibile visualizzare tutte le proprietà e i relativi valori nelle impostazioni delle proprietà.
- Contatti: almeno uno tra Nome, Cognome o Email.
- Aziende: almeno una delle seguenti opzioni Nome o Nome di dominio dell'azienda.
Nota bene: la proprietà Nome dominio azienda accetta solo valori fino al dominio di primo livello (ad esempio, .com, .edu). I valori con stringhe successive (ad esempio, .edu/home) saranno rimossi automaticamente al momento dell'importazione.
- Offerte: se si stanno creando nuove offerte, nome dell'offerta, pipeline e fase dell'offerta.
- Ticket: se si creano nuovi ticket, nome del ticket, pipeline e stato del ticket.
- Appuntamenti: Inizio appuntamento. L'inizio dell'appuntamento deve essere formattato come una proprietà data-ora.
- Corsi: Nome del corso.
- Inserzioni: Nome.
- Servizi: Nome, Pipeline e Pipeline Stage.
- Prodotti: se state creando dei prodotti, Prezzo unitario e Nome.
- Ordini: Nome, Pipeline e Pipeline Stage.
- Carrelli: Nome.
- Voci di linea: Nome, Quantità, Prezzo e ID record o nome dell'affare associato. Includere l' ID prodotto del prodotto se si sta associando la voce a un prodotto, che verrà mappato come proprietà della voce durante l'importazione.
Nota bene: quando si importano voci di riga con accordi, l'importazione non aggiornerà l'importo dell'accordo. Per aggiornare l'importo del deal associato, è possibile modificare manualmente le voci di riga o associare le voci di riga a un deal in HubSpot.
- Chiamate: Note sulle chiamate. Quando si importano nuove chiamate, si consiglia di includere anche la data di attività.
- Email: Corpo dell'e-mail e direzione dell'e-mail.
- Riunioni: Descrizione della riunione, ora di inizio della riunione e ora di fine della riunione. Quando si importano nuove riunioni, si consiglia di includere anche la data dell'attività. I valori di ora di inizio, ora di fine e data dell'attività devono essere formattati come proprietà data-ora.
- Note: Corpo della nota.
- Attività: Titolo dell'attività e Data di scadenza. La data di scadenza deve essere formattata come proprietà data-ora.
Nota bene: anche se non è obbligatorio, si consiglia di includere la data dell'attività quando si importano nuove attività, per specificare la data e l'ora in cui un'attività si è verificata. Se non si include questa proprietà, i valori della data dell'attività vengono impostati automaticamente alla data e all'ora dell'importazione.
Requisiti per aggiornare i record esistenti o evitare i duplicati
Per aggiornare i record esistenti ed evitare i duplicati, i file devono includere una proprietà identificativa unica per ogni oggetto. Per tutti gli oggetti, è possibile esportare i record esistenti e utilizzare l'ID record come identificatore univoco, oppure utilizzare una proprietà personalizzata che richiede valori univoci. Per i contatti, è possibile utilizzare anche Email. Per le aziende, è possibile utilizzare anche 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 per far corrispondere l'ID all'oggetto corretto (ad esempio, una colonna denominata ID record - Contatti e un'altra denominata ID record - Aziende).
Nota: il seguente comportamento si applica se il nome di dominio dell 'e-mail o dell'azienda è incluso nel file:
- Se si utilizza una proprietà personalizzata a valore univoco per deduplicare i contatti, la proprietà Email richiederà comunque valori univoci.
- Se si utilizza una proprietà personalizzata a valore univoco per deduplicare le aziende, la proprietà Nome dominio azienda non richiederà valori univoci. Ciò significa che è possibile importare domini aziendali duplicati. Se non si vogliono più aziende con lo stesso dominio, è necessario rimuovere i domini duplicati dal file prima dell'importazione, oppure utilizzare il nome del dominio dell'azienda come identificatore univoco.
- È possibile utilizzare un'e-mail secondaria come identificatore univoco per i contatti esistenti che hanno un indirizzo e-mail secondario elencato in HubSpot. Se si utilizza un'e-mail secondaria e non si include la colonna ID record nel file, l'e-mail secondaria non sostituirà l'e-mail primaria. Tuttavia, se si includono sia l'email secondaria che l'ID record come colonne nel file, l'email secondaria sostituirà l'email primaria.
Requisiti per associare i record
Importare le associazioni in un unico file
In un file è possibile associare due o più record per riga. Includere le informazioni sui record e/o sulle attività associate nella stessa riga e includere un identificatore univoco per ogni oggetto. Per associare un record a più attività o record di un altro oggetto, includere l'identificatore univoco del record in più righe per ogni record da associare.
Ad esempio, Luke Danes è un manager del Luke's Diner, ma un appaltatore del 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.
Attenzione: se non si includono identificatori univoci (ad es. e-mail, nome di dominio dell'azienda, ID record), l'importazione creerà record duplicati invece di associarli allo stesso record.
Se si importano associazioni di oggetti uguali, ci sono ulteriori requisiti.
Importare le associazioni in due file
Per associare i record di due oggetti in due file, utilizzare una colonna comune per collegare i record in ciascun file. Per ulteriori informazioni sull 'importazione e l'associazione dei record, consultare i file di esempio.
Associazioni di oggetti uguali
È possibile importare un file per associare record dello stesso oggetto in blocco. Durante il processo di importazione, è necessario selezionare una casella di controllo per includere le associazioni dello stesso oggetto.
Quando si imposta il file, includere le informazioni sui record associati nella stessa riga e includere un identificatore unico per ogni record. I seguenti requisiti aggiuntivi sono specifici per le importazioni dello stesso oggetto:
- Almeno un record di una coppia di record deve essere già presente in HubSpot prima dell'importazione. Ad esempio, è possibile importare un nuovo contatto e associarlo a un contatto esistente, ma non è possibile importare per creare e associare due nuovi contatti.
- Quando si associano contatti/aziende esistenti, è possibile utilizzare solo l'e-mail principale/ildominio dell'azienda come identificatore univoco. Le e-mail o i domini secondari non sono supportati.
- Se si associano più record a un record, separare i valori degli identificatori unici 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 qui sotto, Rory e Jackson sono nuovi contatti che vengono associati con etichette univoche a contatti esistenti, utilizzando i loro valori di e-mail come identificatore univoco. Sookie è un contatto esistente che viene 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'etichetta Genitore e Rory avrà l'etichetta abbinata, Figlio.

Associazioni genitore/figlio
Per creare associazioni tra aziende figlio e genitore tramite l'importazione, si veda la sezione Importazione di aziende figlio.
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, includere una colonna Etichetta di associazione . Questa colonna deve essere aggiunta solo se si desidera aggiungere etichette per descrivere le associazioni. Se non si ha bisogno di etichettare le associazioni, la colonna non è necessaria.
- Le etichette delle associazioni devono essere create in HubSpot prima dell'importazione.
- Per impostare un'associazione aziendale come primaria, includere il valore Primaria nella colonna Etichetta associazione per quella riga.
- Per impostare più etichette per descrivere la relazione tra due record, è possibile includere più valori di etichetta di associazione in una cella, separati da un punto e virgola (ad esempio, Manager; Contatto di fatturazione).
- Se si importano le etichette di associazione in un' importazione di più file, è necessario includere la colonna Etichetta di associazione e un identificatore univoco per l'oggetto che si sta associando nello stesso file.
- Se si importano etichette di associazione:
- Per le associazioni tra oggetti, includere solo una delle etichette nella colonna Etichetta associazione. Le etichette saranno assegnate all'oggetto corretto durante il processo di importazione.
- Per le associazioni dello stesso oggetto, il record nella colonna Associated [unique identifier] riceverà l'etichetta aggiunta nel processo di importazione o inclusa nella colonna label del file. L'altro record della riga riceverà l'altra etichetta della coppia.
File di esempio
All'inizio del processo di importazione, è possibile generare un file di esempio con le proprietà richieste per gli oggetti e le attività selezionati. Se si desidera esaminare altri esempi con proprietà aggiuntive, consultare questo articolo con i file di esempio.
