- Knowledge base
- Account & Configurazione
- Integrazioni
- Mappare le proprietà di HubSpot ai campi di Salesforce
Mappare le proprietà di HubSpot ai campi di Salesforce
Ultimo aggiornamento: 27 luglio 2026
Disponibile con uno qualsiasi dei seguenti abbonamenti, tranne dove indicato:
-
Marketing Hub Professional, Enterprise
-
Sales Hub Professional, Enterprise
-
Service Hub Professional, Enterprise
-
Data Hub Professional, Enterprise
-
Content Hub Professional, Enterprise
-
CRM HubSpot intelligente Professional, Enterprise
Dopo aver installato l'integrazione HubSpot-Salesforce, associa le proprietà di HubSpot ai campi di Salesforce per garantire che i dati rimangano coerenti su entrambi i sistemi. Una volta effettuati gli abbinamenti, gli aggiornamenti apportati in un sistema possono essere sincronizzati con l'altro, a seconda delle impostazioni di sincronizzazione.
Ad esempio, è possibile mappare una proprietà di un contatto HubSpot, come la "Qualifica", a un campo di un lead o di un contatto in Salesforce per mantenere allineati i record su entrambe le piattaforme.
Crea o modifica le mappature dei campi
Aggiungi una nuova mappatura dei campi
- Nel tuo account HubSpot, fai clic sull'
icona delle impostazioni nella barra di navigazione principale. Nel menu della barra laterale sinistra, vai a Integrazioni > App connesse. - Nell’elenco delle app collegate, clicca su Salesforce.
- Accedere alla scheda " Sincronizzazione dati ".
- Nel menu della barra laterale sinistra,fai clic sulla scheda relativa all'oggetto che desideri mappare.
- Quindi fare clic su Mappature delle proprietà.
Nota: per configurare le mappature dei campi relativi alle aziende o alle trattative,è necessario che la sincronizzazione degli oggetti tra HubSpot e Salesforce sia attivata per le aziende o le trattative.
- Per aggiungere una nuova mappatura di campo, clicca su Aggiungi nuova mappatura di campo.
- Nel pannello di destra, utilizza i menu a discesa per selezionare la proprietà HubSpot e il campo Salesforce che desideri mappare. Per creare una mappatura, devi selezionare proprietà e campi compatibili. La tabella seguente mostra i tipi di campo delle proprietà HubSpot che possono essere sincronizzati con Salesforce, i nomi API corrispondenti e i tipi di campo Salesforce corrispondenti.
| Tipo di campo della proprietà HubSpot | Tipo di campo di Salesforce |
| Selezione da menu a tendina/Selezione con pulsanti di opzione | elenco a scelta, riferimento |
| Caselle di controllo multiple | multipicklist |
| Casella di controllo singola | booleano |
| Numero | doppio/intero |
| Testo a riga singola | stringa, area di testo |
| Testo su più righe | textarea |
| Selettore di date | data, data e ora |
Nota:
- Se è presente una discrepanza di tipo o se una delle proprietà o dei campi selezionati è già mappata, verrà visualizzato un messaggio sopra i menu a discesa. Fai clic sul messaggio per saperne di più.
- Le proprietà personalizzate con il tipo di campo " Utente HubSpot " non possono essere mappate ai campi di Salesforce.

- Fai clic su Avanti.
Seleziona una regola di sincronizzazione
- La regola di sincronizzazione per la mappatura determina le modalità di sincronizzazione dei dati tra HubSpot e Salesforce. Seleziona una regola di sincronizzazione tra le seguenti opzioni:
-
- Preferire Salesforce se non vuoto
- HubSpot trasmetterà un valore a Salesforce solo se al momento non è presente alcun valore in Salesforce.
- Preferire Salesforce se non vuoto
-
-
- Se in Salesforce è presente un valore, tale valore sovrascriverà sempre quello esistente in HubSpot.
- Se elimini il valore in Salesforce, il valore verrà eliminato anche in HubSpot.
- Utilizzare sempre Salesforce
- HubSpot non trasmetterà mai dati a Salesforce, anche se in Salesforce non è presente alcun valore.
- Se in Salesforce è presente un valore, questo sovrascriverà sempre il valore esistente in HubSpot.
- Se elimini il valore in Salesforce, il valore verrà eliminato anche in HubSpot.
- Bidirezionale
- Il valore più recente sovrascriverà sempre qualsiasi valore esistente.
- Se il valore viene eliminato in HubSpot, verrà eliminato anche in Salesforce e viceversa.
- Non sincronizzare
- I dati non verranno mai trasferiti tra HubSpot e Salesforce.
- Se il valore viene eliminato in HubSpot, non verrà eliminato in Salesforce e viceversa.
-

