- Knowledge base
- Account & Configurazione
- Integrazioni
- Mappare le proprietà di HubSpot nei campi di Salesforce
Mappare le proprietà di HubSpot nei campi di Salesforce
Ultimo aggiornamento: 15 ottobre 2025
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, è possibile impostare e gestire la sincronizzazione tra le proprietà di HubSpot e i campi di Salesforce per i contatti, le aziende e le offerte.
Creare o modificare le mappature dei campi
Aggiungere una nuova mappatura di campo
- Nel tuo account HubSpot, fai clic sull'settingsicona delle impostazioni nella barra di navigazione principale. Nel menu della barra laterale sinistra, vai a Integrazioni > App connesse.
- Nell'elenco delle applicazioni collegate, fare clic su Salesforce.
- Fare clic sulla scheda dell'oggetto che si desidera mappare: Contatti, Aziende o Contratti.
- Fare clic sulla scheda [Object] property mappings.
Nota bene: la sincronizzazione degli oggetti deve essere attivata per le aziende o le transazioni tra HubSpot e Salesforce per impostare le mappature dei campi delle aziende o delle transazioni.
- Per aggiungere una nuova riunione di campi, fare clic su Aggiungi nuova mappatura di campo.
- Nel pannello di destra, utilizzare i menu a discesa per selezionare la proprietà HubSpot e il campo Salesforce che si desidera mappare. Per creare una mappatura è necessario selezionare proprietà e campi compatibili. La tabella seguente mostra i tipi di campo della 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 Salesforce |
| Selezione a discesa/Selezione radio | elenco a scelta, riferimento |
| Caselle di controllo multiple | lista multipla |
| Casella di controllo singola | booleano |
| Numero | doppio/int |
| Testo a riga singola | stringa, textarea |
| Testo multilinea | textarea |
| Selezionatore di date | data, data e ora |
Attenzione:
- Se c'è una mancata corrispondenza di tipo o se una delle proprietà o dei campi selezionati è già mappata, viene visualizzato un messaggio sopra i menu a discesa. Fare clic sul messaggio per saperne di più.
- Le proprietà personalizzate con il tipo di campo utente di HubSpot non possono essere mappate nei campi di Salesforce.

- Fare clic su Avanti.
Selezionare una regola di sincronizzazione
- La regola di sincronizzazione per la mappatura determina il modo in cui i dati saranno sincronizzati tra HubSpot e Salesforce. Selezionare una regola di sincronizzazione tra le seguenti opzioni:
-
- Preferisci Salesforce se non vuoto
- HubSpot passerà un valore a Salesforce solo se al momento non c'è alcun valore in Salesforce.
- Preferisci Salesforce se non vuoto
-
-
- Se esiste un valore in Salesforce, questo valore sovrascriverà sempre il valore esistente in HubSpot.
- Se si elimina un valore in Salesforce, il valore verrà eliminato anche in HubSpot.
- Utilizzare sempre Salesforce
- HubSpot non passerà mai i dati a Salesforce, anche se non c'è alcun valore in Salesforce.
- Se c'è un valore in Salesforce, questo verrà sempre sovrascritto al valore esistente in HubSpot.
- Se si elimina un valore in Salesforce, il valore viene eliminato anche in HubSpot.
- A doppio senso
- Il valore più recente sovrascrive sempre tutti i valori esistenti.
- Se il valore viene eliminato in HubSpot, verrà eliminato anche in Salesforce e viceversa.
- Non sincronizzare
- I dati non passeranno mai tra HubSpot e Salesforce.
- Se il valore viene eliminato in HubSpot, non verrà eliminato in Salesforce e viceversa.
-

- Sebbene il vostro account HubSpot possa mostrare Preferisco Salesforce a meno che non sia vuoto per la mappatura del Proprietario, la mappatura del Proprietario può essere mappata 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, è possibile risincronizzare manualmente il record in HubSpot dalla scheda di sincronizzazione di Salesforce, risincronizzare un segmento di HubSpot per sincronizzare in blocco i valori in Salesforce o eseguire un'importazione di Salesforce per sincronizzare in blocco i valori in HubSpot.
- Fare clic su Salva per salvare la mappatura.
La nuova mappatura apparirà nell'elenco delle mappature per l'oggetto selezionato. Per modificare una mappatura esistente, passarci sopra e fare clic su Modifica mappatura.
Una volta aggiunte le mappature, è possibile iniziare a sincronizzare l'oggetto selezionato con Salesforce facendo clic per attivare l'interruttore Sync [Object]. Per i contatti, questa funzione è attivata per impostazione predefinita e non può essere disattivata.

Nota bene: c'è un limite di 500 mappature di campo per oggetto.
Risolvere gli errori di mappatura dei campi
Quando una mappatura di campo presenta errori o deve essere aggiornata, i dati potrebbero non essere in grado di passare tra HubSpot e Salesforce. Per correggere o aggiornare le mappature dei campi:
- Nel tuo account HubSpot, fai clic sull'settingsicona delle impostazioni nella barra di navigazione principale. Nel menu della barra laterale sinistra, vai a Integrazioni > App connesse.
- Fare clic su Salesforce.
- Fare clic sulla scheda Sync Health.
- Se sono presenti errori di sincronizzazione o avvisi, questi appariranno nella sezione Errori di sincronizzazione. Fare clic sul tipo di errore di sincronizzazione per visualizzare ulteriori informazioni, i record interessati e intraprendere ulteriori azioni.
- Se una mappatura include un campo picklist di Salesforce, è possibile aggiornare il campo per verificare la presenza di nuove opzioni picklist in Salesforce e aggiungere le opzioni alla proprietà del menu a discesa corrispondente in HubSpot. A tal fine, passare il mouse sulla mappatura e fare clic su Aggiorna.
Attenzione: durante la risincronizzazione in blocco delle mappature dei campi azienda/account, HubSpot non può sincronizzare più di 200.000 aziende contemporaneamente. Ciò può causare un errore Non è stato possibile sincronizzare tutti gli aggiornamenti per questa mappatura.
Eliminare le mappature dei campi personalizzati
Se non si desidera più sincronizzare i dati tra una proprietà di HubSpot e un campo di Salesforce in una mappatura di campo personalizzata, è possibile eliminare la mappatura.
Nota bene: solo le mappature di campo personalizzate possono essere eliminate in HubSpot. Mentre le mappature di campo standard non possono essere eliminate, la sincronizzazione dei dati può essere interrotta impostando la regola di aggiornamento su Non sincronizzare. Questo non si applica alla proprietà Unsubscribed from all email contact.
- Nel tuo account HubSpot, fai clic sull'settingsicona delle impostazioni nella barra di navigazione principale. Nel menu della barra laterale sinistra, vai a Integrazioni > App connesse.
- Fare clic su Salesforce.
- Fare clic sulla scheda dell'oggetto per la mappatura: Contatti, Aziende o Contratti.
- Fare clic sulla scheda delle mappature delle proprietà [Oggetto].
- Passare il mouse sulla mappatura e fare clic su Elimina mappatura.

Esportare le mappature dei campi
Per esportare l'elenco delle mappature dei campi:
- Nel tuo account HubSpot, fai clic sull'settingsicona delle impostazioni nella barra di navigazione principale. Nel menu della barra laterale sinistra, vai a Integrazioni > App connesse.
- Fare clic su Salesforce.
- Fare clic sulla scheda dell'oggetto per le mappature che si desidera esportare: Contatti, Aziende o Contratti.
- Fare clic sulla scheda [Object] property mappings.
- Fare clic su Esporta mappature di campo (CSV).
