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 op Salesforce.
3. Ga naar het tabblad Synchronisatiestatus.
4. Bekijk in het gedeelte API-aanroepen gebruiken hoeveel API-aanroepen u in de afgelopen 24 uur hebt gebruikt. Het aantal Beperkt 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 verbonden apps op Salesforce.
3. Ga naar het tabblad Sync Health.
4. Bekijk onder 'Sync errors'(Synchronis atiefouten) 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. Als je meer details over een fout wilt zien, klik je op het info-pictogram ' info ' in de kolom 'Fouttype '.
6. Om actie te ondernemen op individuele records, klik je op [#] records in de kolom Affected Records (Getroffen records) en vervolgens op Actions (Acties) > Create a temporary view of HubSpot records (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 het selectievakje links van de opgeloste fouten in en klik op Opnieuw synchroniseren.
8. Om uw fouten te exporteren, klikt u 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, raden we je aan de overeenkomende regels voor ontdubbeling in Salesforce te controleren.

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 u de fouten kunt oplossen

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 foutmelding '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
• Niet-overeenkomende opties
• 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 de 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, 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 op wanneer u 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 u wilt 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.

De foutmelding '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 actief of 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 Standaardverkoopproces niet beschikbaar op wanneer Salesforce-opportuniteiten worden gesynchroniseerd met HubSpot en er een recordtype ontbreekt. 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 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 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 u de fouten kunt oplossen

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 foutmelding 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 maximum 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 'Provincie' moet bestaan als een beschikbare optie voor de waarde 'Land' van het record in Salesforce. Bovendien moet de interne waarde van de eigenschap 'Provincie' in HubSpot overeenkomen met een bestaande optie 'Provincie' 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 Salesforce-wachtrij-eigenaar.

Om de fout '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 op Salesforce.
3. Ga naar het tabblad Synchronisatiestatus.
4. Klik onder Synchronisatiefouten op Meldingen beheren.
5. Schakel in het dialoogvenster de schakelaar Meldingen inschakelen in.
6. Selecteer het keuzerondje naast Direct, Dagelijks of Wekelijks om de frequentie van uw meldingen in te stellen.
7. Klik op Opslaan.