Administrer API-kall for Salesforce-integrasjon og synkroniseringsfeil

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

Juster API-kallgrense

• I HubSpot-kontoen din klikker du på settings innstillinger-ikonet i den øverste navigasjonslinjen. Gå til Integrasjoner > Tilkoblede apper i menyen i venstre sidefelt.
• Klikk på Salesforce i listen over tilkoblede apper. 
• Se hvor mange API-kall du har brukt de siste 24 timene i delen Bruk av API-kall på fanen Synkroniser helsetilstand. Begrenset av Salesforce-nummeret er antall 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. 

Vis 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.
• Klikk på Salesforce i listen over tilkoblede apper. 
• Vis kort for hver feiltype under Synkroniseringsfeil i kategorien Synkroniseringstilstand, med antall gjeldende feil og påvirkede poster. Klikk på et feiltypekort for å se detaljer om feilene i det høyre panelet. Finn ut mer om hver feiltype og løsningsanbefalinger. 

• Hvis du vil se mer info om en feil, klikker du på info-ikonet i kolonnen Feiltype .
• Hvis du vil utføre handlinger på 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å Synkroniser på nytt.
• Hvis du vil eksportere feilene dine, klikker du på Eksporter feil (CSV) øverst til venstre i feillisten.

Feiltyper for Salesforce-synkronisering

Foreninger

Eksempler på assosiasjonsfeil 

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

Hva feilene betyr

Poster synkroniseres ikke fordi de er knyttet til Salesforce-kontoer som ikke er synkronisert med HubSpot-selskaper ennå, eller fordi de er knyttet til poster som har nådd HubSpots grense for posttilknytning. 

Slik løser du feilene 

For å løse feilen Tilknytningsgrense 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 kontoen skal synkroniseres, anbefales det at du kjører en import av Salesforce-kontoer. 

Tilpasset kode

Eksempler på egendefinerte kodefeil 

• Salesforce-automatisering
• Mangler kontakt-ID
• Salesforce valideringsregel for egendefinert felt
• Salesforce flyt

Hva feilene betyr

Poster synkroniseres ikke på grunn av et problem forårsaket av automatisering, flyt eller valideringsregler i Salesforce-kontoen din.

Slik løser du feilene

Duplikater

Eksempler på duplikatfeil

• Epost er allerede i bruk
• Salesforce duplikatregel

Hva feilene betyr

En Salesforce-lead eller kontakt kan ikke synkroniseres med HubSpot fordi e-postadressen allerede finnes i en HubSpot-kontaktpost eller på grunn av en dedupliseringsregel i Salesforce. 

Slik løser du feilene

Hvis du vil løse feilen med e-postadressen som allerede er i bruk, fjerner du e-postadressen fra den eksisterende HubSpot-kontakten.

For å løse Salesforce duplikatregelfeilen, anbefales det at du sjekker matchende regler for deduplisering konfigurert i Salesforce. 

Tillatelser

Eksempler på tillatelsesfeil

• Utilstrekkelig tilgang eller manglende Salesforce-post
• Salesforce felttillatelse
• Utilstrekkelig Salesforce-tilgang

Hva feilene betyr

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

Slik løser du feilene

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

Hvis du vil løse Salesforce-feltrettighetsfeilen, må du kontrollere at Salesforce-integrasjonsbrukeren har lese- og redigeringstillatelser til feltet i Salesforce. 

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

Picklister

Eksempler på plukkelistefeil

• Manglende Salesforce-valglistealternativ
• Uoverensstemmende delstats- eller landverdi
• Alternativer som ikke stemmer overens
• Inaktiv Salesforce-eier
• Begrenset plukkelisteverdi
• Inaktiv mulighetsfase
• Salesforce-eiere ikke synkronisert
• Opsjonsgrense overskredet
• Standard salgsprosess utilgjengelig
• Manglende eller ugyldig mulighetsfase

Hva feilene betyr

Postene synkroniseres ikke på grunn av en uoverensstemmelse mellom plukklistefeltverdier i HubSpot og Salesforce. Dette kan skje når en pluklisteverdi i ett system ikke samsvarer med noen gjeldende verdier i det andre, hvis pluklisten har nådd en grense for verdier, eller hvis verdien som er passert ikke er gyldig.

Slik løser du feilene

Det anbefales at du kontrollerer at følgende krav er oppfylt for å løse feilen i tilstanden eller landverdien som ikke samsvarer:

• Den interne verdien for landegenskapsalternativet i HubSpot må samsvare med et eksisterende landealternativ i innstillingene for stat og land/område i Salesforce. 
• Tilstandsverdien må eksistere som et Tilgjengelig tilstand/provins-alternativ for postens landverdi i Salesforce. I tillegg må den interne verdien av tilstandsegenskapsalternativet i HubSpot samsvare med et eksisterende tilstandsalternativ i Salesforce. 

