API-aanroepen voor Salesforce-integratie en synchronisatiefouten beheren

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

Pas de limiet voor API-aanroepen aan

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 gebruikt, hoeveel API-aanroepen je in de afgelopen 24 uur hebt gebruikt. Het getalBeperkt door Salesforce is het aantal API-aanroepen dat je mag 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 hetgedeelte'Synchronisatiefouten' , zie je kaarten voor elk fouttype, met het aantal huidige fouten en de betrokken records. Klik op een kaart voor een fouttype om de details van de fouten in het rechterpaneel te bekijken. 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, klik je 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 koppelingsfouten 

• Limiet voor koppelingen bereikt
• Wachten op synchronisatie van account

• Conflict in de kardinaliteit van associaties

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. 

De fout 'Kardinaliteitsconflict bij koppeling' treedt op wanneer een activiteit die in HubSpot aan meerdere contactpersonen is gekoppeld, wordt gesynchroniseerd met Salesforce. De integratie ondersteunt slechts één contactpersoonkoppeling per activiteit.

Hoe de fouten op te lossen 

Om de fout 'Associatielimiet bereikt'op te lossen, kun je ofwel enkele van de gekoppelde records verwijderen, ofwel 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. 

Om de fout 'Association cardinality mismatch' op te lossen, verwijdert u extra contactkoppelingen, zodat er slechts één contact aan de activiteit gekoppeld blijft.

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-contactrecord.

Om de fout 'Salesforce-duplicaatregel' op te lossen, wordt aanbevolen dat een Salesforce-beheerder de in Salesforce ingestelde regels voor het opsporen van duplicaten controleert. Voer vervolgens een samenvoeging uit, werk de conflicterende Salesforce-records bij of verwijder ze, of pas de regel voor het opsporen van duplicaten in Salesforce aan, voordat je opnieuw probeert te synchroniseren in HubSpot.

Toegangsrechten

Voorbeelden van fouten met betrekking tot machtigingen

• 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 optie in de Salesforce-keuzelijst
• 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
• Standaardverkoopproces 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 een van 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'Niet-overeenkomende waarde voor status of land' 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 'Land'- optie 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 van '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 'Opties komen niet overeen' 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 actief is in Salesforce. 

De fout 'Beperkte keuzelijstwaarde' treedt opwanneer je de instelling 'Keuzelijst beperken tot de waarden die zijn gedefinieerd in de waardenset' 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 als optie voorkomen in de keuzelijst van Salesforce. Het wordt aanbevolen om de instelling 'Beperk keuzelijst tot de waarden die zijn gedefinieerd in de waardenset' 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 wordt gesynchroniseerd met HubSpot. Om deze fout op te lossen, wijzig je de opportunity-fase in Salesforce naar 'actief'of verplaats je 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 terwijl er een recordtype ontbreekt. Als je recordtypen in Salesforce hebt ingeschakeld, maar deze niet gebruikt, of als je Salesforce-opportuniteiten hebt zonder recordtype, wordt aanbevolen om samen met Salesforce alle recordtypen 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 voorkomt in de HubSpot-pijplijn.

Vergelijk bij fouten in Salesforce-taakvelden de waarden voor 'Taakprioriteit', 'Status' of 'Type' in Salesforce met de bijbehorende taak-eigenschappen in HubSpot. Voor 'Taakprioriteit' worden alleen 'Hoog', 'Gemiddeld', 'Laag' en 'Geen' ondersteund. Pas voor 'Status' en 'Type' de Salesforce-waarden aan zodat ze exact overeenkomen met de beschikbare opties in HubSpot, of voeg overeenkomende opties toe in HubSpot.

Toewijzingen van eigenschappen

Voorbeelden van fouten bij 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 toewijzing voor een Salesforce-referentieveld 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-eigenschapstypen die met Salesforce kunnen worden gesynchroniseerd. 

De fout 'Ontbrekende Salesforce-ID' treedt op wanneer HubSpot heeft geprobeerd een waarde die geen bestaande Salesforce-ID is, 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
• Verplichte waarde ontbreekt

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 'Te lange tekenreeks' 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 aanpassen 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 'Land '-optie in uw 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 van 'Country' van het record in Salesforce. Bovendien moet de interne waarde van de eigenschap 'State' in HubSpot overeenkomen met een bestaande optie voor 'State' in Salesforce. 

Om de fout 'Ongeldige waarde ' op te lossen, wordt aanbevolen de eigenschapswaarde in het Salesforce-record aan te passen zodat deze voldoet aan de vereisten van HubSpot voor de eigenschapswaarde. 

In de meeste gevallen treedt de fout 'Eigenaarstoewijzing' op wanneer een HubSpot-activiteit naar Salesforce wordt gesynchroniseerd 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, wordt aanbevolen om de overeenstemmingsregels voor het verwijderen van dubbele records te controleren die u in Salesforce hebt ingesteld. 

Om de fout 'Ontbrekende verplichte waarde' op te lossen , voegt u een waarde toe aan het Salesforce-record voor elke eigenschap die in HubSpot als verplicht is gemarkeerd. 

Overig / Onbekend

Voorbeeld van een 'Overige/Onbekende'-fout

• Er is een onbekende Salesforce-duplicaatfout opgetreden: er is een dubbele id opgegeven.

Wat de foutmelding betekent

Deze fout kan optreden als je een veldtoewijzing maakt die een standaard Salesforce-ID-veld bevat, zoals 'Lead-ID' of 'Contact-ID', en dit toewijst aan de bijbehorende eigenschap 'Salesforce Lead-ID' of 'Salesforce Contact-ID' in HubSpot.

Hoe de fout op te lossen

Deze ID-waarden worden automatisch beheerd door de integratie en mogen niet worden opgenomen in aangepaste veldtoewijzingen. Het aanmaken van deze toewijzingen kan onverwacht synchronisatiegedrag veroorzaken, met name wanneer de synchronisatieregel is ingesteld op tweerichtingssynchronisatie.

Neem voor andere onbekende fouten contact op met HubSpot Support voor verdere hulp.

Let op: het is mogelijk om 100 Salesforce-fouten tegelijk in bulk opnieuw te synchroniseren. Om meer dan 100 fouten te synchroniseren, importeer je de records uit Salesforce of werk je 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 ', op'Meldingen beheren'. 
5. Zet in het dialoogvenster de schakelaar'Meldingen inschakelen' aan. 
6. Selecteer het keuzerondje naast'Direct','Dagelijks' of'Wekelijks' om de frequentie van uw meldingen in te stellen. 
7. Klik op'Opslaan'.