Håndter API-opkald til Salesforce-integration og synkroniseringsfejl

Der kan opstå synkroniseringsfejl i HubSpot-Salesforce-integrationen, som forhindrer data i at blive synkroniseret. Du kan identificere og løse disse synkroniseringsfejl i dine Salesforce-integrationsindstillinger.

Juster grænsen for API-kald

1. På din HubSpot-konto skal du klikke på indstillingsikonet på den øverste navigationslinje. I menuen til venstre skal du navigere til Integrationer > Forbundne apps.
2. Klik påSalesforce i listen over tilknyttede apps. 
3. Gå til fanen Datasynkronisering. 
4. På fanen Synkroniseringsstatus kan du i afsnittet API-kaldse, hvor mange API-kald du har brugt i løbet af de sidste 24 timer. TalletBegrænset af Salesforce er det antal API-kald, du kan foretage, baseret på dine Salesforce-indstillinger. For at justere, hvor mange kald der kan tildeles til HubSpot, skal du redigere feltet Tildelt til HubSpot. 

Se Salesforce-synkroniseringsfejl

1. På din HubSpot-konto skal du klikke på indstillingsikonet på den øverste navigationslinje. I menuen til venstre skal du navigere til Integrationer > Forbundne apps.
2. Klik påSalesforce i listen over tilknyttede apps. 
3. Gå til fanen Datasynkronisering. 
4. På fanen Synkroniseringsstatus kan du iafsnittetSynkroniseringsfejl se kort for hver fejltype med antallet af aktuelle fejl og berørte poster. Klik på et kort for en fejltype for at se detaljer om fejlene i panelet til højre. Få mere at vide om hver fejltype og anbefalinger til løsning. 

5. For at se flere detaljer om en fejl skal du klikke på info-ikonet i kolonnen Fejltype .
6. For at udføre handlinger på 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. 
7. Når du har løst fejlene, skal du vende tilbage til fejllisten. Markerafkrydsningsfeltet til venstre for de løste fejl, og klik på Synkroniser igen.
8. For at eksportere dine fejl skal du klikke på Eksporter fejl (CSV) øverst til venstre på fejllisten.

Typer af Salesforce-synkroniseringsfejl

Tilknytninger

Eksempler på associeringsfejl 

• Forbindelsesgræ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 nået HubSpots grænse for posttilknytning. 

Sådan løses fejlene 

For at løse fejlen" Tilknytningsgrænsen er nået" kan du enten fjerne nogle af de tilknyttede poster eller tilknytte dem til en anden Salesforce-post og derefter fortsætte med synkroniseringen.

For at løse fejlen "Venter på, at kontoen synkroniseres " anbefales det, at du kører en import af Salesforce-konti. 

Brugerdefineret kode

Eksempler på fejl i brugerdefineret kode 

• Salesforce-automatisering
• Manglende kontakt-ID
• Valideringsregel for brugerdefineret felt i Salesforce
• Salesforce-flow

Hvad fejlene betyder

Poster synkroniseres ikke på grund af et problem forårsaget af automatisering, flows eller valideringsregler i din Salesforce-konto.

Sådan løses fejlene

Duplikater

Eksempler på fejl vedrørende dubletter

• E-mail-adresse er allerede i brug
• Salesforce-regel for dubletter

Hvad fejlene betyder

En Salesforce-lead eller -kontakt kan ikke synkroniseres med HubSpot, fordi e-mailadressen allerede findes i en HubSpot-kontaktpost, eller på grund af en deduplikationsregel i Salesforce. 

Sådan løses fejlene

For at løse fejlen " E-mailen er allerede i brug " skal du fjerne e-mailadressen fra den eksisterende HubSpot-kontakt.

For at løse fejlen " Salesforce-duplikatregel " anbefales det, at en Salesforce-administrator gennemgår de matchende regler for deduplikering, der er opsat i Salesforce. Derefter skal du flette, opdatere eller slette eventuelle konfliktende Salesforce-poster eller justere deduplikationsreglen i Salesforce, før du forsøger at synkronisere igen i HubSpot.

Tilladelser

Eksempler på tilladelsesfejl

• Utilstrækkelig adgang eller manglende Salesforce-post
• Salesforce-feltrettighed
• Utilstrækkelig Salesforce-adgang

Hvad fejlene betyder