For å løse feilen med uoverensstemmende alternativer, anbefales det at du oppdaterer det interne/API-navnet til Salesforce-feltalternativene slik at det samsvarer med den interne verdien til egenskapsalternativene i HubSpot. 

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

Feilen Begrenset plukkelisteverdi oppstår når du har Begrens plukkeliste til verdiene som er definert i verdisettinnstillingen aktivert for feltet i Salesforce. Når dette er aktivert i Salesforce, må verdien du prøver å synkronisere fra HubSpot til Salesforce, eksistere som et alternativ i Salesforce-valglisten. Det anbefales at du slår av Begrens plukkelisten til verdiene som er definert i verdisettinnstillingen i Salesforce, slik at alle verdier kan synkroniseres fra HubSpot til Salesforce. 

Feilen Inaktiv mulighetsfase oppstår når en Salesforce-mulighet med en inaktiv mulighetsfase forsøker å synkronisere til HubSpot. Hvis du vil løse denne feilen, endrer du mulighetsfasen i Salesforce til aktiv eller flytter muligheten til en aktiv fase. 

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

For å løse problemet med at opsjonsgrensen er overskredet, anbefales det at du sletter ekstra egenskapsalternativer i HubSpot og Salesforce som teamet ditt ikke bruker. Sørg i tillegg 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 posttype. Hvis du har slått på Posttyper i Salesforce, men ikke bruker dem, eller har Salesforce-muligheter uten en Posttype, anbefales det at du samarbeider med Salesforce for å deaktivere alle Posttyper eller opprette en ny Posttype. 

For å løse feilen Manglende eller ugyldig mulighetstrinn må du sørge for at Salesforce-mulighetstrinnverdien finnes i HubSpot-pipelinen. 

Egenskapstilordninger

Eksempler på egenskapstilordningsfeil 

• Type uoverensstemmelse
• Mangler Salesforce-ID
• Ugyldig Salesforce-ID

Hva feilene betyr

Postene 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 en Salesforce-referansefelttilordning må opprettes.

Slik løser du feilene 

Hvis du vil løse feilen Type-mismatch, må du kontrollere at egenskapstypen i HubSpot og felttypen i Salesforce er kompatible. Finn ut mer om HubSpot-egenskapsfelttypene som kan synkroniseres med Salesforce. 

Feilen Manglende Salesforce-ID oppstår når HubSpot forsøkte å 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 konfigurert i Salesforce. 

Egenskapsverdier

Eksempler på feil i egenskapsverdier

• Strengen er for lang
• Ugyldig epost
• Mangler påkrevd land
• Ugyldig verdi
• Eiertildeling
• Begrenset unik verdi
• Mangler påkrevd verdi

Hva feilene betyr

Postene 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

Hvis du vil løse feilen String too long, forkorter du feltverdien i Salesforce eller HubSpot, eller øker tegngrensen for feltet i Salesforce. 

Hvis du vil løse feilen Ugyldig e-post, oppdaterer du e-postadresseformateringen i Salesforce-posten som forsøker å synkronisere med HubSpot.

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

• Den interne verdien for landegenskapsalternativet i HubSpot må samsvare med et eksisterende landealternativ i innstillingene for stat og land/område i Salesforce. 
• Tilstandsverdien må eksistere som et Tilgjengelig tilstand/provins-alternativ for postens landverdi i Salesforce. I tillegg må den interne verdien av tilstandsegenskapsalternativet i HubSpot samsvare med et eksisterende tilstandsalternativ i Salesforce. 

For å løse feilen Ugyldig verdi anbefales det at du oppdaterer egenskapsverdien i Salesforce-posten for å oppfylle HubSpots krav til egenskapsverdien. 

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

For å løse feilen Begrenset unik verdi, anbefales det at du sjekker matchende regler for deduplisering du konfigurerer i Salesforce. 

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

Annet

Postene synkroniseres ikke på grunn av en ukjent feil. Kontakt HubSpot-støtte for ytterligere hjelp med disse feilene.

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

Konfigurer varsler om 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.
• Klikk på Salesforce i listen over tilkoblede apper. 
• Klikk på fanen Synkroniser helsetilstand. 
• Klikk på Administrer varsler under Synkroniseringsfeil. 
• I dialogboksen slår du på Slå på varslinger. 
• Velg alternativknappen ved siden av Øyeblikkelig, Daglig eller Ukentlig for å angi frekvensen på varslingene dine. 
• Klikk på Lagre.