Gestione delle chiamate all'API di integrazione con Salesforce e degli errori di sincronizzazione

L'integrazione tra HubSpot e Salesforce potrebbe riscontrare errori di sincronizzazione che impediscono la sincronizzazione dei dati. È possibile individuare e risolvere questi errori di sincronizzazione nelle impostazioni di integrazione di Salesforce.

Modifica il limite delle chiamate API

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, fare clic suSalesforce. 
3. Accedere alla scheda Sincronizzazione dati. 
4. Nella scheda Stato della sincronizzazione, nella sezione Utilizzo delle chiamate API, visualizza quante chiamate API hai utilizzato nelle ultime 24 ore. Il numero "Limitato da Salesforce " indica il numero di chiamate API che puoi effettuare in base alle tue impostazioni di Salesforce. Per modificare il numero di chiamate che possono essere assegnate a HubSpot, modifica il campo Assegnato a HubSpot. 

Visualizza gli errori di sincronizzazione di Salesforce

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 suSalesforce. 
3. Passa alla scheda Sincronizzazione dati. 
4. Nella scheda Stato della sincronizzazione, nellasezioneErrori di sincronizzazione , visualizza le schede relative a ciascun tipo di errore, con il numero di errori attuali e i record interessati. Fai clic sulla scheda di un tipo di errore per visualizzare i dettagli degli errori nel pannello di destra. Scopri di più su ciascun tipo di errore e sui consigli per la risoluzione. 

