Administrer API-anrop og synkroniseringsfeil i Salesforce-integrasjonen

HubSpot-Salesforce-integrasjonen kan støte på synkroniseringsfeil, noe som hindrer data i å synkroniseres. Du kan identifisere og løse disse synkroniseringsfeilene i integrasjonsinnstillingene for Salesforce.

Juster grensen for API-anrop

• I HubSpot-kontoen din klikker du på settings innstillinger-ikonet i den øverste navigasjonslinjen. Gå til Integrasjoner > Tilkoblede apper i menyen i venstre sidefelt.
• I listen over tilkoblede apper klikker du på Salesforce.
• I fanen Synkroniseringshelse, i delen Bruk av API-anrop , kan du se hvor mange API-anrop du har brukt i løpet av de siste 24 timene. Tallet Begrenset av Salesforce er mengden API-anrop du kan foreta basert på Salesforce-innstillingene dine. Hvis du vil justere hvor mange anrop som kan allokeres til HubSpot, redigerer du feltet Allokert til HubSpot.

Se Salesforce-synkroniseringsfeil

• I HubSpot-kontoen din klikker du på settings innstillinger-ikonet i den øverste navigasjonslinjen. Gå til Integrasjoner > Tilkoblede apper i menyen i venstre sidefelt.
• I listen over tilkoblede apper klikker du på Salesforce.
• Under Synkroniseringsfeil på fanen Synkroniseringshelse kan du vise kort for hver feiltype, med antall aktuelle feil og berørte poster. Klikk på et feiltypekort for å se detaljer om feilene i høyre panel. Finn ut mer om hver feiltype og anbefalinger for løsning.

