Doorgaan naar artikel
Let op: De Nederlandse vertaling van dit artikel is alleen bedoeld voor het gemak. De vertaling wordt automatisch gemaakt via een vertaalsoftware en is mogelijk niet proefgelezen. Daarom moet de Engelse versie van dit artikel worden beschouwd als de meest recente versie met de meest recente informatie. U kunt het hier raadplegen.

Salesforce integratie API-aanroepen en synchronisatiefouten beheren

Laatst bijgewerkt: 27 mei 2025

Beschikbaar met elk van de volgende abonnementen, behalve waar vermeld:

Marketing Hub   Professional , Enterprise
Sales Hub   Professional , Enterprise
Service Hub   Professional , Enterprise
Operations Hub   Professional , Enterprise
Content Hub   Professional , Enterprise

De HubSpot-Salesforce integratie kan synchronisatiefouten tegenkomen, waardoor gegevens niet worden gesynchroniseerd. Je kunt deze synchronisatiefouten identificeren en oplossen in je Salesforce integratie-instellingen.

API oproeplimiet aanpassen

  • Klik in je HubSpot-account op het settings instellingen-pictogram in de bovenste navigatiebalk. Ga in het zijbalkmenu links naar Integraties > Verbonden apps.
  • Klik in de lijst met verbonden apps op Salesforce.
  • Bekijk op het tabblad Sync Health, in het gedeelte API-call use , hoeveel API-calls u de afgelopen 24 uur hebt gebruikt. Het aantal Beperkt door Salesforce is het aantal API-oproepen dat u kunt maken op basis van uw Salesforce-instellingen. Bewerk het veld Toegewezen aan HubSpot om aan te passen hoeveel oproepen kunnen worden toegewezen aan HubSpot.

sync-health-api-call-use

Salesforce-synchronisatiefouten weergeven

  • Klik in je HubSpot-account op het settings instellingen-pictogram in de bovenste navigatiebalk. Ga in het zijbalkmenu links naar Integraties > Verbonden apps.
  • Klik in de lijst met verbonden apps op Salesforce.
  • Op het tabblad Sync gezondheid, onder Sync fouten, ziet u kaarten voor elk fouttype, met het aantal huidige fouten en geïmpacteerde records. Klik op een fouttypekaart om de details van de fouten in het rechterpaneel te bekijken. Meer informatie over elk fouttype en aanbevelingen voor oplossingen.

