Salesforce integratie API-aanroepen en synchronisatiefouten beheren

De integratie tussen HubSpot en Salesforce kan synchronisatiefouten tegenkomen, waardoor gegevens niet kunnen worden gesynchroniseerd. U kunt deze synchronisatiefouten identificeren en oplossen in uw Salesforce-integratie-instellingen.

API-oproeplimiet aanpassen

1. Klik in je HubSpot-account op het settings instellingen-pictogram in de bovenste navigatiebalk. Ga in het zijbalkmenu links naar Integraties > Verbonden apps.
2. Klik in de lijst met verbonden apps opSalesforce. 
3. Ga naar het tabblad Synchronisatiestatus. 
4. Bekijk in het gedeelte API-aanroepen gebruikenhoeveel API-aanroepen u in de afgelopen 24 uur hebt gebruikt. Het aantalBeperkt door Salesforce is het aantal API-aanroepen dat u kunt doen op basis van uw Salesforce-instellingen. Om aan te passen hoeveel aanroepen aan HubSpot kunnen worden toegewezen, bewerkt u het veld Toegewezen aan HubSpot. 

Salesforce-synchronisatiefouten bekijken

1. Klik in je HubSpot-account op het settings instellingen-pictogram in de bovenste navigatiebalk. Ga in het zijbalkmenu links naar Integraties > Verbonden apps.
2. Klik in de lijst met gekoppelde apps opSalesforce. 
3. Ga naar het tabblad Sync Health. 
4. Bekijk onder Synchronisatiefouten de kaarten voor elk fouttype, met het aantal huidige fouten en de records waarop deze van invloed zijn. Klik op een fouttypekaart om de details van de fouten in het rechterpaneel te bekijken. Lees meer over elk fouttype en aanbevelingen voor het oplossen ervan. 

