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

L'integrazione HubSpot-Salesforce potrebbe riscontrare errori di sincronizzazione che impediscono la sincronizzazione dei dati. È possibile identificare 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'settingsicona 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 su Salesforce.
3. Passa alla scheda Stato sincronizzazione.
4. Nella sezione Utilizzo chiamate API , visualizza il numero di chiamate API utilizzate nelle ultime 24 ore. Il numero Limitato da Salesforce è il numero di chiamate API che puoi effettuare in base alle 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'settingsicona 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. Passa alla scheda Stato sincronizzazione.
4. In Errori di sincronizzazione, visualizza le schede per ogni 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 ogni tipo di errore e sui consigli per la risoluzione.

5. Per visualizzare ulteriori dettagli su un errore, clicca sull'icona delle informazioni info 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 la casella di controllo a sinistra di qualsiasi errore risolto e clicca su Resync.
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 o 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 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 dall'automazione, dai flussi o dalle regole di convalida nel tuo account Salesforce.

Come risolvere gli errori

Duplicati

Esempi di errori relativi ai duplicati

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

Cosa significano gli errori

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

Come risolvere gli errori

Per risolvere l'errore " Indirizzo 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 di controllare le regole di corrispondenza per la deduplicazione impostate in Salesforce.

Autorizzazioni

Esempi di errori relativi alle autorizzazioni

• Accesso insufficiente o record Salesforce mancante
• Autorizzazione campo Salesforce
• Accesso 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 Salesforce con un valore errato o di creare un'associazione errata.

Per risolvere l'errore di autorizzazione del campo Salesforce , assicurati che l'utente dell'integrazione Salesforce disponga delle autorizzazioni di lettura e modifica per il 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 controllare le autorizzazioni utente dell'integrazione Salesforce in Salesforce.

Elenchi di selezione

Esempi di errori relativi agli elenchi di selezione

• Opzione elenco di selezione Salesforce mancante
• Valore dello stato o del paese non corrispondente
• Opzioni non corrispondenti
• Proprietario Salesforce inattivo
• Valore dell'elenco di selezione limitato
• Fase dell'opportunità inattiva
• Proprietari 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 dell'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 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 relativo al valore non corrispondente dello stato o del paese, si consiglia di verificare che siano soddisfatti i seguenti requisiti:

• Il valore interno dell'opzione Proprietà Paese in HubSpot deve corrispondere a un'opzione Paese esistente nelle impostazioni dell'elenco di selezione 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 ", ti consigliamo 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 verifica quando l'opzione Limita elenco di selezione ai valori definiti nell'impostazione del 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 essere presente come opzione nell'elenco di selezione di Salesforce. Si consiglia di disattivare l'impostazione " Limita elenco di selezione ai valori definiti nel set di valori " in Salesforce, in modo che tutti i valori possano essere sincronizzati da HubSpot a Salesforce.

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

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

Per risolvere l'errore " Limite opzioni superato ", ti consigliamo di eliminare le opzioni di proprietà extra in HubSpot e Salesforce che il tuo team non utilizza. 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, o se 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 di opportunità mancante o non valida, assicurati che il valore della fase di opportunità di Salesforce esista nella pipeline di HubSpot.

Mappature delle proprietà

Esempi di errori di mappatura delle proprietà

• Incompatibilità 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à HubSpot e il campo Salesforce. Ciò può significare che i tipi di proprietà e campo non sono compatibili, che la proprietà o il campo non esistono più o che è necessario creare una mappatura del campo di riferimento Salesforce.

Come risolvere gli errori

Per risolvere l'errore di mancata corrispondenza del tipo, 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 impostata in Salesforce.

Valori delle proprietà

Esempi di errori relativi ai valori delle proprietà

• Stringa troppo lunga
• Email non valida
• Paese richiesto mancante
• Valore non valido
• Assegnazione proprietario
• Valore univoco limitato
• Valore richiesto 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 il formato dell'indirizzo email nel record Salesforce che stai tentando di sincronizzare con HubSpot.

Per risolvere l'errore Paese richiesto mancante, si consiglia di verificare che siano soddisfatti i seguenti requisiti:

• Il valore interno dell'opzione Proprietà Paese in HubSpot deve corrispondere a un'opzione Paese esistente nelle impostazioni dell'elenco di selezione 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 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 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à HubSpot viene sincronizzata con Salesforce come attività Salesforce e HubSpot tenta di assegnare l'attività a un proprietario della coda Salesforce.

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

Per risolvere l'errore Valore richiesto mancante, aggiungi 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. Contatta l'assistenza HubSpot per ulteriore assistenza con questi errori.

Nota: è possibile risincronizzare in blocco 100 errori 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'settingsicona 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 su Salesforce.
3. Passa alla scheda Stato sincronizzazione.
4. In Errori di sincronizzazione, clicca su Gestisci notifiche.
5. Nella finestra di dialogo, attiva l'opzione Attiva notifiche.
6. Seleziona il pulsante di opzione accanto a Immediatamente, Giornalmente o Settimanalmente per impostare la frequenza delle notifiche.
7. Fai clic su Salva.