Salesforce integratie API-aanroepen en synchronisatiefouten beheren

Bij de HubSpot-Salesforce-integratie kunnen synchronisatiefouten optreden, waardoor gegevens niet worden gesynchroniseerd. U kunt deze synchronisatiefouten opsporen en oplossen in uw Salesforce-integratie-instellingen.

API-oproeplimiet aanpassen

1. Klik in je HubSpot-account op het 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 Gegevenssynchronisatie. 
4. Bekijk op het tabblad Synchronisatiestatus, in het gedeelte API-aanroepen gebruiken, hoeveel API-aanroepen je in de afgelopen 24 uur hebt gebruikt. Het getalBeperkt door Salesforce is het aantal API-aanroepen dat je kunt doen op basis van je Salesforce-instellingen. Om aan te passen hoeveel aanroepen aan HubSpot kunnen worden toegewezen, bewerk je het veld Toegewezen aan HubSpot. 

Salesforce-synchronisatiefouten bekijken

1. Klik in je HubSpot-account op het 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 Gegevenssynchronisatie. 
4. Op het tabblad Synchronisatiestatus, in hetgedeelteSynchronisatiefouten , kun je kaarten bekijken voor elk fouttype, met het aantal huidige fouten en de betrokken records. Klik op een kaart met een fouttype om details van de fouten in het rechterpaneel te zien. Lees meer over elk fouttype en aanbevelingen voor het oplossen ervan. 

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

Soorten Salesforce-synchronisatiefouten

Koppelingen

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 de fouten op te lossen 

Om de fout 'Associatielimiet bereikt'op te lossen, kun je ofwel enkele van de gekoppelde records verwijderen, of ze koppelen aan een ander Salesforce-record, en vervolgens doorgaan met de synchronisatie.

Om de fout '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
• Ontbrekend contact-ID
• Validatieregel voor aangepast veld in Salesforce
• 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 dubbele records

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

Wat de fouten betekenen

Een Salesforce-lead of -contact 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 fout 'Salesforce-duplicatieregel' op te lossen, wordt aanbevolen dat een Salesforce-beheerder de overeenkomende regels voor ontdubbeling in Salesforce controleert. Voer vervolgens een samenvoeging, update of verwijdering uit van conflicterende Salesforce-records, of pas de ontdubbelingsregel in Salesforce aan, voordat je opnieuw probeert te synchroniseren in HubSpot.

Toegangsrechten

Voorbeelden van machtigingsfouten

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

Wat de fouten betekenen

Wijzigingen die in HubSpot zijn aangebracht, kunnen niet met Salesforce worden gesynchroniseerd omdat de gekoppelde 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 aan te maken. 

Om de fout met betrekking tot de Salesforce-veldmachtigingen op te lossen, moet u ervoor zorgen dat de Salesforce-integratiegebruiker lees- en bewerkingsrechten heeft voor het veld in Salesforce. 

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

Keuzelijsten

Voorbeelden van fouten met keuzelijsten

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

Wat de fouten betekenen

Records worden niet gesynchroniseerd vanwege een discrepantie tussen de waarden van keuzelijstvelden 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, als de keuzelijst de limiet van het aantal 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, wordt aanbevolen om 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 je instellingen voor de keuzelijst 'Staat en land/gebied ' in Salesforce. 
• De waarde voor 'State' moet bestaan als een beschikbare optievoor 'State/Province'voor de waarde 'Country' van het record in Salesforce. Bovendien moet de interne waarde van de eigenschapoptie 'State' in HubSpot overeenkomen met een bestaande optie voor 'State' 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, wijst u het HubSpot-record opnieuw toe aan een gebruiker die een actieve gebruiker 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 bestaan als een optie in de Salesforce-keuzelijst. 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. 

