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.

Gestione delle chiamate API per l'integrazione di Salesforce e degli errori di sincronizzazione

Ultimo aggiornamento: 3 settembre 2025

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

L'integrazione HubSpot-Salesforce può incontrare errori di sincronizzazione, che impediscono la sincronizzazione dei dati. È possibile identificare e risolvere questi errori di sincronizzazione nelle impostazioni dell'integrazione Salesforce.

Regolare il limite delle chiamate API

  • 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 connesse, fare clic su Salesforce.
  • Nella scheda Sync Health, nella sezione API call use , visualizzare il numero di chiamate API utilizzate nelle ultime 24 ore. Il numero limitato da Salesforce è la quantità di chiamate API che è possibile effettuare in base alle impostazioni di Salesforce. Per regolare il numero di chiamate che possono essere assegnate a HubSpot, modificare il campo Allocated to HubSpot.

sync-health-api-call-use

Visualizza gli errori di sincronizzazione di Salesforce

  • 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.
  • Nella scheda Sync Health, alla voce Sync errors, sono visualizzate le schede per ogni tipo di errore, con il numero di errori correnti e di record impattati. Fare clic su una scheda di tipo di errore per visualizzare i dettagli degli errori nel pannello di destra. Per saperne di più su ciascun tipo di errore e sulle raccomandazioni per la risoluzione.

