Ultimo aggiornamento: 20 novembre 2025
Disponibile con uno qualsiasi dei seguenti abbonamenti, tranne dove indicato:
Prima di importare i dati in HubSpot, consulta i seguenti limiti e requisiti. Puoi anche accedere a file di esempio o generare file di esempio per iniziare.
Per ulteriori informazioni sullo strumento di importazione, consulta questo articolo. 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 al di sotto dei 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 del tuo 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 puoi importare al giorno.
- Se utilizzi solo gli strumenti gratuiti o Smart CRM Professional o Enterprise 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 ha un abbonamento 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 tuo abbonamento HubSpot e sui suoi limiti.
Formattazione dei valori
Per ogni riga del 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 virgola prima 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 True o Yes per visualizzarlo come Yes o selezionato in HubSpot, oppure su False o No per 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 sono state impostate regole di convalida, i valori importati devono seguire tali 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 deal tramite importazione, includi un' intestazioneCollaboratori deal. 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 frequenze 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 PXY dove 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à obbligatorie
A seconda degli oggetti o delle attività che stai importando, le seguenti proprietà sono necessarie per creare record e devono essere incluse come intestazioni di colonna nei tuoi file. Se stai aggiornando i record, devi includere un identificatore univoco (ad esempio, ID record, e-mail, nome di dominio dell'azienda).
Sebbenenon sia obbligatorio, è possibile importare proprietà aggiuntive per ciascun oggetto, comprese le proprietà personalizzate e predefinite. Fare riferimento alle proprietà predefinite per contatti, aziende, trattative, ticket, chiamate, email, 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 dominio 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 si stanno 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 dell'appuntamento. L'inizio dell'appuntamento deve essere formattato come proprietà 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 es. Prezzo USD) e Nome.
- Ordini: nome, pipeline e fase della pipeline.
- Carrelli: nome.
- Voci: nome, quantità, prezzo e ID record o nome dell'accordo 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 la data dell'attività.
- Email: corpo dell'email e 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à e data 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 che l'ID corrisponda 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 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 colonna ID 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 è possibile associare due o più record per riga. Includere le informazioni sui record associati e/o sulle attività 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 che si desidera 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 si importano associazioni dello stesso oggetto, sono previsti 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. È possibile fare riferimento ai file di esempio per ulteriore assistenza nell'importazione e nell'associazione dei record.
Associazioni dello stesso oggetto
È possibile importare un file per associare in blocco i record dello stesso oggetto. Durante il processo di importazione, sarà 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 univoco per 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, ma non puoi importare per creare e associare due nuovi contatti.
- Quando associ contatti/aziende esistenti, puoi utilizzare solol'indirizzo email/dominio aziendale principale come identificatore univoco. Gli indirizzi email 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 valori delle loro e-mail come 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'etichetta Parent e Rory avrà l'etichetta abbinata, Child.
Associazioni padre/figlio
Per creare associazioni tra società controllate e controllanti tramite importazione, scopri di più sull'importazione delle società controllate.
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 è necessario 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, includere il valore Primaria nella colonna Etichetta di associazione per 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 si importano etichette 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 " Associated [identificatore univoco]" riceverà l'etichetta aggiunta durante il processo di importazione o inclusa nella colonna delle etichette del file. L'altro record nella 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 desideri esaminare altri esempi con proprietà aggiuntive, consulta questo articolo con i file di esempio.