5. Per visualizzare ulteriori dettagli su un errore, clicca sull’icona delle informazioni nella colonna Tipo di errore .
6. Per intervenire sui singoli record, clicca su [#] record nella colonna Record interessati, quindi clicca su Azioni > Crea una vista temporanea dei record HubSpot per creare una vista filtrata dei record interessati. 
7. Una volta risolti gli errori, torna all’elenco degli errori. Seleziona lacasella di controllo a sinistra di qualsiasi errore risolto e clicca su Risincronizza.
8. Per esportare gli errori, clicca su Esporta errori (CSV) in alto a sinistra nell’elenco degli errori.

Tipi di errori di sincronizzazione di Salesforce

Associazioni

Esempi di errori di associazione 

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

• Discrepanza nella cardinalità delle associazioni

Cosa significano gli errori

I record non vengono sincronizzati perché sono associati ad account 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 dei record di HubSpot. 

L’errore di mancata corrispondenza della cardinalità dell’associazione si verifica quando un’attività associata a più contatti in HubSpot tenta di sincronizzarsi con Salesforce. L’integrazione supporta la sincronizzazione di una sola associazione di contatto per attività.

Come risolvere gli errori 

Per risolvere l’errore “Limite di associazione raggiunto”, puoi rimuovere alcuni dei record associati oppure associarli a un record Salesforce diverso, quindi procedere con la sincronizzazione.

Per risolvere l’errore “In attesa della sincronizzazione dell’account” , si consiglia di eseguire un’importazione degli account di Salesforce. 

Per risolvere l’errore “Disallineamento della cardinalità delle associazioni ”, rimuovi le associazioni di contatti in eccesso in modo che rimanga associato all’attività un solo contatto.

Codice personalizzato

Esempi di errori relativi al codice personalizzato 

• Automazione di Salesforce
• ID contatto mancante
• Regola di convalida dei campi personalizzati di Salesforce
• Flusso di Salesforce

Cosa significano gli errori

I record non vengono sincronizzati a causa di un problema legato all’automazione, ai flussi o alle regole di convalida nel proprio account Salesforce.

Come risolvere gli errori

Duplicati

Esempi di errori relativi ai duplicati

• Indirizzo e-mail già in uso
• Regola di duplicazione in Salesforce

Cosa significano questi 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 “Indirizzo e-mail già in uso ”, rimuovi l’indirizzo e-mail dal contatto HubSpot esistente.

Per risolvere l’errore relativo alla regola di duplicazione di Salesforce , si consiglia a un amministratore di Salesforce di verificare le regole di corrispondenza per la deduplicazione configurate in Salesforce. Successivamente, unisci, aggiorna o elimina eventuali record di Salesforce in conflitto, oppure modifica la regola di deduplicazione in Salesforce, prima di tentare una nuova sincronizzazione in HubSpot.

Autorizzazioni

Esempi di errori relativi alle autorizzazioni

• Accesso insufficiente o record Salesforce mancante
• Autorizzazione per campo in Salesforce
• Accesso a Salesforce insufficiente

Cosa significano gli errori

Le modifiche apportate in HubSpot non possono essere sincronizzate con Salesforce perché l’utente collegato non dispone dell’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 di Salesforce con un valore errato o di creare un’associazione errata. 

Per risolvere l’errore relativo alle autorizzazioni del campo di Salesforce , assicurati che l’utente dell’integrazione con Salesforce disponga delle autorizzazioni di lettura e modifica per il campo in questione in Salesforce. 

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

Elenchi di selezione

Esempi di errori relativi agli elenchi di selezione

• Opzione dell'elenco di selezione di Salesforce mancante
• Valore di stato o paese non corrispondente
• Opzioni non corrispondenti
• Proprietario di Salesforce inattivo
• Valore dell'elenco di selezione soggetto a restrizioni
• Fase dell'opportunità inattiva
• Proprietari di Salesforce non sincronizzati
• Limite delle 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 a elenco di selezione in HubSpot e Salesforce. Ciò può verificarsi quando un valore dell’elenco di selezione in un sistema non corrisponde a nessun valore attuale nell’altro, se l’elenco di selezione ha raggiunto un limite di valori o se il valore passato non è valido.

Come risolvere gli errori

Per risolvere l’errore“Valori di stato o paese non corrispondenti ”, si consiglia di verificare che siano soddisfatti i seguenti requisiti:

• Il valore interno dell'opzione della proprietà "Paese" in HubSpot deve corrispondere a un'opzione "Paese " esistente nelle impostazioni dell'elenco a discesa "Stato e Paese/Territorio " 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à "Stato" in HubSpot deve corrispondere a un’opzione "Stato" esistente in Salesforce. 

Per risolvere l’errore “Opzioni non corrispondenti ”, si consiglia di aggiornare il nome interno/API delle opzioni del campo di Salesforce in modo che corrisponda al valore interno delle opzioni della proprietà in HubSpot. 

Per risolvere l’errore “Proprietario Salesforce inattivo”, riassegna il record di HubSpot a un utente attivo in Salesforce. 

L’errore "Valore dell’elenco di selezione limitato" si verificaquando per il campo in Salesforce è attivata l’impostazione "Limita l’elenco di selezione ai valori definiti nel set di valori ". Quando questa opzione è attivata in Salesforce, il valore che stai cercando di sincronizzare da HubSpot a Salesforce deve esistere come opzione nell’elenco di selezione di Salesforce. Si consiglia di disattivare l’impostazione “Limita l’elenco di selezione ai valori definiti nel set di valori ” in Salesforce, in modo che qualsiasi valore possa essere sincronizzato da HubSpot a Salesforce. 

L’errore "Fase dell’opportunità inattiva" si verifica quando si tenta di sincronizzare con HubSpot un’opportunità di Salesforce con una fase inattiva. Per risolvere questo errore, modifica la fase dell’opportunità in Salesforce impostandola su " Attiva" oppure sposta l’opportunità in una fase attiva. 

Per risolvere l’errore “Proprietari di Salesforce non sincronizzati ”, assicurati che il “Tipo di utente ” degli utenti di Salesforce sia impostato su “Standard”, “Power Partner” o “Ospite ”. 

Per risolvere l’errore " Limite opzioni superato ", si consiglia di eliminare le opzioni di proprietà in eccesso in HubSpot e Salesforce che il tuo team non sta utilizzando. Inoltre, assicurati che tutte le proprietà mappate abbiano tipi di campo corrispondenti. 

Nella maggior parte dei casi, l’errore " Processo di vendita predefinito non disponibile " si verifica quando le opportunità di Salesforce tentano di sincronizzarsi con HubSpot con un "Tipo di record" mancante. Se hai attivato i "Tipi di record" in Salesforce, ma non li stai utilizzando, oppure hai opportunità di Salesforce senza un "Tipo di record", ti consigliamo di collaborare con Salesforce per disattivare tutti i "Tipi di record" o crearne uno nuovo. 

Per risolvere l’errore " Fase dell’opportunità mancante o non valida ", assicurati che il valore della fase dell’opportunità di Salesforce esista nella pipeline di HubSpot.

Per gli errori relativi ai campi delle attività di Salesforce, confronta i valori di "Priorità attività", "Stato" o "Tipo" in Salesforce con le corrispondenti opzioni delle proprietà delle attività in HubSpot. La "Priorità attività" supporta solo i valori "Alta", "Media", "Bassa" e "Nessuna". Per "Stato" e "Tipo", aggiorna i valori di Salesforce in modo che corrispondano esattamente alle opzioni disponibili in HubSpot oppure aggiungi le opzioni corrispondenti in HubSpot.

Mappature delle proprietà

Esempi di errori di mappatura delle proprietà 

• Discrepanza di 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ù oppure che è necessario creare una mappatura del campo di riferimento di Salesforce.

Come risolvere gli errori 

Per risolvere l’errore “Type mismatch”, assicurati che il tipo di proprietà in HubSpot e il tipo di campo in Salesforce siano compatibili. Scopri 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 tentato di sincronizzare un valore diverso da un ID Salesforce esistente con un campo di riferimento/ricerca in Salesforce. 

Per risolvere l’errore " ID Salesforce non valido ", si consiglia di verificare la regola di convalida personalizzata configurata in Salesforce. 

Valori delle proprietà

Esempi di errori relativi ai valori delle proprietà

• Stringa troppo lunga
• Indirizzo e-mail non valido
• Paese obbligatorio mancante
• Valore non valido
• Assegnazione del proprietario
• Valore univoco soggetto a restrizioni
• Valore obbligatorio mancante

Cosa significano gli errori

I record non vengono sincronizzati tra HubSpot e Salesforce perché contengono valori delle proprietà non validi. In genere, per correggere questi errori è necessario aggiornare i singoli record interessati.

Come risolvere gli errori

Per risolvere l’errore “Stringa troppo lunga”, accorcia il valore del campo in Salesforce o HubSpot oppure aumenta il limite di caratteri del campo in Salesforce. 

Per risolvere l’errore "Indirizzo e-mail non valido ", aggiorna la formattazione dell’indirizzo e-mail nel record di Salesforce che si sta tentando di sincronizzare con HubSpot.

Per risolvere l’errore “Paese obbligatorio mancante ”, si consiglia di verificare che siano soddisfatti i seguenti requisiti:

• Il valore interno dell'opzione della proprietà "Paese" in HubSpot deve corrispondere a un'opzione "Paese " esistente nelle impostazioni dell'elenco a discesa "Stato e Paese/Territorio " 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à "Stato" in HubSpot deve corrispondere a un'opzione "Stato" esistente in Salesforce. 

Per risolvere l’errore “Valore non valido ”, si consiglia di aggiornare il valore della proprietà nel record di Salesforce in modo che soddisfi i requisiti di HubSpot per il valore della proprietà. 

Nella maggior parte dei casi, l’errore “Assegnazione del proprietario” si verifica quando un’attività di HubSpot viene sincronizzata su Salesforce come attività di Salesforce e HubSpot tenta di assegnare l’attività al proprietario di una coda di Salesforce.

Per risolvere l'errore " Valore univoco limitato ", si consiglia di verificare le regole di corrispondenza per la deduplicazione configurate in Salesforce. 

Per risolvere l'errore "Valore obbligatorio mancante", aggiungi un valore al record di Salesforce per ogni proprietà contrassegnata come obbligatoria in HubSpot. 

Altro / Sconosciuto

Esempio di errore "Altro / Sconosciuto"

• Si è verificato un errore di duplicato sconosciuto in Salesforce: ID duplicato specificato.

Cosa significa l’errore

Questo errore può verificarsi se si crea una mappatura dei campi che include un campo ID predefinito di Salesforce, come "ID lead" o "ID contatto", e lo si mappa alla proprietà corrispondente "ID lead di Salesforce" o "ID contatto di Salesforce" in HubSpot.

Come risolvere l’errore

Questi valori ID sono gestiti automaticamente dall’integrazione e non dovrebbero essere inclusi nelle mappature dei campi personalizzati. La creazione di queste mappature può causare un comportamento di sincronizzazione imprevisto, in particolare quando la regola di sincronizzazione è impostata su bidirezionale.

Per altri errori sconosciuti, contatta l’assistenza HubSpot per ulteriore supporto.

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

Configurare le notifiche degli errori di sincronizzazione

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, fai clic suSalesforce. 
3. Passa alla scheda Sincronizzazione dati. 
4. Nella scheda Stato sincronizzazione, nella sezione Errori di sincronizzazione , clicca suGestisci notifiche. 
5. Nella finestra di dialogo, attiva l'interruttore"Attiva notifiche ". 
6. Seleziona il pulsante di opzione accanto a"Immediatamente", "Giornalmente" o "Settimanalmente " per impostare la frequenza delle notifiche. 
7. Fare clic suSalva.