- Sebbene il tuo account HubSpot possa mostrare l’opzione “Preferisci Salesforce se non vuoto” per la mappatura “Proprietario”, tale mappatura può essere effettuata solo in modo bidirezionale tra HubSpot e Salesforce. Il valore del campo “Proprietario” deve corrispondere esattamente tra HubSpot e Salesforce.
- I valori esistenti in una mappatura appena creata non verranno sincronizzati retroattivamente. Per sincronizzare i valori esistenti, esegui una risincronizzazione manuale dei record, una risincronizzazione in blocco dei record oppure esegui un’importazione da Salesforce.
- Se un record di contatto non presenta una cronologia di sincronizzazione precedente per il campo mappato (ad esempio, perché la mappatura è stata creata dopo l’ultima sincronizzazione del contatto con Salesforce o perché il campo non aveva alcun valore durante l’ultima sincronizzazione), la prima sincronizzazione utilizza il valore corrente di Salesforce come riferimento. A seconda della regola di sincronizzazione selezionata, ciò può sovrascrivere un valore più recente presente in HubSpot.
- Fare clic su Salva per salvare la mappatura.
La nuova mappatura apparirà ora nell’elenco delle mappature relative all’oggetto selezionato. Per modificare una mappatura esistente, passa il mouse su di essa e clicca su Modifica mappatura.
Una volta aggiunte le mappature, avvia la sincronizzazione dell’oggetto selezionato con Salesforce cliccando per attivare l’interruttore Sincronizza [Oggetto]. Per i contatti, questa opzione è attivata per impostazione predefinita e non può essere disattivata.

