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.

Mappate le proprietà di HubSpot nei campi di Salesforce

Ultimo aggiornamento: 24 aprile 2026

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

Dopo aver installato l'integrazione HubSpot-Salesforce, associa le proprietà di HubSpot ai campi di Salesforce per garantire la coerenza dei dati su entrambi i sistemi. Una volta associati i campi, gli aggiornamenti effettuati in un sistema possono sincronizzarsi con l'altro, a seconda delle impostazioni di sincronizzazione. 

Ad esempio, puoi mappare una proprietà di un contatto HubSpot come " Posizione lavorativa " a un campo lead o contatto di Salesforce per mantenere i record allineati su entrambe le piattaforme. 

Crea o modifica le mappature dei campi

Aggiungi una nuova mappatura 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. Nell'elenco delle app collegate, clicca su Salesforce.
  3. Passa alla scheda Sincronizzazione dati
  4. Nel menu della barra laterale sinistra,seleziona la scheda relativa all'oggetto che desideri mappare. 
  5. 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.

  1. Per aggiungere una nuova mappatura di campo, clicca su Aggiungi nuova mappatura di campo
  2. Nel pannello di destra, usa i menu a discesa per selezionare la proprietà di HubSpot e il campo di Salesforce che desideri mappare. Per creare una mappatura, devi selezionare proprietà e campi compatibili. La tabella seguente mostra i tipi di campo delle proprietà di HubSpot che possono essere sincronizzati con Salesforce, i nomi API corrispondenti e i tipi di campo di 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 Elenco a selezione multipla
Casella di controllo singola booleano
Numero doppio/intero
Testo a riga singola stringa, area di testo
Testo multilinea area di testo
Selettore data data, data e ora

Nota:

  • Se si verifica una discrepanza di tipo o se una delle proprietà o dei campi selezionati è già mappata, verrà visualizzato un messaggio sopra i menu a discesa. Clicca sul messaggio per saperne di più.
  • Le proprietà personalizzate con il tipo di campo utente HubSpot non possono essere mappate ai campi di Salesforce.

 

  1. Fai clic su Avanti.

Seleziona una regola di sincronizzazione

  1. La regola di sincronizzazione per la mappatura determina come i dati verranno sincronizzati tra HubSpot e Salesforce. Seleziona una regola di sincronizzazione tra le seguenti opzioni:
    • Preferisci Salesforce se non vuoto
      • HubSpot trasmetterà un valore a Salesforce solo se al momento non è presente alcun valore in Salesforce.
      • Se in Salesforce è presente un valore, questo valore sovrascriverà sempre il valore esistente in HubSpot.
      • Se elimini il valore in Salesforce, il valore verrà eliminato anche in HubSpot.
    • Utilizza 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.

Nota:
  • Sebbene il tuo account HubSpot possa mostrare " Preferisci Salesforce se non vuoto " per la mappatura Proprietario, la mappatura 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, puoi risincronizzare manualmente il record in HubSpot dalla scheda Sincronizzazione con Salesforce, risincronizzare un segmento HubSpot per sincronizzare in blocco i valori su Salesforce oppure eseguire un'importazione da Salesforce per sincronizzare in blocco i valori su HubSpot.
  1. Fai clic su Salva per salvare la mappatura.

La nuova mappatura apparirà ora nell'elenco delle mappature per l'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 facendo clic 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:

  • Sono importati in HubSpot da Salesforce.
  • L'utente di Salesforce possiede un record di lead, contatto, account o opportunità che si sincronizza con HubSpot.

Per impostazione predefinita, il campo ID proprietario su 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 dei proprietari

Qualsiasi proprietario di Salesforce può sincronizzarsi 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 di Salesforce differiscono per contatti, aziende e opportunità. A seconda della regola, HubSpot può creare un nuovo oggetto in Salesforce o sincronizzarsi con un oggetto Salesforce esistente. 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 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, quel proprietario verrà assegnato in Salesforce. In caso contrario, si applicheranno le regole di assegnazione dei lead di Salesforce .

