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

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-kald

1. 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.
2. Klik på Salesforce i listen over tilknyttede apps.
3. Gå til fanen Synkroniseringsstatus.
4. I afsnittet Brug af API-kald kan du se, hvor mange API-kald du har brugt i løbet af de sidste 24 timer. Antallet Begræ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 HubSpot, skal du redigere feltet Tildelt til HubSpot.

Se Salesforce-synkroniseringsfejl

1. 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.
2. Klik på Salesforce i listen over tilknyttede apps.
3. Gå til fanen Synkroniseringsstatus.
4. Under Synkroniseringsfejl kan du se kort for hver fejltype med antallet af aktuelle fejl og berørte 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.

5. For at se flere detaljer om en fejl skal du klikke på informationsikonet " info " i kolonnen "Error Type" (Fejltype).
6. For at udføre handlinger på individuelle poster skal du klikke på [#] poster i kolonnen Affected Records (Berør te poster) og derefter klikke på Actions (Handlinger) > Create a temporary view of HubSpot records (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. Marker afkrydsningsfeltet til venstre for alle løste fejl, og klik på Resync.
8. For at eksportere dine fejl skal du klikke på Eksporter fejl (CSV) ø verst til venstre på fejllisten.

Typer af Salesforce-synkroniseringsfejl

Forbindelser

Eksempler på tilknytningsfejl

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

Hvad fejlene betyder

Posterne 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 tilknytning af poster.

Sådan løses fejlene

For at løse fejlen "Associationsgrænse nået " kan du enten fjerne nogle af de associerede poster eller associere dem med 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
• Salesforce-valideringsregel for brugerdefineret felt
• 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å duplikatfejl

• E-mail 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-mail allerede i brug " skal du fjerne e-mailadressen fra den eksisterende HubSpot-kontakt.

For at løse fejlen "Salesforce-duplikatregel" anbefales det, at du kontrollerer de matchende regler for deduplikering, der er konfigureret i Salesforce.

Tilladelser

Eksempler på tilladelsesfejl

• Utilstrækkelig adgang eller manglende Salesforce-post
• Salesforce-felt tilladelse
• 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 deres brugerrettigheder i Salesforce. Det anbefales, at du kontrollerer Salesforce-integrationsbrugerrettighederne i Salesforce.

Valglister

Eksempler på fejl i picklister

• Manglende Salesforce-valgmulighed
• Uoverensstemmende værdi for stat eller land
• Uoverensstemmende valgmuligheder
• Inaktiv Salesforce-ejer
• Begrænset værdi i picklist
• Inaktiv salgsmulighedsfase
• Salesforce-ejere ikke synkroniseret
• Indstillingsgræ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 picklist-felterne i HubSpot og Salesforce. Dette kan ske, når en værdi i picklisten i det ene system ikke matcher nogen af de aktuelle værdier i det andet, hvis picklisten har nået en værdigrænse, 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 af landegenskabsind stillingen i HubSpot skal matche en eksisterende landegenskab i dine indstillinger for delstater og lande/territorier i Salesforce.
• Værdien for stat skal findes som en tilgængelig stat/provins-mulighed for postens land- værdi i Salesforce. Derudover skal den interne værdi for egenskaben Stat i HubSpot matche en eksisterende stat- mulighed i Salesforce.

For at løse fejlen "Uoverensstemmende valgmuligheder " anbefales det, at du opdaterer det interne/API-navn på Salesforce-feltvalgmulighederne, 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 picklist-værdi" opstår , når du har aktiveret indstillingen "Begræns picklist til de værdier, der er defineret i værdisættet" 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-picklisten. Det anbefales, at du deaktiverer indstillingen "Begræns pickliste til de værdier, der er defineret i værdisættet" i Salesforce, så alle værdier kan synkroniseres fra HubSpot til Salesforce.

Fejlen " Inaktiv salgsmulighedsfase" opstår , når en salgsmulighed i Salesforce med en inaktiv salgsmulighedsfase forsøger at synkronisere med HubSpot. For at løse denne fejl skal du ændre salgsmulighedsfasen i Salesforce til aktiv eller flytte salgsmuligheden til en aktiv fase.

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

For at løse fejlen "Optionsgrænse overskredet " anbefales det, at du sletter ekstra egenskabsindstillinger 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 Standard salgsproces utilgæ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.

Egenskabskortlægninger

Eksempler på fejl i egenskabskortlægning

• Type uoverensstemmelse
• 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-referencemappning.

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-egenskabsfeltetyper, der kan synkroniseres med Salesforce.

Fejlen Manglende Salesforce-id opstår, når HubSpot forsøgte at synkronisere en anden værdi end et eksisterende Salesforce-id til et reference-/opslagsfelt i Salesforce.

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

Egenskabsværdier

Eksempler på fejl i egenskabsværdier

• Strengen er for lang
• Ugyldig e-mail
• Mangler påkrævet land
• Ugyldig værdi
• Ejertildeling
• Begrænset unik værdi
• Mangler påkrævet 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 tegnbegrænsningen for feltet i Salesforce.

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

For at løse fejlen Manglende påkrævet 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 mulighed i dine indstillinger for delstater og lande/territorier i Salesforce.
• Værdien for delstat skal findes som en tilgængelig delstat/provins-indstilling for postens land- værdi i Salesforce. Derudover skal den interne værdi for egenskaben Delstat i HubSpot matche en eksisterende delstat-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 "Ejertildeling" , når en HubSpot-aktivitet synkroniseres med Salesforce som en Salesforce-opgave, og HubSpot forsøger at tildele opgaven til en Salesforce-køejer.

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 enhver egenskab , der er markeret som påkrævet i HubSpot.

Andet

Poster synkroniseres ikke på grund af en ukendt fejl. Kontakt HubSpot Support for at få 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 kortlagt egenskab.

Konfigurer meddelelser om synkroniseringsfejl

1. 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.
2. Klik på Salesforce i listen over tilknyttede apps.
3. Gå til fanen Synkroniseringsstatus.
4. Klik på Administrer meddelelser under Synkroniseringsfejl.
5. I dialogboksen skal du aktivere kontakten Aktiver meddelelser.
6. Vælg radioknappen ved siden af Øjeblikkeligt, Dagligt eller Ugentligt for at indstille hyppigheden af dine meddelelser.
7. Klik på Gem.