Nota: è previsto un limite di 500 mappature di campo per oggetto.
Sincronizzazione dei proprietari
HubSpot identifica gli utenti Salesforce Standard, PowerPartner, Guest e Queue come proprietari di Salesforce quando:
- Questi dati vengono importati in HubSpot da Salesforce.
- L'utente di Salesforce possiede un record di lead, contatto, account o opportunità che viene sincronizzato con HubSpot.
Per impostazione predefinita, il campo "ID proprietario " presente in un record di lead, contatto, account o opportunità di Salesforce verrà sincronizzato con la proprietà " Proprietario del contatto/azienda/opportunità " di HubSpot.
Come funziona la sincronizzazione del proprietario
Qualsiasi proprietario di Salesforce può essere sincronizzato con HubSpot, ma solo i proprietari in HubSpot che corrispondono al nome e all’indirizzo e-mail di un utente Salesforce attivo verranno sincronizzati con Salesforce. Se HubSpot tenta di sincronizzare un proprietario che non esiste in Salesforce, il campo "ID proprietario " verrà reimpostato sull’ultimo valore proveniente da Salesforce.
Le regole di assegnazione dei proprietari in Salesforce variano a seconda che si tratti di contatti, aziende o opportunità. A seconda della regola, HubSpot può creare un nuovo oggetto in Salesforce o sincronizzarlo con un oggetto esistente in Salesforce. Se utilizzi la sincronizzazione della timeline, scopri di più su come vengono sincronizzati i proprietari per le attività.
Comportamento dell’assegnazione del proprietario dei contatti
Se un contatto HubSpot crea un nuovo lead in Salesforce e gli viene assegnato un proprietario HubSpot che corrisponde al nome e all’indirizzo email di un utente Salesforce attivo prima della prima sincronizzazione con Salesforce, tale proprietario verrà assegnato in Salesforce. In caso contrario, si applicheranno le regole di assegnazione dei lead di Salesforce .
Dopo l’assegnazione iniziale del responsabile in HubSpot o in Salesforce, le modifiche apportate alla proprietà “Responsabile del contatto ” in HubSpot o al campo “ID responsabile” in Salesforce verranno sincronizzate con l’altro sistema.
Se un contatto HubSpot viene sincronizzato con un lead Salesforce esistente che ha già un responsabile attivo in Salesforce, le regole di assegnazione dei lead di Salesforce non verranno applicate e il responsabile esistente in Salesforce verrà mantenuto alla prima sincronizzazione. Nelle sincronizzazioni successive, il valore più recente del responsabile aggiornerà il valore nell’altro sistema.
Nota: Salesforce richiede che i record abbiano valori di "Proprietario". Quando un record HubSpot non assegnato viene sincronizzato con Salesforce e viene creato un nuovo record, il suo "Proprietario" verrà impostato sull'utente di Salesforce che lo ha creato, ovvero l'utente di integrazione nell'account HubSpot.
Mappare i campi di riferimento di Salesforce su HubSpot
I valori dei campi di riferimento di Salesforce vengono sincronizzati su HubSpot come ID record a 18 cifre, non come etichette. Sebbene HubSpot non possa recuperare automaticamente queste etichette, è possibile mappare i campi di riferimento di Salesforce a una proprietà a discesa di HubSpot per rendere i valori utilizzabili per la segmentazione e la reportistica in HubSpot.
- Nel tuo account HubSpot, crea una proprietà personalizzata HubSpot con uncampo a selezione a discesa.
- Associa il campo di riferimento di Salesforce alla proprietà personalizzata di HubSpot appena creata.
- Nel tuo account HubSpot, fai clic sulle
icona delle impostazioni nella barra di navigazione principale. - Nel menu della barra laterale sinistra, vai suProprietà.
- Fai clic sulnome della proprietà personalizzata utilizzata nella mappatura dei campi.
- Nel menu della barra laterale sinistra, clicca su Tipo di campo.
- Nella sezione " Opzioni del menu a tendina ", la colonna " Nome interno " mostrerà l'ID record a 18 cifre corrispondente a ciascun valore del campo di riferimento proveniente da Salesforce. Inserisci le etichette corrispondenti ai valori dei campi di Salesforce nei campi"Etichetta ".
- In alto a destra, fare clic su Salva.
Ora potrai segmentare il campo di riferimento in base alle etichette dei valori del campo, anziché agli ID dei record dei valori del campo.
Risolvere gli errori di mappatura dei campi
Quando una mappatura dei campi presenta errori o deve essere aggiornata, i dati potrebbero non essere trasferiti tra HubSpot e Salesforce. Per correggere o aggiornare le mappature dei campi:
- Nel tuo account HubSpot, fai clic sull'
icona delle impostazioni nella barra di navigazione principale. Nel menu della barra laterale sinistra, vai a Integrazioni > App connesse. - Fare clic suSalesforce.
- Accedere alla scheda Sincronizzazione dati.
- Nella scheda Stato sincronizzazione,se sono presenti errori o avvisi di sincronizzazione, questi appariranno nella sezione " Errori di sincronizzazione ". Fai clic sul tipo di errore di sincronizzazione per visualizzare ulteriori informazioni, i record interessati e intraprendere ulteriori azioni.
- Se una mappatura include un campo a elenco di selezione di Salesforce, puoi aggiornare il campo per verificare la presenza di nuove opzioni nell’elenco di selezione in Salesforce e aggiungere le opzioni alla proprietà del menu a discesa corrispondente in HubSpot. Per farlo, passa il mouse sulla mappatura e clicca su Aggiorna.
Nota: durante la risincronizzazione in blocco delle mappature dei campi relativi ad aziende/account, HubSpot non può sincronizzare più di 200.000 aziende contemporaneamente. Ciò può causare l’errore "Impossibile sincronizzare tutti gli aggiornamenti per questa mappatura".
Eliminare le mappature dei campi personalizzate
Se non desideri più sincronizzare i dati tra una proprietà di HubSpot e un campo di Salesforce in una mappatura dei campi personalizzata, puoi eliminare la mappatura.
Nota: in HubSpotè possibile eliminare solo le mappature dei campi personalizzate. Sebbene le mappature dei campi standard non possano essere eliminate, è possibile interrompere la sincronizzazione dei dati impostando la regola di aggiornamento su "Non sincronizzare". Ciò non si applica allaproprietà " Noniscritto a tuttele email".
- Nel tuo account HubSpot, fai clic sull'
icona delle impostazioni nella barra di navigazione principale. Nel menu della barra laterale sinistra, vai a Integrazioni > App connesse. - Fai clic suSalesforce.
- Accedi alla scheda Sincronizzazione dati.
- Nel menu della barra laterale sinistra, cfai clic sulla scheda dell’oggetto relativa alla tua mappatura.
- Quindi fare clic su Mappature delle proprietà.
- Passa il mouse sulla mappatura e fai clic su "Elimina mappatura".

Esportare le mappature dei campi
Per esportare l’elenco delle mappature dei campi:
- Nel tuo account HubSpot, fai clic sull'
icona delle impostazioni nella barra di navigazione principale. Nel menu della barra laterale sinistra, vai a Integrazioni > App connesse. - Fare clic suSalesforce.
- Accedi alla scheda " Sincronizzazione dati ".
- Nel menu della barra laterale sinistra,fai clic sulla scheda dell'oggetto relativa alle mappature che desideri esportare.
- Quindi fare clic su Mappature delle proprietà.
- Fare clic suEsporta mappature dei campi (CSV).
