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 ai campi di Salesforce

Ultimo aggiornamento: 27 luglio 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 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

  1. 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.
  2. Nell’elenco delle app collegate, clicca su Salesforce.
  3. Accedere alla scheda " Sincronizzazione dati ". 
  4. Nel menu della barra laterale sinistra,fai clic sulla 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.

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

 

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

  1. Fai clic su Avanti.

Seleziona una regola di sincronizzazione

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

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

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

Screenshot showing the sync toggle for the Company object.

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. 

  1. Nel tuo account HubSpot, crea una proprietà personalizzata HubSpot con uncampo a selezione a discesa.
  2. Associa il campo di riferimento di Salesforce alla proprietà personalizzata di HubSpot appena creata.
  3. Nel tuo account HubSpot, fai clic sulle 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 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 ".
  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 dei record dei valori del campo.

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

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:

  1. 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.
  2. Fare clic suSalesforce.
  3. Accedere alla scheda Sincronizzazione dati
  4. 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. 
  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 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". 

  1. 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.
  2. Fai clic suSalesforce.
  3. Accedi alla scheda Sincronizzazione dati
  4. Nel menu della barra laterale sinistra, cfai clic sulla scheda dell’oggetto relativa alla tua mappatura. 
  5. Quindi fare clic su Mappature delle proprietà
  6. Passa il mouse sulla mappatura e fai 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'icona delle impostazioni nella barra di navigazione principale. Nel menu della barra laterale sinistra, vai a Integrazioni > App connesse.
  2. Fare clic suSalesforce
  3. Accedi alla scheda " Sincronizzazione dati ". 
  4. Nel menu della barra laterale sinistra,fai clic sulla scheda dell'oggetto relativa alle mappature che desideri esportare. 
  5. Quindi fare clic su Mappature delle proprietà
  6. Fare 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.