Ændringer foretaget i HubSpot kan ikke synkroniseres med Salesforce, fordi den tilknyttede 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 Salesforce-feltrettigheder skal du sikre dig, at Salesforce-integrationsbrugeren har læse- og redigeringsrettigheder til feltet i Salesforce. 

Fejlen " Utilstrækkelig Salesforce-adgang " opstår, når Salesforce-integrationsbrugeren ikke kan udføre handlingen i Salesforce på grund af brugerrettighederne i Salesforce. Det anbefales, at du tjekker Salesforce-integrationsbrugerens rettigheder i Salesforce.

Valglister

Eksempler på fejl i udvælgelseslister

• Manglende valgmulighed i Salesforce-udvælgelseslisten
• Uoverensstemmende værdi for stat eller land
• Uoverensstemmende valgmuligheder
• Inaktiv Salesforce-ejer
• Begrænset værdien i udvælgelseslisten
• Inaktivt salgsmulighedstrin
• Salesforce-ejere er ikke synkroniseret
• Valgmulighedsgrænse overskredet
• Standard salgsproces ikke tilgængelig
• Manglende eller ugyldig salgsmulighedsfase

Hvad fejlene betyder

Poster synkroniseres ikke på grund af en uoverensstemmelse mellem værdierne i udvælgelseslisterne i HubSpot og Salesforce. Dette kan ske, når en værdi i en udvælgelsesliste i det ene system ikke matcher nogen aktuelle værdier i det andet, hvis udvælgelseslisten har nået en grænse for antallet af værdier, eller hvis den overførte værdi ikke er gyldig.

Sådan løses 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 for egenskaben Land i HubSpot skal matche en eksisterende landindstilling i dine indstillinger for stat og land/territorium i Salesforce. 
• Værdien for "State" skal findes som en tilgængelig "State/Province"-indstillingfor postens "Country" -værdi i Salesforce. Derudover skal den interne værdi for egenskaben "State" i HubSpot matche en eksisterende "State" -indstilling i Salesforce. 

For at løse fejlen " Uoverensstemmende valgmuligheder " anbefales det, at du opdaterer det interne navn/API-navnet på Salesforce-feltets valgmuligheder, så det matcher den interne værdi af egenskabsvalgmulighederne i HubSpot. 

For at løse fejlen " Inaktiv Salesforce-ejer " skal du tildele HubSpot-posten til en bruger, der er aktiv i Salesforce. 

Fejlen"Begrænset værdiliste" opstår, når indstillingen "Begræns værdilisten til de værdier, der er defineret i værdisættet " er aktiveret for feltet i Salesforce. Når denne indstilling er aktiveret i Salesforce, skal den værdi, du forsøger at synkronisere fra HubSpot til Salesforce, findes som en mulighed i Salesforce-værdilisten. Det anbefales, at du deaktiverer indstillingen " Begræns valgfeltet til de værdier, der er defineret i værdisættet " i Salesforce, så alle værdier kan synkroniseres fra HubSpot til Salesforce. 

Fejlen "Inaktivt salgsmulighedstrin" opstår , når en Salesforce-salgsmulighed med et inaktivt salgsmulighedstrin forsøger at synkronisere med HubSpot. For at løse denne fejl skal du ændre salgsmulighedstrinnet i Salesforce til aktivteller flytte salgsmuligheden til et aktivt trin. 

For at løse fejlen " Salesforce-ejere er ikke synkroniseret " skal du sikre dig, at Salesforce-brugerne har brugertypen indstillet til Standard, Power Partner eller Gæst i Salesforce. 

For at løse fejlen " Option limit exceeded " anbefales det, at du sletter ekstra egenskabsindstillinger i HubSpot og Salesforce, som dit team ikke bruger. Sørg desuden for, at alle tilknyttede egenskaber har tilsvarende felttyper. 

I de fleste tilfælde opstår fejlen " Standard salgsproces ikke tilgængelig ", når Salesforce-muligheder forsøger at synkronisere med HubSpot med en manglende rekordtype. Hvis du har aktiveret rekordtyper i Salesforce, men ikke bruger dem, eller har Salesforce-muligheder uden en rekordtype, anbefales det, at du samarbejder med Salesforce om at deaktivere alle rekordtyper eller oprette en ny rekordtype. 

For at løse fejlen " Manglende eller ugyldig salgsmulighedsfase " skal du sikre dig, at værdien for salgsmulighedsfasen i Salesforce findes i HubSpot-pipeline.

