HubSpot Kennisbank

Salesforce integratie API-aanroepen en synchronisatiefouten beheren

Geschreven door HubSpot Support | Oct 8, 2020 6:01:17 AM

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-aanroeplimiet aanpassen

  • Klik in de lijst met verbonden apps op Salesforce.
  • Bekijk op het tabblad Sync Health, in de sectie 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 Allocated to HubSpot om aan te passen hoeveel calls kunnen worden toegewezen aan HubSpot.

Salesforce-synchronisatiefouten weergeven

  • Klik in de lijst met verbonden apps op Salesforce.
  • Op het tabblad Sync gezondheid ziet u onder Sync fouten kaarten voor elk fouttype, met het aantal huidige fouten en getroffen records. Klik op een fouttype om de details van de fouten in het rechterpaneel te zien. Meer informatie over elk fouttype en aanbevelingen voor oplossingen.

  • Klik op het pictogram info info in de kolom Fouttype 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 uw fouten te exporteren, klikt u linksboven in de foutenlijst op Fouten exporteren (CSV) .


Typen Salesforce synchronisatiefouten

Koppelingen

Voorbeelden van koppelingsfouten

  • 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 HubSpot's record associatie limiet hebben bereikt.

De fouten oplossen

Om de fout Associatielimiet bereikt op te lossen, kunt u een aantal van de gekoppelde records verwijderen of ze koppelen aan een ander Salesforce-record en vervolgens doorgaan met synchroniseren.

Om de fout Wachtend op account om te synchroniseren op te lossen, wordt aanbevolen een import van Salesforce-accounts uit te voeren.

Aangepaste code

Voorbeelden van fouten in aangepaste code

  • Automatisering van Salesforce
  • Ontbrekend contact-ID
  • Salesforce aangepaste veld validatieregel
  • 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.

De fouten oplossen

Aangezien deze fouten hun oorsprong vinden in Salesforce, wordt u aangeraden 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 voor duplicaten in Salesforce

Wat betekenen deze fouten?

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

De fouten oplossen

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

Om de fout met de dubbele regel in Salesforce op te lossen, wordt aanbevolen om de overeenkomende regels voor ontdubbeling die zijn ingesteld in Salesforce te controleren.

Machtigingen

Voorbeelden van fouten met machtigingen

  • 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 probeert een Salesforce-veld met een onjuiste waarde bij te werken of een onjuiste koppeling te maken.

Om de fout met de 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 machtigingen van de Salesforce-integratiegebruiker in Salesforce te controleren.

Picklists

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.

Hoe de fouten op te lossen

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

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

Om de fout Mismatched options 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 fout Inactieve Salesforce-eigenaar op te lossen, wijs je het HubSpot-record opnieuw toe aan een gebruiker die een actieve gebruiker is in Salesforce.

De fout Restricted picklist value (Beperkte waarde keuzelijst) treedt op wanneer u de instelling Restricted picklist to the values defined in the value set (Beperk keuzelijst tot de waarden die zijn gedefinieerd in de waarde-instelling ) hebt 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 fout Salesforce-eigenaren niet gesynchroniseerd op te lossen, controleert u of 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, is het aan te raden om extra eigenschapopties in HubSpot en Salesforce te verwijderen die uw 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 Record Type. 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.

Eigenschapstoewijzingen

Voorbeelden van fouten bij property mappings

  • Type mismatch
  • Ontbrekend 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 property- en veldtypen niet compatibel zijn, dat de property of het veld niet meer bestaat of dat er een Salesforce-referentieveldmapping 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. Lees meer over de HubSpot eigenschap-veldtypen die kunnen worden gesynchroniseerd met Salesforce.

De fout Ontbrekende 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 fout Ongeldige Salesforce ID op te lossen, wordt aanbevolen de aangepaste validatieregel te controleren die u hebt ingesteld in Salesforce.

Eigendomswaarden

Voorbeelden van fouten met eigenschappen

  • String te lang
  • Ongeldig e-mailadres
  • 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

Als je de fout String te lang wilt oplossen, 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, werkt u de opmaak van het e-mailadres bij in het Salesforce-record dat u probeert te synchroniseren met HubSpot.

Om de foutmelding Ontbrekend vereist land op te lossen, wordt aanbevolen om te controleren of aan de volgende vereisten is voldaan:

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

Om de fout 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 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 Salesforce Queue-eigenaar.

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

Om de fout 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 meer 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 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.