Gestione delle chiamate API per l'integrazione di Salesforce e degli errori di sincronizzazione
Ultimo aggiornamento: giugno 28, 2023
Disponibile con uno qualsiasi dei seguenti abbonamenti, tranne dove indicato:
Marketing Hub Professional , Enterprise |
Sales Hub Professional , Enterprise |
Service Hub Professional , Enterprise |
Content Hub Professional , Enterprise |
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 Salesforce.
Regolare il limite delle chiamate API
- Nel tuo account HubSpot, passa a Gestione dei dati > Integrazioni.
- Nell'elenco delle applicazioni connesse, fare clic suSalesforce.
- Fare clic sulla schedaSync Health.
- Nella sezioneUso delle chiamate API, si vedrà quante chiamate API sono state utilizzate nelle ultime 24 ore. Il numerolimitato da Salesforce è la quantità di chiamate API che è possibile effettuare in base alle impostazioni di Salesforce. Per regolare quante di queste chiamate possono essere assegnate a HubSpot, modificare il campo Allocated to HubSpot.
Risolvere gli errori di sincronizzazione
- Nel tuo account HubSpot, passa a Gestione dei dati > Integrazioni.
- Nell'elenco delle applicazioni collegate, fare clic suSalesforce.
- Fare clic sulla schedaSync Health.
- InErrori di sincronizzazione sono visualizzate schede per ciascun tipo di errore, con il numero di errori correnti e di record interessati per ciascuno di essi. Fare clic su una scheda del tipo di errore per visualizzare i dettagli degli errori nel pannello di destra. Per ulteriori informazioni e per le fasi di risoluzione di ciascun tipo di errore, vedere di seguito.
Associazioni
I record non si sincronizzano perché sono associati a record non ancora sincronizzati con HubSpot o perché sono associati a record che hanno raggiunto il limite di associazione dei record di HubSpot. Nella colonna Record interessati, si trovano tutti i record che non riescono a sincronizzarsi a causa dell'associazione con il record nella colonna Record a sinistra.
- Per visualizzare i dettagli e le fasi di risoluzione di un errore, fare clic sull'icona info nella colonna Tipo di errore .
- Per intervenire sui singoli record, fare clic su [#] record nella colonna Record interessati, quindi fare clic suCrea vista per creare una vista filtrata dei record interessati.
- Una volta risolti gli errori, tornare all'elenco Erroridelle associazioni. Selezionare lacasella di controllo a sinistra degli errori risolti e fare clic su Risincronizza.
- Per esportare gli errori, fare clic su Esporta errori in alto a destra.
Codice personalizzato
I record non vengono sincronizzati a causa di un problema causato da automazione, flussi o regole di convalida nell'account Salesforce. Le informazioni sulla causa dell'errore vengono visualizzate nella colonna Dettagli errore.
- Per visualizzare i dettagli e le fasi di risoluzione di un errore, fare clic sull'icona info nella colonna Tipo di errore.
- A seconda dei dettagli dell'errore, potrebbe essere necessario aggiornare i record interessati o modificare le impostazioni di Salesforce. Per intervenire su singoli record in HubSpot, fare clic su [#] record nella colonna Record interessati, quindi fare clic suCrea vista per creare una vista filtrata dei record interessati.
- Una volta risolti gli errori, tornate all'elenco Erroricodice personalizzato. Selezionare la casella di controllo a sinistra degli errori risolti e fare clic su Risincronizza.
- Per esportare gli errori, fare clic su Esporta errori in alto a destra.
Duplicati
Non è possibile creare record perché esiste già un record o un valore duplicato. Verranno visualizzati i record HubSpot e Salesforce interessati dall'errore, insieme al valore duplicato.
- Per visualizzare i dettagli e le fasi di risoluzione di un errore, fare clic sull'icona info nella colonna Tipo di errore.
- Fare clic su HubSpot o Salesforce nella colonnaVisualizza record in per accedere al record e apportare le modifiche.
- Una volta risolti gli errori, tornare all'elenco Erroriduplicati. Selezionare lacasella di controllo a sinistra degli errori risolti e fare clic su Risincronizza.
- Per esportare gli errori, fare clic su Esporta errori in alto a destra.
Autorizzazioni
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.
- Per visualizzare i dettagli specifici e le fasi di risoluzione di un errore, fare clic sull'icona info info nella colonna Tipo di errore.
- Rivedere e aggiornare le autorizzazioni per l'utente connesso nelle impostazioni di Salesforce.
- Una volta risolti gli errori, tornate all'elenco Erroridi autorizzazione. Selezionate lacasella di controllo a sinistra degli errori risolti e fate clic su Risincronizza.
- Per esportare gli errori, fare clic su Esporta errori in alto a destra.
Elenchi a scelta
I record non si sincronizzano 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. Verranno visualizzati la proprietà HubSpot e il campo Salesforce che causano l'errore, insieme al numero di record interessati per ciascun errore.
- Per visualizzare i dettagli e le fasi di risoluzione di un errore, fare clic sull'icona info nella colonna Tipo di errore.
- A seconda dei dettagli dell'errore, potrebbe essere necessario aggiornare i valori dei record interessati o apportare modifiche alla proprietà o al campo. Per intervenire su singoli record in HubSpot, fare clic su [#] record nella colonna Record interessati, quindi fare clic suCrea vista per creare una vista filtrata dei record interessati.
- Una volta risolti gli errori, tornate all'elenco degli errori diPicklists. Selezionare la casella di controllo a sinistra degli errori risolti e fare clic su Risincronizza.
- Per esportare gli errori, fare clic su Esporta errori in alto a destra.
Mappature delle proprietà
I record non si sincronizzano 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.
- Per visualizzare i dettagli e le fasi di risoluzione di un errore, fare clic sull'icona info nella colonna Tipo di errore.
- Aggiornare le mappature delle proprietà.
- Una volta risolti gli errori, tornate all'elenco Errori dellemappature delle proprietà. Selezionare la casella di controllo a sinistra degli errori risolti e fare clic su Risincronizza.
- Per esportare gli errori, fare clic su Esporta errori in alto a destra.
Valori delle proprietà
I record non si sincronizzano 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.
- Per visualizzare ulteriori informazioni e passaggi risolutivi, fare clic sull'icona info nella colonna Tipo di errore.
- Aggiornare i valori non validi del record in HubSpot o Salesforce. Per visualizzare un elenco dei record interessati in HubSpot, fare clic su[#] record nella colonna Record interessati, quindi fare clic suCrea vista per creare una vista filtrata.
- Una volta risolti gli errori, tornate all'elenco Errori deivalori delle proprietà. Selezionare la casella di controllo a sinistra degli errori risolti e fare clic su Risincronizza.
- Per esportare gli errori, fare clic su Esporta errori in alto a destra.
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, passa a Gestione dei dati > Integrazioni.
- Nell'elenco delle applicazioni connesse, fare clic suSalesforce.
- Fare clic sulla schedaSync Health.
- InErrori di sincronizzazione, fare clic suGestisci notifiche.
- Nella finestra di dialogo, fare clic per attivare l'interruttoreAttiva notifiche.
- Selezionare il pulsante di opzione accanto aImmediatamente,Giornalmente oSettimanalmente per impostare la frequenza delle notifiche.
- Fare clic suSalva.