Gestione delle chiamate API per l'integrazione di 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, clicca suSalesforce. 
3. Passa alla scheda Sincronizzazione dati. 
4. Nella scheda Stato sincronizzazione, nella sezione Utilizzo chiamate API, visualizza quante chiamate API hai utilizzato nelle ultime 24 ore. Il numeroLimitato 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 sincronizzazione, nellasezioneErrori di sincronizzazione , visualizza le schede relative a ciascun tipo di errore, con il numero di errori attuali e i record interessati. Clicca 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 eseguire un'azione 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

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", puoi rimuovere alcuni dei record associati o 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 Salesforce. 

Codice personalizzato

Esempi di errori di codice personalizzato 

• Automazione di Salesforce
• ID contatto mancante
• Regola di convalida campo personalizzato 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 proprio account Salesforce.

Come risolvere gli errori

Duplicati

Esempi di errori relativi ai duplicati

• Email già in uso
• Regola duplicati di Salesforce

Cosa significano gli errori

Un lead o un contatto di Salesforce non può sincronizzarsi 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 ", rimuovi l'indirizzo email 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 di eseguire nuovamente la sincronizzazione in HubSpot.

Autorizzazioni

Esempi di errori relativi alle autorizzazioni

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

Cosa significano gli errori

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

Per risolvere l'errore di autorizzazione del campo di Salesforce , assicurati che l'utente dell'integrazione di Salesforce disponga delle autorizzazioni di lettura e modifica per il campo in Salesforce. 

L'errore "Accesso a Salesforce insufficiente " si verifica quando l'utente dell'integrazione di 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 di 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 Salesforce inattivo
• Valore dell'elenco di selezione con restrizioni
• Fase dell'opportunità inattiva
• Proprietari di Salesforce non sincronizzati
• Limite 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 degli elenchi di selezione in HubSpot e Salesforce. Ciò può verificarsi quando un valore dell'elenco di selezione in un sistema non corrisponde a nessun valore corrente 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 Salesforce in modo che corrisponda al valore interno delle opzioni della proprietà in HubSpot. 

Per risolvere l'errore " Proprietario Salesforce inattivo ", riassegna il record HubSpot a un utente attivo in Salesforce. 

L'errore "Valore dell'elenco di selezione limitato" si verificaquando l'impostazione "Limita l'elenco di selezione ai valori definiti nel set di valori " è attivata per il campo in Salesforce. 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 un'opportunità di Salesforce con una fase inattiva tenta di sincronizzarsi con HubSpot. 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 gli utenti di Salesforce abbiano il "Tipo utente " impostato su "Standard", "Power Partner" o "Ospite " in Salesforce. 

Per risolvere l'errore " Limite opzioni superato ", si consiglia di eliminare le opzioni di proprietà extra 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 opzioni delle proprietà delle attività corrispondenti in HubSpot. La Priorità attività supporta solo Alto, Medio, Basso e Nessuno. Per Stato e Tipo, aggiorna i valori di Salesforce in modo che corrispondano esattamente alle opzioni disponibili in HubSpot oppure aggiungi 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ù o 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à 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 controllare la regola di convalida personalizzata che hai impostato in Salesforce. 

Valori delle proprietà

Esempi di errori relativi ai valori delle proprietà

• Stringa troppo lunga
• E-mail non valida
• Paese obbligatorio mancante
• Valore non valido
• Assegnazione del proprietario
• Valore univoco non consentito
• 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 ", accorcia il valore del campo in Salesforce o HubSpot oppure aumenta il limite di caratteri del campo in Salesforce. 

Per risolvere l'errore "Email non valida ", aggiorna la formattazione dell'indirizzo email nel record di Salesforce che sta tentando di sincronizzarsi 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 proprietario " si verifica quando un'attività di HubSpot viene sincronizzata su Salesforce come attività di Salesforce e HubSpot tenta di assegnare l'attività a un proprietario della coda di Salesforce.

Per risolvere l'errore " Valore univoco limitato ", si consiglia di controllare 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 qualsiasi proprietà contrassegnata come obbligatoria in HubSpot. 

Altro

I record non vengono sincronizzati a causa di un errore sconosciuto. Contatta l'assistenza HubSpot per ulteriore assistenza in merito a questi errori.

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 di errore 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, clicca 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'interruttoreAttiva notifiche. 
6. Seleziona il pulsante di opzione accanto aImmediatamente,Giornalmente oSettimanalmente per impostare la frequenza delle notifiche. 
7. Fare clic suSalva.