Administrer API-anmodninger til Salesforce-integration og synkroniseringsfejl

Integrationen mellem HubSpot og Salesforce kan støde på synkroniseringsfejl, som forhindrer data i at blive synkroniseret. Du kan identificere og løse disse synkroniseringsfejl i indstillingerne for din Salesforce-integration.

Juster grænsen for API-anmodning

• 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 kontaktede apps.
• På fanen Synkroniseringstilstand i afsnittet Brug af API-anmodning kan du se, hvor mange API-anmodninger du har brugt i de sidste 24 timer. Tallet Begrænset af Salesforce er den værdi af API-anmodninger, 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 fejl i Salesforce-synkronisering

• 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 kontaktede apps.
• På fanen Synkroniseringstilstand, under Synkroniseringsfejl, kan du se kort for hver fejltype med antallet af aktuelle fejl og påvirkede registre. 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.

• Hvis du vil se flere detaljer om en fejl, skal du klikke på info info-ikonet i kolonnen Fejltype .
• Hvis du vil gøre noget ved individuelle registre, skal du klikke på [#] registre i kolonnen Berørte registre og derefter klikke på Handlinger > Opret en midlertidig visning af HubSpot-registre for at oprette en filtreret visning af de berørte registre.
• Når du har løst fejlene, skal du gå tilbage til listen over fejl. 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å listen over fejl.

Fejltyper i Salesforce-synkronisering

Tilknytninger

Eksempler på fejl i tilknytninger

• Grænse for Tilknytning nået
• Venter på, at konto synkroniseres

Hvad fejlene betyder

Registre synkroniseres ikke, fordi de er tilknyttet Salesforce-konti, der endnu ikke er synkroniseret med HubSpot Virksomheder, eller fordi de er tilknyttet registre, der har nået HubSpots grænse for registertilknytning.

Sådan løser du fejlene

For at løse fejlen Tilknytning nået grænse kan du enten fjerne nogle af de tilknyttede poster eller tilknytte dem til et andet Salesforce-register 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.

Kundekode

Eksempler på fejl i kundekode

• Automatisering af Salesforce
• Manglende ID for kontakt
• Regel for validering af brugerdefinerede felter i Salesforce
• Salesforce-flow

Hvad fejlene betyder

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

Sådan løser du fejlene

Duplikater

Eksempler på duplikatfejl

• E-mail allerede i brug
• Salesforce-regel for duplikat

Hvad fejlene betyder

Et lead eller en kontakt i Salesforce kan ikke synkroniseres med HubSpot, fordi e-mail-adressen allerede findes i et HubSpot-kontaktregister eller på grund af en regel om deduplikering i Salesforce.

Sådan løser du fejlene

For at løse fejlen E-mail allerede i brug skal du fjerne e-mail-adressen fra den eksisterende HubSpot-kontakt.

For at løse Salesforce-duplikatregelfejlen anbefales det, at du kontrollerer de matchende regler for deduplikering, der er sat op i Salesforce.

Tilladelser

Eksempler på fejl i tilladelser

• Utilstrækkelig adgang eller manglende Salesforce-register
• Tilladelse til Salesforce-felt
• Utilstrækkelig adgang til Salesforce

Hvad fejlene betyder

Ændringer foretaget i HubSpot kan ikke synkroniseres med Salesforce, fordi den kontaktede bruger ikke har adgang til det nødvendige felt eller objekt i Salesforce.

Sådan løser du 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 registertilknytning .

For at løse fejlen med tilladelser til Salesforce-feltet skal du sikre dig, at brugeren af Salesforce-integrationen har læse- og redigeringstilladelser til feltet i Salesforce.

Fejlen Utilstrækkelig Salesforce-adgang opstår, når brugeren af Salesforce-integrationen ikke kan udføre handlingen i Salesforce på grund af deres brugertilladelser i Salesforce. Det anbefales, at du kontrollerer Salesforce integrationens brugertilladelser 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 stadie for mulighed
• Salesforce-ejere er ikke synkroniseret
• Grænse for valgmuligheder overskredet
• Standard salgsproces ikke tilgængelig
• Manglende eller ugyldig fase for Mulighed

Hvad fejlene betyder

Registre 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 egenskaben Land i HubSpot skal matche en eksisterende Land-mulighed i dine indstillinger for State og Country/Territory picklist i Salesforce.
• State-værdien skal eksistere som en Available State/Province-mulighed for registerets Country-værdi i Salesforce. Derudover skal den interne værdi af egenskaben Stat i HubSpot matche en eksisterende Stat 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 egenskaberne i HubSpot.

For at løse fejlen med den inaktive Salesforce-ejer skal du tildele HubSpot-registret til en bruger, der er aktiv 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 en inaktiv 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 med Salesforce-ejere, der ikke er 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 egenskaber i HubSpot og Salesforce, som dit team ikke bruger. Sørg desuden for, at alle egenskabstilknytninger har tilsvarende felttilknytninger.

I de fleste tilfælde opstår fejlen Default sales process unavailable , når Muligheder i Salesforce forsøger at synkronisere til HubSpot med et manglende Register. Hvis du har aktiveret registertyper i Salesforce, men ikke bruger dem, eller hvis du har Salesforce-muligheder uden en registertype, anbefales det, at du samarbejder med Salesforce om at deaktivere alle registertyper eller oprette en ny registertype.

For at løse fejlen Manglende eller ugyldig mulighed strin skal du sikre dig, at Salesforce-mulighedstrinværdien findes i HubSpot-pipelinen.

Egenskabstilknytninger

Eksempler på fejl i egenskabstilknytninger

• Uoverensstemmelse mellem typer
• Manglende Salesforce-ID
• Ugyldigt Salesforce-ID

Hvad fejlene betyder

Registre synkroniseres ikke på grund af en uoverensstemmelse i tilknytningen 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-referencefelttilknytning.

Sådan løser du 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 egenskabsfelttyper i HubSpot, der kan synkroniseres med Salesforce.

Fejlen Missing 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 Invalid Salesforce ID anbefales det, at du tjekker den brugerdefinerede valideringsregel, som du har sat op i Salesforce.

Egenskabernes værdi

Eksempler på fejl i egenskaberne

• 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

Registre synkroniseres ikke mellem HubSpot og Salesforce, fordi de indeholder værdier for egenskaber, der ikke er gyldige. Disse fejl kræver typisk, at de enkelte berørte registre opdateres for at rette fejlen.

Sådan løser du 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 med ugyldig e-mail skal du opdatere formateringen af e-mail-adressen i det Salesforce-register, der forsøger at synkronisere med 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 egenskaben Land i HubSpot skal matche en eksisterende Land-mulighed i dine indstillinger for State og Country/Territory picklist i Salesforce.
• State-værdien skal eksistere som en Available State/Province-mulighed for registerets Country-værdi i Salesforce. Desuden skal den interne værdi af egenskaben Stat i HubSpot matche en eksisterende stat i Salesforce.

For at løse fejlen med ugyldig værdi anbefales det, at du opdaterer værdien af egenskaben i Salesforce-registret, så den opfylder HubSpots krav til værdien af egenskaben.

I de fleste tilfælde opstår fejlen Owner Assignment , når en HubSpot-aktivitet synkroniseres med 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-registret for enhver egenskab, der er markeret som påkrævet i HubSpot.

Andet

Registrene synkroniseres ikke på grund af en ukendt fejl. Kontakt HubSpot-support for yderligere hjælp med 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 registrene fra Salesforce eller opdatere en egenskabstilknytning.

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 kontaktede apps.
• Klik på fanen Synkroniseringstilstand.
• Klik på Administrer meddelelser under Synkroniseringsfejl.
• I dialogboksen skal du slå kontakten Turn on notifications til.
• Vælg radioknappen ved siden af Instantly, Daily eller Weekly for at indstille hyppigheden af dine notifikationer.
• Klik på Gem.