Gestire le chiamate API per l'integrazione con Salesforce e gli errori di sincronizzazione
Ultimo aggiornamento: 27 maggio 2025
Disponibile con uno qualsiasi dei seguenti abbonamenti, tranne dove indicato:
|
|
|
|
|
L'integrazione HubSpot-Salesforce può presentare errori di sincronizzazione che impediscono la sincronizzazione dei dati. È possibile identificare e risolvere questi errori di sincronizzazione nelle impostazioni dell'integrazione con Salesforce.
Chiamata api: regolare il limite di chiamata 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.
- Nel prospetto delle app entrate in contatto, fare clic su Salesforce.
- Nella scheda Stato sincronizzazione, nella sezione Uso chiamate API , visualizzare il numero di chiamate API utilizzate nelle ultime 24 ore. La cifra Limitata da Salesforce è l'importo delle chiamate API che è possibile effettuare in base alle impostazioni di Salesforce. Per regolare il numero di chiamate assegnate a HubSpot, modificare il campo Allocated to HubSpot.
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.
- Nel prospetto delle app entrate in contatto, fare clic su Salesforce.
- Nella scheda Stato sincronizzazione, alla voce Errori di sincronizzazione, sono visualizzate le schede per ogni tipo di errore, con il numero di errori correnti e di record interessati. 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.
- Per visualizzare ulteriori dettagli su un errore, fare clic sull'icona info info nella colonna Tipo di errore .
- Per intervenire sui 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 Esportazione errori (CSV) in alto a sinistra nell'elenco degli errori.

Tipi di errore di sincronizzazione di Salesforce
Associazioni
Esempi di errori delle associazioni
- Limite di associazioni raggiunto
- In attesa della sincronizzazione dell'account
Cosa significano gli errori
I record non si sincronizzano perché sono associati ad Account di Salesforce che non sono ancora stati sincronizzati con le Aziende di HubSpot, oppure perché sono associati a record che hanno raggiunto il limite di associazione del record di HubSpot.
Come risolvere gli errori
Per risolvere l'errore relativo al limite di Associazione raggiunto , è possibile rimuovere alcuni dei record associati o associare questi ultimi a un altro record di Salesforce, quindi procedere con la sincronizzazione.
Per risolvere l'errore di Attesa per la sincronizzazione degli account , si consiglia di eseguire l'importazione degli account di Salesforce.
Codice per i clienti
Esempi di errori del codice personalizzato
- Automazioni di 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 automazioni, flussi o regole di convalida nel vostro 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
- E-mail già in uso
- Regola di duplicazione di 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 del contatto di HubSpot o a causa di una regola di deduplicazione in Salesforce.
Come risolvere gli errori
Per risolvere l'errore E-mail già in uso, rimuovere l'indirizzo e-mail dal contatto HubSpot esistente.
Per risolvere l'errore di regola duplicata di Salesforce , si consiglia di controllare le regole di deduplicazione impostate in Salesforce.
Permessi
Esempi di errori di autorizzazione
- 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 entrato in contatto 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 di Salesforce mancante si verifica quando l'integrazione tenta di aggiornare un campo di Salesforce con un valore errato o di creare un'associazione errata.
Per risolvere l'errore di autorizzazione del campo Salesforce , assicurarsi che l'utente dell'integrazione Salesforce abbia le autorizzazioni di lettura e modifica del campo in Salesforce.
L'errore di accesso insufficiente a Salesforce si verifica quando l'utente dell'integrazione Salesforce non può eseguire l'azione in Salesforce a causa delle sue autorizzazioni in Salesforce. Si consiglia di controllare le autorizzazioni dell'utente dell'integrazione Salesforce in Salesforce.
Elenchi di selezione
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 del 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 un picklist in un sistema non corrisponde a nessun valore corrente nell'altro, se il 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 State deve esistere come opzione Available State/Province per il valore Country 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 di proprietario inattivo di Salesforce, riassegnare il record di HubSpot a un utente attivo in Salesforce.
L'errore di valore limitato della picklist si verifica quando l'impostazione Limita la picklist ai valori definiti nel set di valori è 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 del set 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, cambiate lo stage dell'opportunità in Salesforce in attivo o spostate l'opportunità in uno stage attivo.
Per risolvere l'errore dei proprietari di Salesforce non sincronizzati, assicurarsi che gli utenti di Salesforce abbiano il tipo di utente impostato su Standard, Power Partner o Guest in Salesforce.
Per risolvere l'errore Limite di opzioni superato, si consiglia di eliminare le opzioni di proprietà extra in HubSpot e Salesforce che il team non utilizza. Inoltre, assicuratevi che tutte le mappature della proprietà 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 Record Types in Salesforce, ma non li state usando, o se avete opportunità in Salesforce senza un Record Type, si consiglia di lavorare con Salesforce per disattivare tutti i Record Types o creare un nuovo Record Type.
Per risolvere l'errore Missing or invalid opportunity stage, assicurarsi che il valore dell'opportunity stage di Salesforce esista nella pipeline di HubSpot.
Mappature della proprietà
Esempi di errori di mappatura della 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 della proprietà di HubSpot e del 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 di mancata corrispondenza del tipo, 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 Invalid Salesforce ID, si consiglia di controllare la regola di convalida personalizzata impostata in Salesforce.
Valori di proprietà
Esempi di errori nei valori di proprietà
- Stringa troppo lunga
- E-mail 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 E-mail non valida , aggiornate la formattazione dell'indirizzo e-mail sul record di Record che sta cercando di sincronizzarsi 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 State deve esistere come opzione Available State/Province per il valore Country 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 di valore non valido, si consiglia di aggiornare il valore della proprietà nel record di Salesforce per soddisfare i requisiti di HubSpot per il valore della proprietà.
Nella maggior parte dei casi, l'errore di assegnazione del proprietario si verifica quando un'attività di HubSpot si sincronizza con Salesforce come attività di Salesforce e HubSpot tenta di assegnare l'attività al proprietario di una coda di task di Salesforce.
Per risolvere l'errore di valore univoco limitato, si consiglia di controllare le regole di corrispondenza per la deduplicazione impostate in Salesforce.
Per risolvere l'errore " Missing required value" (valore obbligatorio mancante), aggiungete un valore al record di Salesforce per qualsiasi proprietà contrassegnata come obbligatoria in HubSpot.
Altro
I record non vengono sincronizzati a causa di un errore sconosciuto. Si prega di contattare l'Assistente HubSpot per ulteriore assistenza su questi errori.
Nota: è possibile sincronizzare in blocco 100 errori di Salesforce alla volta. Per sincronizzare più di 100 errori, importare i record da Salesforce o aggiornare una mappatura della proprietà.
Impostare le notifiche di errore 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.
- Nel prospetto delle app entrate in contatto, fare clic su Salesforce.
- Fare clic sulla scheda Stato sincronizzazione.
- In Errori di sincronizzazione, fare clic su Gestisci notifiche.
- Nella finestra di dialogo, attivare l'interruttore Attiva notifiche.
- Selezionare il pulsante di selezione accanto a Immediatamente, Giornalmente o Settimanalmente per impostare la frequenza delle notifiche.
- Fare clic su Salva.