Salta al contenuto
Nota bene: la traduzione in italiano di questo articolo è fornita solo per comodità. La traduzione viene creata automaticamente tramite un software di traduzione e potrebbe non essere stata revisionata. Pertanto, la versione inglese di questo articolo deve essere considerata come la versione di governo contenente le informazioni più recenti. È possibile accedervi qui.

Mappare le proprietà di HubSpot nei campi di Salesforce

Ultimo aggiornamento: 15 ottobre 2025

Disponibile con uno qualsiasi dei seguenti abbonamenti, tranne dove indicato:

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

  1. 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.
  2. Nell'elenco delle applicazioni collegate, fare clic su Salesforce.
  3. Fare clic sulla scheda dell'oggetto che si desidera mappare: Contatti, Aziende o Contratti.
  4. 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.

Screenshot showing the tab to create contact property mappings for the Salesforce integration in HubSpot.
  1. Per aggiungere una nuova riunione di campi, fare clic su Aggiungi nuova mappatura di campo.
  2. 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.

Screenshot showing an error message in HubSpot when the selected property is already mapped or if there is a type mismatch.

  1. Fare clic su Avanti.

Selezionare una regola di sincronizzazione

  1. 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.
      • 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.

Screenshot showing how to select the sync rule for a new property mapping in HubSpot.


Nota bene:
  • 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.
  1. 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.

Screenshot showing the sync toggle for the Company object.

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:

  1. 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.
  2. Fare clic su Salesforce.
  3. Fare clic sulla scheda Sync Health.
  4. 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.
  5. 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.

  1. 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.
  2. Fare clic su Salesforce.
  3. Fare clic sulla scheda dell'oggetto per la mappatura: Contatti, Aziende o Contratti.
  4. Fare clic sulla scheda delle mappature delle proprietà [Oggetto].
  5. Passare il mouse sulla mappatura e fare clic su Elimina mappatura.

Screenshot showing the option to delete a mapping.

Esportare le mappature dei campi

Per esportare l'elenco delle mappature dei campi:

  1. 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.
  2. Fare clic su Salesforce.
  3. Fare clic sulla scheda dell'oggetto per le mappature che si desidera esportare: Contatti, Aziende o Contratti.
  4. Fare clic sulla scheda [Object] property mappings.
  5. Fare clic su Esporta mappature di campo (CSV).
L'articolo è stato utile?
Questo modulo viene utilizzato solo per il feedback della documentazione. Scopri come ottenere assistenza con HubSpot.