Ultimo aggiornamento: 3 giugno 2025
Disponibile con uno qualsiasi dei seguenti abbonamenti, tranne dove indicato:
Tutti i prodotti e i piani
|
Prima di importare dati in HubSpot, recensire i limiti e i requisiti indicati di seguito. È 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, scoprite come effettuare l'importazione.
Requisiti e limiti tecnici
Tutti i file che vengono 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 in lingua straniera.
- Se si sta importando 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 durante l'importazione delle proprietà del selezionatore di data e ora.
Lo strumento di importazione presenta ulteriori limiti tecnici a seconda del vostro 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 strumentiCRM HubSpot Professional o Enterprise , gratuiti o intelligenti , è possibile:
- Importazione di file fino a 20 MB.
- Completare fino a 50 importazioni al giorno.
- Importare fino a 500.000 righe al giorno. L'importazione di file contenenti più di 500.000 righe richiederà più giorni per essere completata.
- Se il vostro account ha un abbonamento Starter, Professional o Enterprise, potete:
- Importazione di 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 effettua l'importazione tramite l'API, è 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 sulle sue limitazioni.
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 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 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 in file CSV o in un file Excel con celle nel formato Numero di testo. Se non si include un timestamp, l'ora è impostata a mezzanotte per impostazione predefinita. |
| Durata |
Per le proprietà che contengono una durata, come la proprietà Chiamata 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 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à, includere l'ID del file come valore. L'ID del file si trova nella sezione Generale dei dettagli del 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à numerica creata:
|
| Casella di controllo singola |
Creare una colonna per il campo Casella di controllo singola e impostare il valore di ogni riga su Vero o Sì per visualizzarlo come Sì o controllato in HubSpot o Falso o No per visualizzarlo come No o non controllato in HubSpot. |
| Proprietà del termine |
La proprietà della voce Termine deve essere aggiunta nei formati ISO-8601 di periodo 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 tali regole, altrimenti non verranno importati. |
| Utente (proprietario) |
Per assegnare un proprietario a un record o a un'attività durante l'importazione:
|
Ulteriori contatti e-mail o domini e-mail dell'azienda
Se si importano contatti con più di un indirizzo e-mail, includere una colonna Indirizzi e-mail aggiuntivi con le loro e-mail secondarie. Se si importano aziende con più di un nome dominio, includere una colonnaDomini aggiuntivi con i loro domini secondari. Per includere più domini 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 Dominio e-mail di un nuovo contatto o il nome dominio dell'Azienda di una nuova azienda su un'e-mail o un dominio aggiuntivo esistente per un altro record dell'azienda.
Celle vuote
Lo strumento di importazione ignora le celle vuote in un foglio di calcolo, quindi quando si importano i dati di una nuova proprietà, lasciare 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 saranno non cancella il valore della proprietà esistente. Per cancellare i valori delle proprietà esistenti in blocco, è possibile modificare manualmente i valori o utilizzare la funzione Azione del flusso di lavoroCancella valore della proprietà .Collaboratori delle Trattative
Se si aggiungono collaboratori a una trattativa tramite l'importazione, includere un'opzione Collaboratore delle Trattative intestazione. Per ogni cella, è necessario includere due o più utenti, separati da un punto e virgola (ad esempio, user1@example.com;user2@example.com).Durata del prodotto e frequenza 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 il 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 delle colonne nei file. Se si aggiornano i record, è necessario includere un identificativo univoco (ad esempio, Record ID, E-mail, Nome dominio dell'Azienda).
Anche senon è obbligatorio, è possibile importare proprietà aggiuntive per ogni oggetto, comprese quelle personalizzate e predefinite. Si vedano le proprietà predefinite di Contatti, Aziende, Trattative, Biglietti, Chiamate, E-mail, Riunioni, Note e Task. È 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 una delle seguenti opzioni Nome o Nome dominio dell'azienda.
- Trattative: se si creano nuove trattative, nome della trattativa, pipeline e fase della trattativa.
- 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 proprietà data-ora.
- Corsi: Nome del corso.
- Elenchi: Nome.
- Servizi: Nome, Pipeline e Fase della pipeline.
- Prodotti: se state creando dei prodotti, Prezzo unitario e Nome.
- Ordini: Nome, Pipeline e Fase della pipeline.
- Carrelli: Nome.
- Voci: Nome, Quantità, Prezzo e l'ID Record della trattativa o il nome della Trattativa associati. Includere l' ID prodotto del prodotto se si associa la voce a un prodotto, che verrà mappato come proprietà della voce durante l'importazione.
Nota bene: quando si importano voci con trattative, l'importazione non aggiorna l'importo della trattativa. Per aggiornare l'importo della trattativa associata, è possibile modificare manualmente le voci o associare le voci a una trattativa in HubSpot.
- Chiamate: Chiamate. Quando si importano nuove chiamate, si consiglia di includere anche la data dell'attività.
- E-mail: Corpo dell'e-mail e direzione dell'e-mail.
- Riunioni: Descrizione delle riunioni, 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 dell'ora di inizio, dell'ora di fine e della data dell'attività devono essere formattati come proprietà data-ora.
- Note: Corpo della nota.
- Task: Titolo del task e Data di scadenza. La data di scadenza deve essere formattata come proprietà data-ora.
Nota: 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 di Data 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à di identificazione univoca 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 E-mail. Per le aziende, si può usare anche Nome dominio dell'azienda.
Se si importano più oggetti e si includono gli ID dei record, si consiglia di differenziare le intestazioni delle colonne del file per far corrispondere l'ID all'oggetto corretto (ad esempio, una colonna chiamata ID del record - Contatti e un'altra ID del record - Aziende).
Nota: il seguente comportamento si applica se il Dominio e-mail o il Nome dominio dell'Azienda sono inclusi nel file:
- Se si utilizza una proprietà valore univoco personalizzata per deduplicare i contatti, la proprietà E-mail continuerà a richiedere valori univoci.
- Se si utilizza una proprietà personalizzata a valore unico per deduplicare le aziende, la proprietà Nome dominio dell'azienda non richiederà valori unici. Ciò significa che è possibile importare domini di aziende 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 dominio dell'azienda come identificatore unico.
- È possibile utilizzare un'e-mail secondaria come identificativo unico 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 Record ID nel file, l'e-mail secondaria non sostituirà l'e-mail principale. Tuttavia, se si includono nel file sia l'e-mail secondaria che l'ID record, l'e-mail secondaria sostituirà l'e-mail principale.
Associazioni del record
Importazione di 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 unico del record in più righe per ogni record che si vuole 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 E-mail (o Record ID) e Dominio e-mail (o Record ID) per ciascuna azienda.
Attenzione: se non si includono identificatori univoci (ad esempio, E-mail, Dominio dell'azienda, Record dell'azienda), l'importazione creerà record duplicati invece di associare ciascuno allo stesso record.
Se si stanno importando associazioni di oggetti uguali, ci sono ulteriori requisiti.
Importazione di associazioni in due file
Per associare i record di due oggetti in due file, utilizzare una colonna comune per entrare in contatto con i record di ciascun file. Per ulteriori informazioni sull'importazione e l'associazione del record, consultare i file di esempio.
Stesse associazioni di oggetti
È possibile importare un file per associare in blocco record dello stesso oggetto. 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 ildominio e-mail primario/azienda come identificatore univoco. Non sono supportati domini e-mail o domini secondari.
- Se si associano più record a un record, separare i valori dell'identificativo unico 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 a Etichette di associazione uniche a contatti esistenti, utilizzando i loro valori E-mail come identificatore unico. 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 di genitori e figli
Per creare associazioni tra società madre e figlio tramite l'importazione, si veda la sezione Importazione di società controllate.
Etichette di associazione personalizzate( soloProfessional ed 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.
- È necessario creare le etichette di associazione in HubSpot prima dell'importazione.
- Per impostare l'associazione di un'azienda come primaria, includere il valore Primario nella colonna Etichetta di associazione per quella riga.
- Per impostare più etichette per descrivere l'associazione tra due record, è possibile includere più valori di etichetta di associazione in una cella, separati da un punto e virgola (ad esempio, Responsabile; 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 da associare nello stesso file.
- Se si stanno importando etichette associate:
- Per le associazioni tra più oggetti, includere solo una delle etichette nella colonna Etichetta di associazione. Le etichette saranno assegnate all'oggetto corretto durante il processo di importazione.
- Per le associazioni dello stesso oggetto, il record della colonna Associated [unique identifier] riceverà l'etichetta aggiunta nel processo di importazione o inclusa nella colonna Etichetta di associazione del file. L'altro record della riga riceverà l'altra etichetta della coppia.
File d'esempio
All'inizio del processo di importazione, è possibile generare un file di esempio con le proprietà richieste per gli oggetti e le attività selezionate. Se desiderate recensire altri esempi con proprietà aggiuntive, consultate questo articolo con i file di esempio.