Ved fejl i Salesforce-opgavefelter skal du sammenligne værdierne for opgaveprioritet, status eller type i Salesforce med de tilsvarende opgaveegenskabsindstillinger i HubSpot. Opgaveprioritet understøtter kun Høj, Medium, Lav og Ingen. For status og type skal du opdatere Salesforce-værdierne, så de matcher de tilgængelige indstillinger i HubSpot nøjagtigt, eller tilføje matchende indstillinger i HubSpot.

Egenskabskortlægninger

Eksempler på fejl i egenskabskortlægning 

• Typefejl
• Manglende Salesforce-ID
• Ugyldigt Salesforce-ID

Hvad fejlene betyder

Poster synkroniseres ikke på grund af en uoverensstemmelse i mappingen mellem HubSpot-egenskaben og Salesforce-feltet. Dette kan betyde, at egenskabs- og felttyperne ikke er kompatible, at egenskaben eller feltet ikke længere findes, eller at der skal oprettes en Salesforce-referencemapping.

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 har forsøgt at synkronisere en værdi, der ikke er et eksisterende Salesforce-ID, til et reference-/opslagsfelt i Salesforce. 

For at løse fejlen " Ugyldigt Salesforce-ID " anbefales det, at du tjekker den brugerdefinerede valideringsregel, du har oprettet i Salesforce. 

Egenskabsværdier

Eksempler på fejl i egenskabsværdier

• Streng for lang
• Ugyldig e-mail
• Manglende obligatorisk land
• Ugyldig værdi
• Tildeling af ejer
• Begrænset unik værdi
• Manglende obligatorisk værdi

Hvad fejlene betyder

Poster 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 " Strengen er for lang " skal du forkorte feltværdien i Salesforce eller HubSpot eller øge feltets tegnbegrænsning i Salesforce. 

For at løse fejlen "Ugyldig e-mail " skal du opdatere formateringen af e-mailadressen i den Salesforce-post, der forsøger at synkronisere med HubSpot.

For at løse fejlen " Manglende obligatorisk land " anbefales det, at du kontrollerer, at følgende krav er opfyldt:

• Den interne værdi for egenskaben Land i HubSpot skal matche en eksisterende landevalg i dine indstillinger for stat og land/territorium i Salesforce. 
• Værdien for "State" skal findes som en tilgængelig "State/Province"-indstillingfor postens "Country" -værdi i Salesforce. Derudover skal den interne værdi for egenskaben "State" i HubSpot matche en eksisterende "State" -indstilling i Salesforce. 

For at løse fejlen " Ugyldig værdi " anbefales det, at du opdaterer egenskabsværdien i Salesforce-posten, så den opfylder HubSpots krav til egenskabsværdien. 

I de fleste tilfælde opstår fejlen "Ejer-tildeling ", når en HubSpot-aktivitet synkroniseres til Salesforce som en Salesforce-opgave, og HubSpot forsøger at tildele opgaven til en ejer af en Salesforce-kø.

For at løse fejlen " Begrænset unik værdi " anbefales det, at du kontrollerer de matchingsregler for deduplikering, du har opsat i Salesforce. 

For at løse fejlen Manglende påkrævet værdi skal du tilføje en værdi til Salesforce-posten for alle egenskaber , der er markeret som påkrævede i HubSpot. 

Andet

Poster synkroniseres ikke på grund af en ukendt fejl. Kontakt HubSpot Support for yderligere hjælp til disse fejl.

Bemærk: Det er muligt at synkronisere 100 Salesforce-fejl ad gangen. For at synkronisere mere end 100 fejl skal du importere posterne fra Salesforce eller opdatere en tilknyttet egenskab.

Opsæt meddelelser om synkroniseringsfejl

1. På din HubSpot-konto skal du klikke på indstillingsikonet på den øverste navigationslinje. I menuen til venstre skal du navigere til Integrationer > Forbundne apps.
2. Klik påSalesforce i listen over tilknyttede apps. 
3. Gå til fanen Datasynkronisering. 
4. Klik påAdministrer meddelelser i afsnittet Synkroniseringsfejl på fanen Synkroniseringsstatus. 
5. I dialogboksen skal du slå kontaktenAktiver meddelelser til. 
6. Vælg radioknappen ved siden afØjeblikkeligt,Dagligt ellerUgentligt for at indstille hyppigheden af dine meddelelser. 
7. Klikpå Gem.