Administrer API-kald til Salesforce-integrationen 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 på 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 angiver 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 på 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 de 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å fejl i tilknytninger 

• Forbindelsesgrænse nået
• Venter på, at kontoen synkroniseres

• Uoverensstemmelse i kardinalitet mellem tilknytninger

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. 

Fejlen " Uoverensstemmelse i tilknytningens kardinalitet " opstår, når en aktivitet, der er tilknyttet flere kontakter i HubSpot, forsøger at synkronisere med Salesforce. Integrationen understøtter kun synkronisering af én kontakt-tilknytning pr. aktivitet.

Sådan løses 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 "Venter på, at kontoen synkroniseres " anbefales det, at du kører en import af Salesforce-konti. 

For at løse fejlen " Uoverensstemmelse i tilknytningskardinalitet " skal du fjerne yderligere kontaktkoblinger, så kun én kontakt forbliver tilknyttet aktiviteten.

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
• Regel for dubletter i Salesforce

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 regel om fjernelse af dubletter i Salesforce. 

Sådan løser du fejlene

For at løse fejlen " E-mailadressen 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 konfigureret 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 vedrørende tilladelser til Salesforce-felter skal du sikre dig, at Salesforce-integrationsbrugeren har læse- og redigeringsrettigheder 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 vedkommendes brugerrettigheder 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 er 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 af de 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 "Uoverensstemmende stat- eller landeværdi " 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 delstats- og land/territorium-udvælgelseslisten 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 egenskabsindstillingen "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å valgmulighederne i Salesforce-feltet, så det stemmer overens med den interne værdi for 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 et valg 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 til 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 overskydende 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 utilgængelig" , når Salesforce-muligheder forsøger at synkronisere med HubSpot, men der mangler en posttype. Hvis du har aktiveret posttyper i Salesforce, men ikke bruger dem, eller har Salesforce-muligheder uden en posttype, anbefales det, at du samarbejder med Salesforce om at deaktivere alle posttyper eller oprette en ny posttype. 

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", "Middel", "Lav" og "Ingen". For "Status" og "Type" skal du opdatere Salesforce-værdierne, så de stemmer nøjagtigt overens med de tilgængelige indstillinger i HubSpot, eller tilføje tilsvarende 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 tilknytningen 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 tilknytning til et Salesforce-referencefelt.

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

• Strengen er 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 ugyldige egenskabsværdier. Disse fejl kræver typisk, at de enkelte berørte poster opdateres for at rette fejlen.

Sådan løser du fejlene

For at løse fejlen " Strengen er for lang " skal du forkorte feltværdien i Salesforce eller HubSpot eller øge tegnbegrænsningen for feltet 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 landevalgsmulighed i dine indstillinger for delstats- og land/territorium-udvælgelseslisten 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 »Restricted unique value« anbefales det, at du tjekker de matchingsregler til deduplikering, du har oprettet i Salesforce. 

For at løse fejlen "Manglende obligatorisk værdi" skal du tilføje en værdi til Salesforce-posten for alle egenskaber , der er markeret som obligatoriske i HubSpot. 

Andet/ukendt

Eksempel på en anden/ukendt fejl

• Der opstod en ukendt Salesforce-duplikatfejl: Der er angivet et duplikat-id.

Hvad fejlen betyder

Denne fejl kan opstå, hvis du opretter en feltmapping, der indeholder et standardfelt for Salesforce-ID, f.eks. Lead-ID eller Kontakt-ID, og mapper det til den tilsvarende egenskab "Salesforce Lead-ID" eller "Salesforce Kontakt-ID" i HubSpot.

Sådan løses fejlen

Disse ID-værdier administreres automatisk af integrationen og bør ikke medtages i brugerdefinerede feltmappinger. Oprettelse af disse mappinger kan forårsage uventet synkroniseringsadfærd, især når synkroniseringsreglen er indstillet til tovejs.

Ved andre ukendte fejl bedes du kontakte HubSpot-support for yderligere hjælp.

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.

Konfigurer 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 på 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å kontakten "Aktivér meddelelser " til. 
6. Vælg radioknappen ved siden afMed det samme,Dagligt ellerUgentligt for at indstille hyppigheden af dine meddelelser. 
7. Klikpå Gem.