De fout 'Inactieve opportunity-fase' treedt op wanneer een Salesforce-opportunity met een inactieve opportunity-fase probeert te synchroniseren met HubSpot. Om deze fout op te lossen, wijzigt u de opportunity-fase in Salesforce in 'Actief'of verplaatst u de opportunity naar een actieve fase. 

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

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

In de meeste gevallen treedt de fout 'Standaardverkoopproces niet beschikbaar ' op wanneer Salesforce-opportuniteiten worden gesynchroniseerd met HubSpot en er een recordtype ontbreekt. Als je recordtypes in Salesforce hebt ingeschakeld, maar deze niet gebruikt, of als je Salesforce-opportuniteiten hebt zonder recordtype, wordt aanbevolen om samen met Salesforce alle recordtypes te deactiveren of een nieuw recordtype aan te maken. 

Om de fout 'Ontbrekende of ongeldige opportunity-fase' op te lossen, moet je ervoor zorgen dat de waarde van de Salesforce-opportunity-fase bestaat in de HubSpot-pijplijn.

Voor fouten in het Salesforce-taakveld vergelijk je de waarden voor Taakprioriteit, Status of Type in Salesforce met de overeenkomstige taak-eigenschapopties in HubSpot. Taakprioriteit ondersteunt alleen Hoog, Gemiddeld, Laag en Geen. Voor Status en Type werk je de Salesforce-waarden bij zodat ze exact overeenkomen met de beschikbare opties in HubSpot, of voeg je overeenkomende opties toe in HubSpot.

Eigenschapstoewijzingen

Voorbeelden van fouten in eigenschapstoewijzingen 

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

Wat de fouten betekenen

Records worden niet gesynchroniseerd vanwege een discrepantie in de toewijzing 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 aangemaakt.

Hoe de fouten op te lossen 

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-eigenschapveldtypen die kunnen worden gesynchroniseerd met Salesforce. 

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

Om de fout 'Ongeldige Salesforce-ID' op te lossen, wordt aanbevolen om de aangepaste validatieregel te controleren die je in Salesforce hebt ingesteld. 

Eigenschapswaarden

Voorbeelden van fouten met eigenschapswaarden

• Te lange tekenreeks
• 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 eigenschapswaarden bevatten die ongeldig zijn. Om deze fouten te verhelpen, moeten de betreffende records doorgaans worden bijgewerkt.

Hoe u de fouten kunt oplossen

Om de fout 'String te lang' op te lossen, moet je de veldwaarde in Salesforce of HubSpot inkorten, of het maximum aantal tekens van het veld in Salesforce verhogen. 

Om de fout 'Ongeldig e-mailadres ' op te lossen, moet u de opmaak van het e-mailadres bijwerken in het Salesforce-record dat wordt gesynchroniseerd met HubSpot.

Om de fout 'Verplicht land ontbreekt' op te lossen, wordt aanbevolen om 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 de instellingen voor de keuzelijst 'Staat en land/gebied ' in Salesforce. 
• De waarde voor de staat moet bestaan als een beschikbare optie voor staat/provincievoor de waarde van het land van het record in Salesforce. Bovendien moet de interne waarde van de eigenschapoptie 'Staat' in HubSpot overeenkomen met een bestaande optie voor staat in Salesforce. 

Om de fout 'Ongeldige waarde ' op te lossen, wordt aanbevolen om 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 fout 'Beperkte unieke waarde' op te lossen, wordt aanbevolen om de overeenkomingsregels voor ontdubbeling te controleren die je in Salesforce hebt ingesteld. 

Om de fout 'Ontbrekende vereiste waarde' op te lossen , voeg je een waarde toe aan het Salesforce-record voor elke eigenschap die in HubSpot als vereist is gemarkeerd. 

Overig

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

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

Meldingen voor synchronisatiefouten instellen

1. Klik in je HubSpot-account op het 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 Gegevenssynchronisatie. 
4. Klik op het tabblad Synchronisatiestatus, in het gedeelte Synchronisatiefouten , 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.