sync-health-sync-errors

  • Per visualizzare ulteriori dettagli su un errore, fare clic sull'icona info nella colonna Tipo di errore .
  • Per intervenire su singoli record, fare clic su [#] record nella colonna Record interessati, quindi fare clic su Azioni > Crea una vista temporanea dei record HubSpot per creare una vista filtrata dei record interessati.
  • Una volta risolti gli errori, tornate all'elenco degli errori. Selezionare la casella di controllo a sinistra degli errori risolti e fare clic su Risincronizza.
  • Per esportare gli errori, fare clic su Esporta errori (CSV) in alto a sinistra nell'elenco degli errori.
screenshot showing the button to export Salesforce sync errors in HubSpot

Tipi di errori di sincronizzazione Salesforce

Associazioni

Esempi di errori di associazione

  • Limite di associazione raggiunto
  • In attesa della sincronizzazione dell'account

Cosa significano gli errori

I record non vengono sincronizzati perché sono associati ad account Salesforce che non sono ancora stati sincronizzati con le aziende HubSpot, oppure perché sono associati a record che hanno raggiunto il limite di associazione dei record di HubSpot.

Come risolvere gli errori

Per risolvere l'errore Limite di associazione raggiunto , è possibile rimuovere alcuni dei record associati o associarli a un record Salesforce diverso, quindi procedere con la sincronizzazione.

Per risolvere l'errore Waiting for account to sync , si consiglia di eseguire un'importazione degli account Salesforce.

Codice personalizzato

Esempi di errori del codice personalizzato

  • Automazione Salesforce
  • ID contatto mancante
  • Regola di convalida del campo personalizzato di Salesforce
  • Flusso Salesforce

Cosa significano gli errori

I record non vengono sincronizzati a causa di un problema causato da automazione, flussi o regole di convalida nell'account Salesforce.

Come risolvere gli errori

Poiché questi errori hanno origine in Salesforce, si consiglia di collaborare con l'amministratore di Salesforce per risolvere il problema nel codice personalizzato di Salesforce.

Duplicati

Esempi di errori di duplicazione

  • Email già in uso
  • Regola di duplicazione Salesforce

Cosa significano gli errori

Un lead o un contatto di Salesforce non può essere sincronizzato con HubSpot perché l'indirizzo e-mail esiste già in un record di contatto di HubSpot o a causa di una regola di deduplicazione in Salesforce.

Come risolvere gli errori

Per risolvere l'errore Email già in uso, rimuovere l'indirizzo e-mail dal contatto HubSpot esistente.

Per risolvere l'errore della regola di duplicazione di Salesforce , si consiglia di controllare le regole di deduplicazione impostate in Salesforce.

Permessi

Esempi di errori relativi ai permessi

  • Accesso insufficiente o record Salesforce mancante
  • Autorizzazione del campo Salesforce
  • Accesso insufficiente a Salesforce

Cosa significano gli errori

Le modifiche apportate in HubSpot non possono essere sincronizzate con Salesforce perché l'utente collegato non ha accesso al campo o all'oggetto necessario in Salesforce.

Come risolvere gli errori

Nella maggior parte dei casi, l'errore Accesso insufficiente o record Salesforce mancante si verifica quando l'integrazione tenta di aggiornare un campo Salesforce con un valore errato o di creare un'associazione errata.

Per risolvere l'errore di autorizzazione del campo Salesforce , assicuratevi che l'utente dell'integrazione Salesforce abbia le autorizzazioni di lettura e modifica del campo in Salesforce.

L'errore Accesso insufficiente a Salesforce si verifica quando l'utente dell'integrazione Salesforce non può eseguire l'azione in Salesforce a causa delle sue autorizzazioni utente in Salesforce. Si consiglia di verificare le autorizzazioni dell'utente dell'integrazione Salesforce in Salesforce.

Picklist

Esempi di errori di picklist

  • Opzione picklist Salesforce mancante
  • Valore di stato o paese non corrispondente
  • Opzioni non corrispondenti
  • Proprietario Salesforce non attivo
  • Valore limitato della picklist
  • Fase dell'opportunità non attiva
  • Proprietari Salesforce non sincronizzati
  • Limite di opzioni superato
  • Processo di vendita predefinito non disponibile
  • Fase dell'opportunità mancante o non valida

Cosa significano gli errori

I record non vengono sincronizzati a causa di una discrepanza tra i valori dei campi picklist in HubSpot e Salesforce. Questo può accadere quando il valore di una picklist in un sistema non corrisponde a nessun valore corrente nell'altro, se la picklist ha raggiunto un limite di valori o se il valore passato non è valido.

Come risolvere gli errori

Per risolvere l'errore Mismatched state or country value, si consiglia di verificare che siano soddisfatti i seguenti requisiti:

  • Il valore interno dell'opzione della proprietà Country in HubSpot deve corrispondere a un'opzione Country esistente nelle impostazioni dell'elenco di picklist State e Country/Territory in Salesforce.
  • Il valore Stato deve esistere come opzione Stato/Provincia disponibile per il valore Paese del record in Salesforce. Inoltre, il valore interno dell'opzione della proprietà State in HubSpot deve corrispondere a un'opzione State esistente in Salesforce.

Per risolvere l'errore Mismatched options, si consiglia di aggiornare il nome interno/API delle opzioni del campo Salesforce in modo che corrisponda al valore interno delle opzioni della proprietà in HubSpot.

Per risolvere l'errore Inactive Salesforce owner, riassegnare il record HubSpot a un utente attivo in Salesforce.

L'errore Restricted picklist value si verifica quando l'impostazione Restrict picklist to the values defined in the value set è attivata per il campo in Salesforce. Quando questa impostazione è attiva in Salesforce, il valore che si sta cercando di sincronizzare da HubSpot a Salesforce deve esistere come opzione nell'elenco di scelta di Salesforce. Si consiglia di disattivare la restrizione dell'elenco di opzioni ai valori definiti nell' impostazione dell'insieme di valori in Salesforce, in modo che qualsiasi valore possa essere sincronizzato da HubSpot a Salesforce.

L'errore " Inactive opportunity stage" si verifica quando un'opportunità di Salesforce con uno stage inattivo tenta di sincronizzarsi con HubSpot. Per risolvere questo errore, modificate lo stage dell'opportunità in Salesforce in attivo o spostate l'opportunità in uno stage attivo.

Per risolvere l'errore Proprietari di Salesforce non sincronizzati, assicurarsi che gli utenti di Salesforce abbiano il Tipo di utente impostato su Standard, Power Partner o Ospite in Salesforce.

Per risolvere l'errore Option limit exceeded, si consiglia di eliminare le opzioni di proprietà extra in HubSpot e Salesforce che il team non utilizza. Inoltre, assicuratevi che tutte le proprietà mappate abbiano i tipi di campo corrispondenti.

Nella maggior parte dei casi, l'errore Default sales process unavailable si verifica quando le opportunità di Salesforce tentano di sincronizzarsi con HubSpot con un Record Type mancante. Se avete attivato i tipi di record in Salesforce, ma non li state usando, o avete opportunità Salesforce senza un tipo di record, si consiglia di collaborare con Salesforce per disattivare tutti i tipi di record o creare un nuovo tipo di record.

Per risolvere l'errore Missing or invalid opportunity stage, assicurarsi che il valore dell'opportunity stage di Salesforce esista nella pipeline di HubSpot.

Mappature delle proprietà

Esempi di errori di mappatura delle proprietà

  • Disadattamento del tipo
  • ID Salesforce mancante
  • ID Salesforce non valido

Cosa significano gli errori

I record non vengono sincronizzati a causa di una discrepanza nella mappatura tra la proprietà di HubSpot e il campo di Salesforce. Ciò può significare che i tipi di proprietà e di campo non sono compatibili, che la proprietà o il campo non esistono più o che è necessario creare una mappatura del campo di riferimento di Salesforce.

Come risolvere gli errori

Per risolvere l'errore Type mismatch, assicurarsi che il tipo di proprietà in HubSpot e il tipo di campo in Salesforce siano compatibili. Per saperne di più sui tipi di campo delle proprietà di HubSpot che possono essere sincronizzati con Salesforce.

L'errore ID Salesforce mancante si verifica quando HubSpot ha cercato di sincronizzare un valore diverso da un ID Salesforce esistente con un campo di riferimento/lookup in Salesforce.

Per risolvere l'errore ID Salesforce non valido, si consiglia di controllare la regola di convalida personalizzata impostata in Salesforce.

Valori delle proprietà

Esempi di errori relativi ai valori delle proprietà

  • Stringa troppo lunga
  • Email non valida
  • Paese mancante
  • Valore non valido
  • Assegnazione del proprietario
  • Valore univoco limitato
  • Valore obbligatorio mancante

Cosa significano gli errori

I record non vengono sincronizzati tra HubSpot e Salesforce perché includono valori di proprietà non validi. Questi errori richiedono in genere l'aggiornamento dei singoli record interessati per correggere l'errore.

Come risolvere gli errori

Per risolvere l'errore Stringa troppo lunga, accorciate il valore del campo in Salesforce o HubSpot, oppure aumentate il limite di caratteri del campo in Salesforce.

Per risolvere l'errore Email non valida , aggiornare la formattazione dell'indirizzo email sul record Salesforce che si sta cercando di sincronizzare con HubSpot.

Per risolvere l'errore Missing required country, si consiglia di verificare che siano soddisfatti i seguenti requisiti:

  • Il valore interno dell'opzione della proprietà Country in HubSpot deve corrispondere a un'opzione Country esistente nelle impostazioni dell'elenco di picklist State e Country/Territory in Salesforce.
  • Il valore Stato deve esistere come opzione Stato/Provincia disponibile per il valore Paese del record in Salesforce. Inoltre, il valore interno dell'opzione della proprietà State in HubSpot deve corrispondere a un'opzione State esistente in Salesforce.

Per risolvere l'errore Valore non valido, si consiglia di aggiornare il valore della proprietà sul record Salesforce per soddisfare i requisiti di HubSpot per il valore della proprietà.

Nella maggior parte dei casi, l'errore Assegnazione del proprietario si verifica quando un'attività HubSpot si sincronizza con Salesforce come attività Salesforce e HubSpot tenta di assegnare l'attività al proprietario di una coda Salesforce.

Per risolvere l'errore Valore univoco limitato, si consiglia di controllare le regole di deduplicazione impostate in Salesforce.

Per risolvere l'errore Missing required value, aggiungete un valore al record Salesforce per qualsiasi proprietà contrassegnata come obbligatoria in HubSpot.

Altro

I record non vengono sincronizzati a causa di un errore sconosciuto. Contattare il Supporto HubSpot per ulteriore assistenza su questi errori.

Nota bene: è possibile sincronizzare in blocco 100 errori di Salesforce alla volta. Per sincronizzare più di 100 errori, importare i record da Salesforce o aggiornare una proprietà mappata.

Impostare le notifiche degli errori di sincronizzazione

  • 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 Sync Health.
  • In Errori di sincronizzazione, fare clic su Gestisci notifiche.
  • Nella finestra di dialogo, attivare l'interruttore Attiva notifiche.
  • Selezionare il pulsante di opzione accanto a Immediatamente, Giornalmente o Settimanalmente per impostare la frequenza delle notifiche.
  • Fare clic su Salva.

sync-health-error-notifications

L'articolo è stato utile?
Questo modulo viene utilizzato solo per il feedback della documentazione. Scopri come ottenere assistenza con HubSpot.