• Hvis du vil se mer informasjon om en feil, klikker du på info info-ikonet i kolonnen for feiltype .
• Hvis du vil gjøre noe med individuelle poster, klikker du på [#] poster i kolonnen Berørte poster, og deretter klikker du på Handlinger > Opprett en midlertidig visning av HubSpot-poster for å opprette en filtrert visning av de berørte postene.
• Når du har løst feilene, går du tilbake til feillisten. Merk av i avmerkingsboksen til venstre for eventuelle løste feil, og klikk på Resynkroniser.
• Hvis du vil eksportere feilene dine, klikker du på Eksporter feil (CSV) øverst til venstre i feillisten.

Feiltyper for Salesforce-synkronisering

Assosiasjoner

Eksempler på assosiasjonsfeil

• Assosiasjonsgrense nådd
• Venter på at kontoen skal synkroniseres

Hva feilene betyr

Oppføringer synkroniseres ikke fordi de er tilknyttet Salesforce-kontoer som ikke er synkronisert med HubSpot-selskaper ennå, eller fordi de er tilknyttet oppføringer som har nådd HubSpots grense for tilknytning av oppføringer.

Slik løser du feilene

For å løse feilen Assosiasjonsgrense nådd kan du enten fjerne noen av de tilknyttede postene eller knytte dem til en annen Salesforce-post, og deretter fortsette med synkroniseringen.

For å løse feilen Venter på at konto skal synkroniseres , anbefales det at du kjører en import av Salesforce-kontoer.

Egendefinert kode

Eksempler på feil i egendefinert kode

• Salesforce-automatisering
• Mangler kontakt-ID
• Regel for validering av egendefinerte felt i Salesforce
• Salesforce-flyt

Hva feilene betyr

Oppføringer synkroniseres ikke på grunn av et problem forårsaket av automatisering, flyter eller valideringsregler i Salesforce-kontoen din.

Slik løser du feilene

Duplikater

Eksempler på duplikatfeil

• E-post allerede i bruk
• Salesforce-duplikatregel

Hva feilene betyr

En Salesforce-kundeemne eller -kontakt kan ikke synkroniseres med HubSpot fordi e-postadressen allerede finnes i en HubSpot-kontaktoppføring eller på grunn av en dedupliseringsregel i Salesforce.

Hvordan løse feilene

For å løse feilen E-post allerede i bruk, fjerner du e-postadressen fra den eksisterende HubSpot-kontakten.

For å løse feilen med dupliserte regler i Salesforce , anbefales det at du sjekker de samsvarende reglene for deduplisering som er konfigurert i Salesforce.

Tillatelser

Eksempler på feil i tillatelser

• Utilstrekkelig tilgang eller manglende Salesforce-post
• Tillatelse til Salesforce-felt
• Utilstrekkelig tilgang til Salesforce

Hva feilene betyr

Endringer som er gjort i HubSpot, kan ikke synkroniseres med Salesforce fordi den tilkoblede brukeren ikke har tilgang til det nødvendige feltet eller objektet i Salesforce.

Hvordan løse feilene

I de fleste tilfeller oppstår feilen Utilstrekkelig tilgang eller manglende Salesforce-post når integrasjonen forsøker å oppdatere et Salesforce-felt med feil verdi eller opprette en feil tilknytning.

For å løse feilen med tillatelse til Salesforce-feltet må du sørge for at brukeren av Salesforce-integrasjonen har lese- og redigeringstillatelser til feltet i Salesforce.

Feilen Utilstrekkelig tilgang til Salesforce oppstår når Salesforce-integrasjonsbrukeren ikke kan utføre handlingen i Salesforce på grunn av brukerrettighetene i Salesforce. Det anbefales at du sjekker brukerrettighetene for Salesforce-integrasjonsbrukeren i Salesforce.

Picklister

Eksempler på picklistefeil

• Manglende Salesforce-picklistealternativ
• Uoverensstemmende verdi for stat eller land
• Ikke samsvarende alternativer
• Inaktiv Salesforce-eier
• Begrenset picklisteverdi
• Inaktivt mulighetsstadium
• Salesforce-eiere ikke synkronisert
• Grensen for opsjoner overskredet
• Standard salgsprosess utilgjengelig
• Mangler eller ugyldig mulighetstrinn

Hva feilene betyr

Oppføringer synkroniseres ikke på grunn av uoverensstemmelse mellom picklist-feltverdier i HubSpot og Salesforce. Dette kan skje når en picklisteverdi i det ene systemet ikke samsvarer med noen gjeldende verdier i det andre, hvis picklisten har nådd en grense for verdier, eller hvis verdien som er sendt inn, ikke er gyldig.

Slik løser du feilene

For å løse feilen Mismatched state or country value anbefales det at du kontrollerer at følgende krav er oppfylt:

• Den interne verdien av Land-egenskapsalternativet i HubSpot må samsvare med et eksisterende Land-alternativ i innstillingene for State og Country/Territory i Salesforce.
• State-verdien må finnes som et alternativ for Tilgjengelig stat/provins for postens Country-verdi i Salesforce. I tillegg må den interne verdien av State-egenskapsalternativet i HubSpot samsvare med et eksisterende State-alternativ i Salesforce.

For å løse feilen Mismatched options anbefales det at du oppdaterer det interne/API-navnet på Salesforce-feltalternativene slik at de samsvarer med den interne verdien på egenskapsalternativene i HubSpot.

For å løse feilen Inaktiv Salesforce-eier, tilordner du HubSpot-posten til en bruker som er en aktiv bruker i Salesforce.

Feilen Restricted picklist value oppstår når du har innstillingen Restrict picklist to the values defined in the value set slått på for feltet i Salesforce. Når dette er slått på i Salesforce, må verdien du prøver å synkronisere fra HubSpot til Salesforce, finnes som et alternativ i Salesforce-picklisten. Det anbefales at du slår av Begrens picklisten til verdiene som er definert i verdisettinnstillingen i Salesforce, slik at alle verdier kan synkroniseres fra HubSpot til Salesforce.

Feilen Inaktivt mulig hetsstadium oppstår når en Salesforce-mulighet med et inaktivt mulighetsstadium forsøker å synkronisere til HubSpot. For å løse denne feilen må du endre mulighetens stadie i Salesforce til aktivt eller flytte muligheten til et aktivt stadie.

For å løse feilen Salesforce-eiere ikke synkronisert, må du sørge for at Salesforce-brukerne har brukertype satt til Standard, Power Partner eller Gjest i Salesforce.

For å løse feilen Option limit exceeded, anbefales det at du sletter ekstra eiendomsalternativer i HubSpot og Salesforce som teamet ditt ikke bruker. I tillegg må du sørge for at alle tilordnede egenskaper har tilsvarende felttyper.

I de fleste tilfeller oppstår feilen Standard salgsprosess utilgjengelig når Salesforce-muligheter forsøker å synkronisere til HubSpot med en manglende Record Type. Hvis du har slått på Record Types i Salesforce, men ikke bruker dem, eller har Salesforce-muligheter uten en Record Type, anbefales det at du samarbeider med Salesforce for å deaktivere alle Record Types eller opprette en ny Record Type.

For å løse feilen Manglende eller ugyldig mulighet strinn, må du sørge for at verdien for Salesforce-mulighetstrinnet finnes i HubSpot-pipelinen.

Tilordninger av egenskaper

Eksempler på feil i egenskapstilordninger

• Type mismatch
• Manglende Salesforce-ID
• Ugyldig Salesforce-ID

Hva feilene betyr

Oppføringer synkroniseres ikke på grunn av en uoverensstemmelse i tilordningen mellom HubSpot-egenskapen og Salesforce-feltet. Dette kan bety at egenskaps- og felttypene ikke er kompatible, at egenskapen eller feltet ikke lenger eksisterer, eller at det må opprettes en Salesforce-referansefelttilordning.

Slik løser du feilene

For å løse Type mismatch-feilen må du sørge for at egenskapstypen i HubSpot og felttypen i Salesforce er kompatible. Finn ut mer om hvilke HubSpot-egenskapsfelttyper som kan synkroniseres med Salesforce.

Feilen Manglende Salesforce-ID oppstår når HubSpot prøver å synkronisere en annen verdi enn en eksisterende Salesforce-ID til et referanse-/oppslagsfelt i Salesforce.

For å løse feilen Ugyldig Salesforce-ID anbefales det at du sjekker den egendefinerte valideringsregelen du har satt opp i Salesforce.

Egenskapsverdier

Eksempler på feil med egenskapsverdier

• Streng for lang
• Ugyldig e-post
• Mangler obligatorisk land
• Ugyldig verdi
• Tildeling av eier
• Begrenset unik verdi
• Mangler obligatorisk verdi

Hva feilene betyr

Oppføringer synkroniseres ikke mellom HubSpot og Salesforce fordi de inneholder egenskapsverdier som ikke er gyldige. Disse feilene krever vanligvis at de enkelte berørte postene oppdateres for å rette feilen.

Slik løser du feilene

For å løse feilen String for lang må du forkorte feltverdien i Salesforce eller HubSpot, eller øke grensen for antall tegn i feltet i Salesforce.

For å løse feilen Ugyldig e-postadresse må du oppdatere formateringen av e-postadressen i Salesforce-oppføringen som forsøker å synkronisere med HubSpot.

For å løse feilen Manglende påkrevd land, anbefales det at du sjekker at følgende krav er oppfylt:

• Den interne verdien for Land-egenskapsalternativet i HubSpot må samsvare med et eksisterende Land-alternativ i innstillingene for State and Country/Territory-picklisten i Salesforce.
• State-verdien må finnes som et alternativ for Tilgjengelig stat/provins for postens Country-verdi i Salesforce. I tillegg må den interne verdien av State-egenskapsalternativet i HubSpot samsvare med et eksisterende State-alternativ i Salesforce.

For å løse feilen Ugyldig verdi anbefales det at du oppdaterer egenskapsverdien på Salesforce-oppføringen slik at den oppfyller HubSpots krav til egenskapsverdien.

I de fleste tilfeller oppstår feilen Owner Assignment når en HubSpot-aktivitet synkroniseres til Salesforce som en Salesforce-oppgave, og HubSpot forsøker å tilordne oppgaven til en Salesforce Queue-eier.

For å løse feilen Begrenset unik verdi anbefales det at du sjekker samsvarsreglene for deduplisering du har konfigurert i Salesforce.

For å løse feilen Manglende påkrevd verdi, legger du til en verdi i Salesforce-oppføringen for alle egenskaper som er merket som påkrevd i HubSpot.

Annet

Oppføringer synkroniseres ikke på grunn av en ukjent feil. Kontakt HubSpot Support for ytterligere hjelp med disse feilene.

Merk: Det er mulig å massesynkronisere 100 Salesforce-feil om gangen. Hvis du vil synkronisere mer enn 100 feil, må du importere postene fra Salesforce eller oppdatere en tilordnet egenskap.

Konfigurer synkroniseringsfeilvarsler

• I HubSpot-kontoen din klikker du på settings innstillinger-ikonet i den øverste navigasjonslinjen. Gå til Integrasjoner > Tilkoblede apper i menyen i venstre sidefelt.
• I listen over tilkoblede apper klikker du på Salesforce.
• Klikk på fanen Synkroniseringshelse.
• Under Synkroniseringsfeil klikker du på Administrer varsler.
• I dialogboksen slår du på Slå på varslinger.
• Velg alternativknappen ved siden av Umiddelbart, Daglig eller Ukentlig for å angi hyppigheten på varslene.
• Klikk på Lagre.