- Vidensbase
- Konto og opsætning
- Integrationer
- Håndter API-opkald til Salesforce-integration og synkroniseringsfejl
Håndter API-opkald til Salesforce-integration og synkroniseringsfejl
Sidst opdateret: 3 september 2025
Gælder for:
-
Marketing Hub Professional, Enterprise
-
Salg Hub Professional, Enterprise
-
Service Hub Professional, Enterprise
-
Data Hub Professional, Enterprise
-
Content Hub Professional, Enterprise
HubSpot-Salesforce-integrationen kan støde på synkroniseringsfejl, som forhindrer data i at blive synkroniseret. Du kan identificere og løse disse synkroniseringsfejl i dine Salesforce-integrationsindstillinger.
Juster grænsen for API-opkald
- På din HubSpot-konto skal du klikke på settings indstillingsikonet på den øverste navigationslinje. I menuen til venstre skal du navigere til Integrationer > Forbundne apps.
- Klik på Salesforce på listen over tilsluttede apps.
- På fanen Sync Health i afsnittet API call use kan du se, hvor mange API-opkald du har brugt i de sidste 24 timer. Tallet Limited by Salesforce er den mængde API-opkald, du kan foretage baseret på dine Salesforce-indstillinger. For at justere, hvor mange opkald der kan allokeres til HubSpot, skal du redigere feltet Allokeret til HubSpot.
Se Salesforce-synkroniseringsfejl
- På din HubSpot-konto skal du klikke på settings indstillingsikonet på den øverste navigationslinje. I menuen til venstre skal du navigere til Integrationer > Forbundne apps.
- Klik på Salesforce på listen over tilsluttede apps.
- På fanen Sync Health under Sync errors kan du se kort for hver fejltype med antallet af aktuelle fejl og påvirkede poster. Klik på et fejltypekort for at se detaljer om fejlene i højre panel. Få mere at vide om hver fejltype og anbefalinger til løsning.
- Klik på ikonet info info i kolonnen Fejltype for at se flere detaljer om en fejl.
- Hvis du vil gøre noget ved individuelle poster, skal du klikke på [#] poster i kolonnen Berørte poster og derefter klikke på Handlinger > Opret en midlertidig visning af HubSpot-poster for at oprette en filtreret visning af de berørte poster.
- Når du har løst fejlene, skal du gå tilbage til fejllisten. Marker afkrydsningsfeltet til venstre for alle løste fejl, og klik på Resync.
- Hvis du vil eksportere dine fejl, skal du klikke på Eksporter fejl (CSV) øverst til venstre på fejllisten.

Typer af Salesforce-synkroniseringsfejl
Tilknytninger
Eksempler på fejl i associationer
- Associeringsgrænse nået
- Venter på, at kontoen synkroniseres
Hvad fejlene betyder
Poster synkroniseres ikke, fordi de er tilknyttet Salesforce-konti, der endnu ikke er synkroniseret med HubSpot-virksomheder, eller fordi de er tilknyttet poster, der har ramt HubSpots grænse for tilknytning af poster.
Sådan løser du fejlene
For at løse fejlen Association limit reached kan du enten fjerne nogle af de tilknyttede poster eller knytte dem til en anden Salesforce-post og derefter fortsætte med synkroniseringen.
For at løse fejlen Waiting for account to sync anbefales det, at du kører en import af Salesforce-konti.
Brugerdefineret kode
Eksempler på fejl i brugerdefineret kode
- Salesforce-automatisering
- Manglende kontakt-id
- Regel for validering af brugerdefineret felt i Salesforce
- Salesforce-flow
Hvad fejlene betyder
Posterne synkroniseres ikke på grund af et problem, der skyldes automatisering, flows eller valideringsregler i din Salesforce-konto.
Sådan løses fejlene
Da disse fejl stammer fra Salesforce, anbefales det, at du samarbejder med din Salesforce-administrator om at løse problemet i din brugerdefinerede kode i Salesforce.
Duplikater
Eksempler på duplikatfejl
- E-mail allerede i brug
- Salesforce-regel for duplikat
Hvad betyder fejlene?
Et Salesforce-lead eller en kontakt kan ikke synkroniseres med HubSpot, fordi e-mailadressen allerede findes i en HubSpot-kontaktoptegnelse eller på grund af en deduplikeringsregel i Salesforce.
Sådan løses fejlene
For at løse fejlen E-mail allerede i brug skal du fjerne e-mailadressen fra den eksisterende HubSpot-kontakt.
For at løse Salesforce-duplikatregelfejlen anbefales det, at du kontrollerer de matchende regler for deduplikering, der er konfigureret i Salesforce.
Tilladelser
Eksempler på fejl i tilladelser
- Utilstrækkelig adgang eller manglende Salesforce-post
- Tilladelse til Salesforce-felt
- Utilstrækkelig adgang til Salesforce
Hvad fejlene betyder
Ændringer foretaget i HubSpot kan ikke synkroniseres med Salesforce, fordi den tilsluttede bruger ikke har adgang til det nødvendige felt eller objekt i Salesforce.
Sådan løses fejlene
I de fleste tilfælde opstår fejlen Utilstrækkelig adgang eller manglende Salesforce-post , når integrationen forsøger at opdatere et Salesforce-felt med en forkert værdi eller oprette en forkert tilknytning.
For at løse fejlen med tilladelse til Salesforce-feltet skal du sikre dig, at Salesforce-integrationsbrugeren har læse- og redigeringstilladelse til feltet i Salesforce.
Fejlen Utilstrækkelig adgang til Salesforce opstår, når Salesforce-integrationsbrugeren ikke kan udføre handlingen i Salesforce på grund af deres brugertilladelser i Salesforce. Det anbefales, at du kontrollerer Salesforce-integrationsbrugerens tilladelser i Salesforce.
Picklister
Eksempler på fejl i picklister
- Manglende mulighed for Salesforce-pickliste
- Uoverensstemmende værdi for stat eller land
- Uoverensstemmende indstillinger
- Inaktiv Salesforce-ejer
- Begrænset pickliste-værdi
- Inaktivt mulighedstrin
- Salesforce-ejere er ikke synkroniseret
- Grænse for valgmuligheder overskredet
- Standard salgsproces ikke tilgængelig
- Manglende eller ugyldig mulighedstrin
Hvad fejlene betyder
Poster synkroniseres ikke på grund af en uoverensstemmelse mellem picklist-feltværdier i HubSpot og Salesforce. Dette kan ske, når en picklisteværdi i det ene system ikke matcher nogen aktuelle værdier i det andet, hvis picklisten har nået en grænse for værdier, eller hvis den overførte værdi ikke er gyldig.
Sådan løser du fejlene
For at løse fejlen Mismatched state or country value anbefales det, at du kontrollerer, at følgende krav er opfyldt:
- Den interne værdi af egenskabsmuligheden Land i HubSpot skal matche en eksisterende landemulighed i dine indstillinger for State og Country/Territory picklist i Salesforce.
- State-værdien skal eksistere som en Available State/Province-mulighed for postens Country-værdi i Salesforce. Derudover skal den interne værdi af State-egenskabsindstillingen i HubSpot matche en eksisterende State-indstilling i Salesforce.
For at løse fejlen Mismatched options anbefales det, at du opdaterer det interne/API-navn på Salesforce-feltindstillingerne, så de matcher den interne værdi af egenskabsindstillingerne i HubSpot.
For at løse fejlen Inaktiv Salesforce-ejer skal du tildele HubSpot-posten til en bruger, der er en aktiv bruger i Salesforce.
Fejlen Restricted picklist value opstår, når du har indstillingen Restrict picklist to the values defined in the value set slået til for feltet i Salesforce. Når dette er slået til i Salesforce, skal den værdi, du forsøger at synkronisere fra HubSpot til Salesforce, eksistere som en mulighed i Salesforces pickliste. Det anbefales, at du slår Begræns picklisten til de værdier, der er defineret i værdisætindstillingen i Salesforce, fra, så alle værdier kan synkroniseres fra HubSpot til Salesforce.
Fejlen Inactive opportunity stage opstår, når en Salesforce-mulighed med et inaktivt opportunity stage forsøger at synkronisere til HubSpot. For at løse denne fejl skal du ændre mulighedsstadiet i Salesforce til aktivt eller flytte muligheden til et aktivt stadie.
For at løse fejlen Salesforce-ejere ikke synkroniseret skal du sikre dig, at Salesforce-brugerne har brugertype indstillet til Standard, Power Partner eller Guest i Salesforce.
For at løse fejlen Option limit exceeded anbefales det, at du sletter ekstra ejendomsindstillinger i HubSpot og Salesforce, som dit team ikke bruger. Sørg desuden for, at alle kortlagte egenskaber har tilsvarende felttyper.
I de fleste tilfælde opstår fejlen Default sales process unavailable , når Salesforce-muligheder forsøger at synkronisere til HubSpot med en manglende Record Type. Hvis du har aktiveret Record Types i Salesforce, men ikke bruger dem, eller hvis du har Salesforce-muligheder uden en Record Type, anbefales det, at du samarbejder med Salesforce om at deaktivere alle Record Types eller oprette en ny Record Type.
For at løse fejlen Missing or invalid opportunity stage skal du sikre dig, at værdien for Salesforce opportunity stage findes i HubSpot-pipelinen.
Tilknytning af egenskaber
Eksempler på fejl i property mappings
- Uoverensstemmelse mellem typer
- Manglende Salesforce-id
- Ugyldigt Salesforce-id
Hvad fejlene betyder
Posterne synkroniseres ikke på grund af en uoverensstemmelse i mappingen mellem HubSpot-egenskaben og Salesforce-feltet. Det kan betyde, at egenskabs- og felttyperne ikke er kompatible, at egenskaben eller feltet ikke længere findes, eller at der skal oprettes en Salesforce-referencefeltmapping.
Sådan løses fejlene
For at løse fejlen Type mismatch skal du sikre dig, at egenskabstypen i HubSpot og felttypen i Salesforce er kompatible. Få mere at vide om de HubSpot-egenskabsfelttyper, der kan synkroniseres med Salesforce.
Fejlen Manglende Salesforce-id opstår, når HubSpot forsøger at synkronisere en anden værdi end et eksisterende Salesforce-id til et reference-/opslagsfelt i Salesforce.
For at løse fejlen Ugyldigt Sales force-id anbefales det, at du tjekker den brugerdefinerede valideringsregel, som du har opsat i Salesforce.
Egenskabsværdier
Eksempler på fejl i egenskabsværdier
- Streng for lang
- Ugyldig e-mail
- Mangler påkrævet land
- Ugyldig værdi
- Tildeling af ejer
- Begrænset unik værdi
- Mangler påkrævet værdi
Hvad fejlene betyder
Records synkroniseres ikke mellem HubSpot og Salesforce, fordi de indeholder ejendomsværdier, der ikke er gyldige. Disse fejl kræver typisk, at de enkelte berørte poster opdateres for at rette fejlen.
Sådan løses fejlene
For at løse fejlen String too long skal du forkorte feltværdien i Salesforce eller HubSpot eller øge tegngrænsen for feltet i Salesforce.
For at løse fejlen Ugyldig e-mail skal du opdatere formateringen af e-mailadressen på den Salesforce-post, der forsøger at synkronisere til HubSpot.
For at løse fejlen Missing required country anbefales det, at du kontrollerer, at følgende krav er opfyldt:
- Den interne værdi af egenskabsmuligheden Land i HubSpot skal matche en eksisterende landemulighed i dine indstillinger for State og Country/Territory picklist i Salesforce.
- State-værdien skal eksistere som en Available State/Province-mulighed for postens Country-værdi i Salesforce. Derudover skal den interne værdi af State-egenskabsindstillingen i HubSpot matche en eksisterende State-indstilling i Salesforce.
For at løse fejlen Ugyldig værdi anbefales det, at du opdaterer egenskabsværdien på Salesforce-posten, så den opfylder HubSpots krav til egenskabsværdien.
I de fleste tilfælde opstår fejlen Owner Assignment , når en HubSpot-aktivitet synkroniseres til Salesforce som en Salesforce-opgave, og HubSpot forsøger at tildele opgaven til en Salesforce Queue-ejer.
For at løse fejlen Restricted unique value anbefales det, at du tjekker de matchende regler for deduplikering, du har sat op i Salesforce.
For at løse fejlen Missing required value skal du tilføje en værdi til Salesforce-posten for enhver egenskab, der er markeret som påkrævet i HubSpot.
Andet
Posterne synkroniseres ikke på grund af en ukendt fejl. Kontakt venligst HubSpot Support for yderligere hjælp til disse fejl.
Bemærk: Det er muligt at massesynkronisere 100 Salesforce-fejl ad gangen. Hvis du vil synkronisere mere end 100 fejl, skal du importere posterne fra Salesforce eller opdatere en kortlagt egenskab.
Opsæt meddelelser om synkroniseringsfejl
- På din HubSpot-konto skal du klikke på settings indstillingsikonet på den øverste navigationslinje. I menuen til venstre skal du navigere til Integrationer > Forbundne apps.
- Klik på Salesforce på listen over forbundne apps.
- Klik på fanen Sync Health.
- Klik på Administrer meddelelser under Synkroniseringsfejl.
- I dialogboksen skal du slå kontakten Turn on notifications til.
- Vælg alternativknappen ved siden af Instantly, Daily eller Weekly for at indstille hyppigheden af dine notifikationer.
- Klik på Gem.