5. Klik op het info-pictogram in de kolom Fouttype om meer details over een fout te bekijken.
6. Om actie te ondernemen op individuele records, klik je op [#] records in de kolom Getroffen records en vervolgens op Acties > Een tijdelijke weergave van HubSpot-records maken om een gefilterde weergave van de getroffen records te maken. 
7. Zodra je de fouten hebt opgelost, ga je terug naar de foutenlijst. Schakel hetselectievakje links van de opgeloste fouten in en klik op Opnieuw synchroniseren.
8. Om je fouten te exporteren, klik je op Fouten exporteren (CSV) linksboven in de foutenlijst.

Soorten Salesforce-synchronisatiefouten

Associaties

Voorbeelden van associatiefouten 

• Associatielimiet bereikt
• Wachten op synchronisatie van account

Wat de fouten betekenen

Records worden niet gesynchroniseerd omdat ze zijn gekoppeld aan Salesforce-accounts die nog niet zijn gesynchroniseerd met HubSpot-bedrijven, of omdat ze zijn gekoppeld aan records die de limiet voor recordkoppelingen van HubSpot hebben bereikt. 

Hoe u de fouten kunt oplossen 

Om de foutmelding 'Limiet voor associaties bereikt'op te lossen, kunt u enkele van de geassocieerde records verwijderen of ze associëren met een ander Salesforce-record en vervolgens doorgaan met de synchronisatie.

Om de foutmelding 'Wachten op synchronisatie van account' op te lossen, wordt aanbevolen om een import van Salesforce-accounts uit te voeren. 

Aangepaste code

Voorbeelden van fouten in aangepaste code 

• Salesforce-automatisering
• Ontbrekende contact-ID
• Salesforce-validatieregel voor aangepaste velden
• Salesforce-stroom

Wat de fouten betekenen

Records worden niet gesynchroniseerd vanwege een probleem dat wordt veroorzaakt door automatisering, flows of validatieregels in uw Salesforce-account.

Hoe u de fouten kunt oplossen

Duplicaten

Voorbeelden van fouten met duplicaten

• E-mailadres al in gebruik
• Salesforce-regel voor duplicaten

Wat de fouten betekenen

Een Salesforce-lead of -contactpersoon kan niet worden gesynchroniseerd met HubSpot omdat het e-mailadres al bestaat in een HubSpot-contactrecord of vanwege een ontdubbelingsregel in Salesforce. 

Hoe de fouten op te lossen

Om de foutmelding 'E-mailadres al in gebruik ' op te lossen, verwijdert u het e-mailadres uit het bestaande HubSpot-contact.

Om de foutmelding 'Salesforce-duplicatieregel' op te lossen, wordt aanbevolen dat een Salesforce-beheerder de overeenkomende regels voor deduplicatie in Salesforce controleert. Voeg vervolgens conflicterende Salesforce-records samen, werk ze bij of verwijder ze, of pas de deduplicatieregel in Salesforce aan voordat je opnieuw probeert te synchroniseren in HubSpot.

Machtigingen

Voorbeelden van machtigingsfouten

• Onvoldoende toegang of ontbrekend Salesforce-record
• Salesforce-veldtoestemming
• Onvoldoende Salesforce-toegang

Wat de fouten betekenen

Wijzigingen die in HubSpot zijn aangebracht, kunnen niet worden gesynchroniseerd met Salesforce omdat de verbonden gebruiker geen toegang heeft tot het benodigde veld of object in Salesforce.

Hoe de fouten op te lossen

In de meeste gevallen treedt de fout 'Onvoldoende toegang of ontbrekend Salesforce-record' op wanneer de integratie probeert een Salesforce-veld bij te werken met een onjuiste waarde of een onjuiste koppeling te maken. 

Om de Salesforce-veldmachtigingsfout op te lossen, moet u ervoor zorgen dat de Salesforce-integratiegebruiker lees- en bewerkingsmachtigingen heeft voor het veld in Salesforce. 

De fout 'Onvoldoende toegang tot Salesforce' treedt op wanneer de Salesforce-integratiegebruiker de actie in Salesforce niet kan uitvoeren vanwege zijn gebruikersrechten in Salesforce. Het wordt aanbevolen om de Salesforce-integratiegebruikersrechten in Salesforce te controleren.

Keuzelijsten

Voorbeelden van keuzelijstfouten

• Ontbrekende Salesforce-keuzelijstoptie
• Niet-overeenkomende waarde voor staat of land
• Opties komen niet overeen
• Inactieve Salesforce-eigenaar
• Beperkte keuzelijstwaarde
• Inactieve opportuniteitsfase
• Salesforce-eigenaren niet gesynchroniseerd
• Optielimiet overschreden
• Standaard verkoopproces niet beschikbaar
• Ontbrekende of ongeldige opportuniteitsfase

Wat de fouten betekenen

Records worden niet gesynchroniseerd vanwege een discrepantie tussen de waarden van het keuzelijstveld in HubSpot en Salesforce. Dit kan gebeuren wanneer een waarde in de keuzelijst in het ene systeem niet overeenkomt met de huidige waarden in het andere systeem, wanneer de keuzelijst de limiet aan waarden heeft bereikt of wanneer de doorgegeven waarde ongeldig is.

Hoe u de fouten kunt oplossen

Om de foutmelding'Overeenkomstige waarde voor staat of land ontbreekt' op te lossen, raden we je aan te controleren of aan de volgende vereisten is voldaan:

• De interne waarde van de optie Land in HubSpot moet overeenkomen met een bestaande optie Land in uw instellingen voor de keuzelijst Staat en Land/Gebied in Salesforce. 
• De waarde 'Provincie' moet bestaan als een beschikbare optie 'Provincie/Staat'voor de waarde 'Land' van het record in Salesforce. Bovendien moet de interne waarde van de optie 'Provincie' in HubSpot overeenkomen met een bestaande optie 'Provincie' in Salesforce. 

Om de foutmelding 'Opties komen niet overeen' op te lossen, raden we je aan de interne/API-naam van de Salesforce-veldompties bij te werken zodat deze overeenkomt met de interne waarde van de eigenschapopties in HubSpot. 

Om de fout 'Inactieve Salesforce-eigenaar ' op te lossen, wijst u het HubSpot-record opnieuw toe aan een gebruiker die actief is in Salesforce. 

De fout 'Beperkte keuzelijstwaarde' treedt opwanneer je de instelling 'Beperk keuzelijst tot de waarden die zijn gedefinieerd in de waardeset' hebt ingeschakeld voor het veld in Salesforce. Wanneer dit is ingeschakeld in Salesforce, moet de waarde die je probeert te synchroniseren van HubSpot naar Salesforce als optie in de Salesforce-keuzelijst voorkomen. Het wordt aanbevolen om de instelling 'Beperk keuzelijst tot de waarden die zijn gedefinieerd in de waardeset' in Salesforce uit te schakelen, zodat alle waarden van HubSpot naar Salesforce kunnen worden gesynchroniseerd. 

Defoutmelding 'Inactieve opportuniteitsfase' treedt op wanneer een Salesforce-opportuniteit met een inactieve opportuniteitsfase wordt gesynchroniseerd met HubSpot. Om deze fout op te lossen, wijzigt u de opportuniteitsfase in Salesforce in actiefof verplaatst u de opportuniteit naar een actieve fase. 

Om de foutmelding 'Salesforce-eigenaren niet gesynchroniseerd' op te lossen, moet u ervoor zorgen dat voor de Salesforce-gebruikers het gebruikerstype is ingesteld op Standaard, Power Partner of Gast in Salesforce. 

Om de foutmelding 'Optielimiet overschreden' op te lossen, wordt aanbevolen om extra eigenschapopties in HubSpot en Salesforce te verwijderen die uw team niet gebruikt. Zorg er bovendien voor dat alle toegewezen eigenschappen overeenkomstige veldtypen hebben. 

In de meeste gevallen treedt de foutmelding Standaard verkoopproces niet beschikbaar op wanneer Salesforce-opportuniteiten worden gesynchroniseerd met HubSpot met een ontbrekend recordtype. Als je recordtypen in Salesforce hebt ingeschakeld, maar deze niet gebruikt, of als je Salesforce-opportuniteiten hebt zonder recordtype, raden we je aan om samen met Salesforce alle recordtypen te deactiveren of een nieuw recordtype aan te maken. 

Om de foutmelding 'Ontbrekende of ongeldige opportuniteitsfase' op te lossen, moet je ervoor zorgen dat de Salesforce-opportuniteitsfasewaarde bestaat in de HubSpot-pijplijn. 

Eigenschaptoewijzingen

Voorbeelden van fouten bij het toewijzen van eigenschappen 

• Type komt niet overeen
• Ontbrekende Salesforce-ID
• Ongeldige Salesforce-ID

Wat de fouten betekenen

Records worden niet gesynchroniseerd vanwege een discrepantie in de mapping tussen de HubSpot-eigenschap en het Salesforce-veld. Dit kan betekenen dat de eigenschap- en veldtypen niet compatibel zijn, dat de eigenschap of het veld niet meer bestaat, of dat er een Salesforce-referentieveldtoewijzing moet worden gemaakt.

Hoe de fouten op te lossen 

Om de fout 'Type mismatch' op te lossen, moet u ervoor zorgen dat het eigenschapstype in HubSpot en het veldtype in Salesforce compatibel zijn. Lees meer over de HubSpot-eigenschapveldtypen die kunnen worden gesynchroniseerd met Salesforce. 

De foutmelding 'Ontbrekende Salesforce-ID' treedt op wanneer HubSpot een andere waarde dan een bestaande Salesforce-ID probeert te synchroniseren met een referentie-/opzoekveld in Salesforce. 

Om de fout 'Ongeldige Salesforce-ID' op te lossen, raden we je aan de aangepaste validatieregel te controleren die je in Salesforce hebt ingesteld. 

Eigenschapswaarden

Voorbeelden van fouten met eigenschapswaarden

• Te lange tekenreeks
• Ongeldig e-mailadres
• Vereist land ontbreekt
• Ongeldige waarde
• Toewijzing eigenaar
• Beperkte unieke waarde
• Vereiste waarde ontbreekt

Wat de fouten betekenen

Records worden niet gesynchroniseerd tussen HubSpot en Salesforce omdat ze eigenschapswaarden bevatten die niet geldig zijn. Deze fouten vereisen doorgaans dat de betreffende records worden bijgewerkt om de fout te corrigeren.

Hoe u de fouten kunt oplossen

Om de foutmelding 'String te lang' op te lossen, verkort u de veldwaarde in Salesforce of HubSpot, of verhoogt u het maximale aantal tekens voor het veld in Salesforce. 

Om de foutmelding 'Ongeldig e-mailadres' op te lossen, werkt u de indeling van het e-mailadres bij in het Salesforce-record dat u met HubSpot wilt synchroniseren.

Om de fout 'Vereist land ontbreekt' op te lossen, raden we je aan te controleren of aan de volgende vereisten is voldaan:

• De interne waarde van de optie Land in HubSpot moet overeenkomen met een bestaande optie Land in uw instellingen voor de keuzelijst Staat en Land/Gebied in Salesforce. 
• De waarde State moet bestaan als een beschikbare optie State/Provincevoor de waarde Country van het record in Salesforce. Bovendien moet de interne waarde van de eigenschap State in HubSpot overeenkomen met een bestaande optie State in Salesforce. 

Om de fout 'Ongeldige waarde ' op te lossen, raden we je aan de eigenschapswaarde in het Salesforce-record bij te werken zodat deze voldoet aan de vereisten van HubSpot voor de eigenschapswaarde. 

In de meeste gevallen treedt de fout 'Eigenaarstoewijzing' op wanneer een HubSpot-activiteit wordt gesynchroniseerd met Salesforce als een Salesforce-taak en HubSpot probeert de taak toe te wijzen aan een eigenaar van een Salesforce-wachtrij.

Om de foutmelding 'Beperkte unieke waarde' op te lossen, raden we je aan de overeenkomende regels voor ontdubbeling te controleren die je in Salesforce hebt ingesteld. 

Om de foutmelding 'Vereiste waarde ontbreekt' op te lossen , voegt u een waarde toe aan het Salesforce-record voor elke eigenschap die in HubSpot als vereist is gemarkeerd. 

Overige

Records worden niet gesynchroniseerd vanwege een onbekende fout. Neem contact op met HubSpot Support voor meer hulp bij deze fouten.

Let op: het is mogelijk om 100 Salesforce-fouten tegelijk opnieuw te synchroniseren. Om meer dan 100 fouten te synchroniseren, importeert u de records uit Salesforce of werkt u een toegewezen eigenschap bij.

Meldingen voor synchronisatiefouten instellen

1. Klik in je HubSpot-account op het settings instellingen-pictogram in de bovenste navigatiebalk. Ga in het zijbalkmenu links naar Integraties > Verbonden apps.
2. Klik in de lijst met gekoppelde apps opSalesforce. 
3. Ga naar het tabblad Synchronisatiestatus. 
4. Klik onderSynchronisatiefouten opMeldingen beheren. 
5. Schakel in het dialoogvenster de schakelaarMeldingen inschakelen in. 
6. Selecteer het keuzerondje naastDirect,Dagelijks ofWekelijks om de frequentie van uw meldingen in te stellen. 
7. Klik opOpslaan.