Dopo l'assegnazione iniziale del proprietario in HubSpot o in Salesforce, le modifiche alla proprietà Proprietario del contatto in HubSpot o al campo ID proprietario in Salesforce verranno sincronizzate con l'altro sistema.

Se un contatto HubSpot si sincronizza con un lead Salesforce esistente con un proprietario Salesforce attivo, le regole di assegnazione dei lead di Salesforce non si applicheranno e il proprietario Salesforce esistente verrà mantenuto alla prima sincronizzazione. Nelle sincronizzazioni successive, il valore del proprietario più recente aggiornerà il valore nell'altro sistema.

Nota: Salesforce richiede che i record abbiano valori di Proprietario. Quando un record HubSpot non assegnato si sincronizza con Salesforce e viene creato un nuovo record, il suo Proprietario verrà impostato sull'utente 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. 

  1. Nel tuo account HubSpot, crea una proprietà personalizzata HubSpot con uncampo a selezione a discesa.
  2. Mappa il campo di riferimento di Salesforce alla proprietà personalizzata di HubSpot appena creata.
  3. Nel tuo account HubSpot, fai clic sulle settings icona delle impostazioni nella barra di navigazione principale.
  4. Nel menu della barra laterale sinistra, vai suProprietà.
  5. Fai clic sulnome della proprietà personalizzata utilizzata nella mappatura dei campi.
  6. Nel menu della barra laterale sinistra, clicca su Tipo di campo
  7. Nella sezione "Opzioni a discesa ", la colonna "Nome interno" mostrerà l'ID record a 18 cifre corrispondente a ciascun valore del campo di riferimento di Salesforce. Inserisci le etichette dei valori dei campi corrispondenti di Salesforce nei campi"Etichetta ".
  8. 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 record dei valori del campo.

Nota: questo metodo richiede una manutenzione continua. Se un nuovo valore viene aggiunto al campo di riferimento di Salesforce, l'etichetta dell'opzione corrispondente nella proprietà di HubSpot deve essere modificata manualmente seguendo i passaggi sopra indicati.

Risolvi gli errori di mappatura dei campi

Quando una mappatura dei campi 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. Fai clic suSalesforce.
  3. Passa alla scheda Sincronizzazione dati
  4. Nella scheda Stato sincronizzazione,se sono presenti errori o avvisi di sincronizzazione, questi appariranno nella sezione Errori di sincronizzazione. Clicca sul tipo di errore di sincronizzazione per visualizzare ulteriori informazioni, i record interessati e intraprendere ulteriori azioni. 
  5. 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 tendina corrispondente in HubSpot. Per farlo, passa il mouse sulla mappatura e clicca su Aggiorna

Nota: durante la risincronizzazione in blocco delle mappature dei campi azienda/account, HubSpot non può sincronizzare più di 200.000 aziende contemporaneamente. Ciò può causare l'errore "Non è stato possibile sincronizzare tutti gli aggiornamenti per questa mappatura ".

Eliminare le mappature dei campi personalizzati

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 personalizzati. 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 e-mail". 

  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. Fai clic suSalesforce.
  3. Passa alla scheda Sincronizzazione dati
  4. Nel menu della barra laterale sinistra,sulla scheda dell'oggetto relativa alla mappatura. 
  5. Quindi fare clic su Mappature delle proprietà
  6. Passa con il mouse sulla mappatura e clicca suElimina mappatura.

Esporta 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. Fai clic suSalesforce
  3. Passa alla scheda Sincronizzazione dati
  4. Nel menu della barra laterale sinistra,seleziona la scheda dell'oggetto relativa alle mappature che desideri esportare. 
  5. Quindi fare clic su Mappature delle proprietà
  6. Fai clic suEsporta mappature dei campi (CSV)
L'articolo è stato utile?
Questo modulo viene utilizzato solo per il feedback della documentazione. Scopri come ottenere assistenza con HubSpot.