sync-health-sync-errors

  • Klik op het info info-pictogram in de kolom Type fout om meer details over een fout weer te geven.
  • Om actie te ondernemen op individuele records, klik je op [#] records in de kolom Getroffen records en klik je vervolgens op Acties > Tijdelijke weergave van HubSpot-records maken om een gefilterde weergave van de getroffen records te maken.
  • Als je de fouten hebt opgelost, ga je terug naar de foutenlijst. Schakel het selectievakje links van de opgeloste fouten in en klik op Opnieuw synchroniseren.
  • Om je fouten te exporteren, klik je linksboven in de foutenlijst op Fouten exporteren (CSV) .
screenshot showing the button to export Salesforce sync errors in HubSpot

Soorten synchronisatiefouten bij Salesforce

Verenigingen

Voorbeelden van associatiefouten

  • Associatie limiet 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 recordassociatielimiet van HubSpot hebben bereikt.

De fouten oplossen

Om de fout Association limit reached op te lossen, kunt u een aantal van de gekoppelde records verwijderen of ze koppelen aan een andere Salesforce-record en vervolgens doorgaan met de synchronisatie.

Om de fout Wachten op account om te synchroniseren op te lossen, is het aan te raden om een import van Salesforce Accounts uit te voeren.

Aangepaste code

Voorbeelden van fouten in aangepaste code

  • Automatisering in Salesforce
  • Ontbrekend contact-ID
  • Salesforce aangepaste veld validatieregel
  • Salesforce flow

Wat de fouten betekenen

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

De fouten oplossen

Aangezien deze fouten zich voordoen in Salesforce, is het raadzaam om samen te werken met uw Salesforce-beheerder om het probleem op te lossen in uw aangepaste code in Salesforce.

Duplicaten

Voorbeelden van dubbele fouten

  • E-mail al in gebruik
  • Regel van Salesforce voor duplicaten

Wat de fouten betekenen

Een Salesforce lead of contact kan niet synchroniseren met HubSpot omdat het e-mailadres al bestaat op een HubSpot contactrecord of vanwege een ontdubbelingsregel in Salesforce.

De fouten oplossen

Om de foutmelding E-mail is al in gebruik op te lossen, verwijder je het e-mailadres van het bestaande HubSpot-contact.

Om de fout met de dubbele regel in Salesforce op te lossen, is het raadzaam om de overeenkomende regels voor deduplicatie die zijn ingesteld in Salesforce te controleren.

Rechten

Voorbeelden van toestemmingsfouten

  • Onvoldoende toegang of ontbrekende Salesforce-record
  • Salesforce veld toestemming
  • Onvoldoende toegang tot Salesforce

Wat de fouten betekenen

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

De fouten oplossen

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

Om de fout met toestemming voor het Salesforce-veld op te lossen, moet u ervoor zorgen dat de gebruiker van de Salesforce-integratie lees- en bewerkingsrechten heeft voor het veld in Salesforce.

De foutmelding Onvoldoende toegang tot Salesforce treedt op wanneer de gebruiker van de Salesforce-integratie de actie niet kan uitvoeren in Salesforce vanwege zijn gebruikersmachtigingen in Salesforce. Het is raadzaam om de gebruikersmachtigingen voor de Salesforce-integratie in Salesforce te controleren.

Keuzelijsten

Voorbeelden van picklistfouten

  • Ontbrekende Salesforce picklist-optie
  • Niet overeenkomende waarde voor staat of land
  • Niet overeenkomende opties
  • Inactieve Salesforce-eigenaar
  • Beperkte waarde keuzelijst
  • Inactief opportunitystadium
  • Salesforce-eigenaren niet gesynchroniseerd
  • Optielimiet overschreden
  • Standaard verkoopproces niet beschikbaar
  • Ontbrekend of ongeldig opportunitystadium

Wat de fouten betekenen

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

De fouten oplossen

Om de foutmelding Mismatched state or country value op te lossen, is het aan te raden om te controleren of aan de volgende vereisten is voldaan:

  • De interne waarde van de Land-eigenschapoptie in HubSpot moet overeenkomen met een bestaande Land-optie in uw Staat en Land/Territorium keuzelijstinstellingen in Salesforce.
  • De State waarde moet bestaan als een Available State/Province optie voor de record's Country waarde in Salesforce. Daarnaast moet de interne waarde van de eigenschap State in HubSpot overeenkomen met een bestaande optie State in Salesforce.

Om de foutmelding Mismatched options (Niet overeenkomende opties) op te lossen, wordt aanbevolen om de interne/API-naam van de Salesforce-veldopties bij te werken zodat deze overeenkomt met de interne waarde van de eigenschapopties in HubSpot.

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

De fout met de beperkte waarde in de keuzelijst treedt op als de instelling Beperk keuzelijst tot de waarden die zijn gedefinieerd in de instelling voor de waardeset is ingeschakeld voor het veld in Salesforce. Wanneer deze instelling is ingeschakeld in Salesforce, moet de waarde die je probeert te synchroniseren van HubSpot naar Salesforce bestaan als een optie in de keuzelijst van Salesforce. Het wordt aanbevolen om de picklist te beperken tot de waarden die zijn gedefinieerd in de instelling voor de waardeset in Salesforce, zodat alle waarden kunnen worden gesynchroniseerd van HubSpot naar Salesforce.

De fout Inactieve opportunity stage treedt op wanneer een Salesforce-opportunity met een inactieve opportunity stage probeert te synchroniseren met HubSpot. Om deze foutmelding op te lossen, wijzig je de opportunity-stage in Salesforce in actief of verplaats je de opportunity naar een actieve stage.

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

Om de fout Optie limiet overschreden op te lossen, wordt aanbevolen om extra eigenschapopties in HubSpot en Salesforce te verwijderen die je team niet gebruikt. Zorg er daarnaast voor dat alle in kaart gebrachte eigenschappen corresponderende veldtypen hebben.

In de meeste gevallen treedt de fout Standaard verkoopproces niet beschikbaar op wanneer Salesforce opportunities probeert te synchroniseren met HubSpot met een ontbrekend Opnametype. Als je Recordtypes hebt ingeschakeld in Salesforce, maar deze niet gebruikt, of Salesforce-opportunities hebt zonder Recordtype, is het raadzaam om samen te werken met Salesforce om alle Recordtypes te deactiveren of een nieuw Recordtype te maken.

Om de fout Missing or invalid opportunity stage op te lossen, moet je ervoor zorgen dat de Salesforce opportunity stage-waarde bestaat in de HubSpot-pijplijn.

Toewijzingen van eigenschappen

Voorbeelden van fouten bij het toewijzen van eigenschappen

  • Type komt niet overeen
  • Ontbrekend Salesforce-ID
  • Ongeldig 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 het veldtype niet compatibel zijn, dat de eigenschap of het veld niet meer bestaat of dat er een Salesforce referentieveld mapping moet worden gemaakt.

De fouten oplossen

Om de fout Type mismatch op te lossen, moet je ervoor zorgen dat het eigenschapstype in HubSpot en het veldtype in Salesforce compatibel zijn. Meer informatie over de HubSpot-eigenschap veldtypen die kunnen synchroniseren met Salesforce.

De fout Missing Salesforce ID treedt op wanneer HubSpot heeft geprobeerd een andere waarde dan een bestaande Salesforce ID te synchroniseren met een referentie-/opzoekveld in Salesforce.

Om de foutmelding Ongeldige Salesforce-ID op te lossen, wordt u aangeraden de aangepaste validatieregel te controleren die u hebt ingesteld in Salesforce.

Eigendomswaarden

Voorbeelden van fouten in eigendomswaarden

  • String te lang
  • Ongeldig e-mail
  • Land ontbreekt
  • Ongeldige waarde
  • Toewijzing eigenaar
  • Beperkte unieke waarde
  • Ontbrekende verplichte waarde

Wat de fouten betekenen

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

De fouten oplossen

Om de foutmelding String te lang op te lossen, kort je de veldwaarde in Salesforce of HubSpot in of verhoog je de tekenlimiet van het veld in Salesforce.

Om de foutmelding Ongeldig e-mailadres op te lossen, werk je de opmaak van het e-mailadres bij in het Salesforce-record dat probeert te synchroniseren met HubSpot.

Om de foutmelding Missing required country op te lossen, is het aan te raden om te controleren of aan de volgende vereisten is voldaan:

  • De interne waarde van de Land-eigenschapoptie in HubSpot moet overeenkomen met een bestaande Land-optie in uw Staat en Land/Territorium keuzelijstinstellingen in Salesforce.
  • De State waarde moet bestaan als een Available State/Province optie voor de record's Country waarde in Salesforce. Daarnaast moet de interne waarde van de eigenschap State in HubSpot overeenkomen met een bestaande optie State in Salesforce.

Om de foutmelding Ongeldige waarde op te lossen, wordt aanbevolen om de waarde van de eigenschap in het Salesforce-record bij te werken zodat deze voldoet aan de vereisten van HubSpot voor de waarde van de eigenschap.

In de meeste gevallen treedt de Owner Assignment-fout op wanneer een HubSpot-activiteit wordt gesynchroniseerd met Salesforce als een Salesforce-taak en HubSpot probeert de taak toe te wijzen aan een Salesforce Queue-eigenaar.

Om de fout Restricted unique value (Beperkte unieke waarde) op te lossen, wordt u aangeraden de overeenkomende regels voor ontdubbeling te controleren die u in Salesforce hebt ingesteld.

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

Andere

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

Opmerking: het is mogelijk om 100 Salesforce-fouten per keer in bulk te synchroniseren. Als u meer dan 100 fouten wilt synchroniseren, importeert u de records uit Salesforce of werkt u een in kaart gebrachte eigenschap bij.

Sync-foutmeldingen instellen

  • Klik in je HubSpot-account op het settings instellingen-pictogram in de bovenste navigatiebalk. Ga in het zijbalkmenu links naar Integraties > Verbonden apps.
  • Klik in de lijst met verbonden apps op Salesforce.
  • Klik op het tabblad Sync-gezondheid.
  • Klik onder Sync-fouten op Meldingen beheren.
  • Schakel in het dialoogvenster de schakelaar Meldingen inschakelen in.
  • Selecteer het keuzerondje naast Direct, Dagelijks of Wekelijks om de frequentie van uw meldingen in te stellen.
  • Klik op Opslaan.

sync-health-error-notifications

Was dit artikel nuttig?
Dit formulier wordt alleen gebruikt voor feedback op documentatie. Ontdek hoe je hulp krijgt met HubSpot.