Administrer API-anrop for Salesforce-integrasjon og synkroniseringsfeil

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

Juster grensen for API-anrop

1. I HubSpot-kontoen din klikker du på innstillinger-ikonet i den øverste navigasjonslinjen. Gå til Integrasjoner > Tilkoblede apper i menyen i venstre sidefelt.
2. I listen over tilkoblede apper klikker du påSalesforce. 
3. Gå til fanen Datasynkronisering. 
4. På fanen Synkroniseringsstatus, i delen API-anrop, kan du se hvor mange API-anrop du har brukt de siste 24 timene. TalletBegrenset av Salesforce er antallet API-anrop du kan foreta basert på Salesforce-innstillingene dine. For å justere hvor mange anrop som kan tildeles HubSpot, redigerer du feltet Tildelt til HubSpot. 

Vis Salesforce-synkroniseringsfeil

1. I HubSpot-kontoen din klikker du på innstillinger-ikonet i den øverste navigasjonslinjen. Gå til Integrasjoner > Tilkoblede apper i menyen i venstre sidefelt.
2. I listen over tilkoblede apper klikker du påSalesforce. 
3. Gå til fanen «Datasynkronisering». 
4. På fanen Synkroniseringsstatus, idelenSynkroniseringsfeil , kan du se kort for hver feiltype, med antall aktuelle feil og berørte poster. Klikk på et feiltypekort for å se detaljer om feilene i panelet til høyre. Lær mer om hver feiltype og anbefalinger for løsning. 

5. For å se flere detaljer om en feil, klikk på informasjonsikonet i kolonnen «Feiltype ».
6. For å utføre handlinger på enkeltposter, klikk på [#] poster i kolonnen Berørte poster, og klikk deretter på Handlinger > Opprett en midlertidig visning av HubSpot-poster for å opprette en filtrert visning av de berørte postene. 
7. Når du har løst feilene, går du tilbake til feillisten. Merk av iboksen til venstre for eventuelle løste feil, og klikk på Synkroniser på nytt.
8. For å eksportere feilene dine, klikk på Eksporter feil (CSV) øverst til venstre i feillisten.

Typer av Salesforce-synkroniseringsfeil

Tilknytninger

Eksempler på tilknytningsfeil 

• Tilknytningsgrensen er nådd
• Venter på at kontoen skal synkroniseres

• Uoverensstemmelse i assosiasjonskardinalitet

Hva feilene betyr

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

Feilen «Uoverensstemmelse i tilknytningens kardinalitet » oppstår når en aktivitet som er tilknyttet flere kontakter i HubSpot, forsøker å synkroniseres til Salesforce. Integrasjonen støtter kun synkronisering av én kontakttilknytning per aktivitet.

Slik løser du feilene 

For å løse feilen «Koblingsgrensen er 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 importerer Salesforce -kontoer. 

For å løse feilen «Uoverensstemmelse i tilknytningskardinalitet » må du fjerne ekstra kontaktkoblinger, slik at bare én kontakt forblir tilknyttet aktiviteten.

Tilpasset kode

Eksempler på feil i tilpasset kode 

• Salesforce-automatisering
• Manglende kontakt-ID
• Valideringsregel for tilpasset felt i Salesforce
• Salesforce-flyt

Hva feilene betyr

Postene 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å feil knyttet til duplikater

• E-postadressen er allerede i bruk
• Regel for duplikater i Salesforce

Hva feilene betyr

En Salesforce-lead eller -kontakt kan ikke synkroniseres til HubSpot fordi e-postadressen allerede finnes i en HubSpot-kontaktpost eller på grunn av en regel for fjerning av duplikater i Salesforce. 

Slik løser du feilene

For å løse feilen «E-postadressen er allerede i bruk », må du fjerne e-postadressen fra den eksisterende HubSpot-kontakten.

For å løse feilen knyttet til dupliseringsregelen i Salesforce , anbefales det at en Salesforce-administrator gjennomgår reglene for duplikatfjerning som er konfigurert i Salesforce. Deretter må du slå sammen, oppdatere eller slette eventuelle konfliktfylte Salesforce-poster, eller justere duplikatfjerningsregelen i Salesforce, før du prøver å synkronisere på nytt i HubSpot.

Tillatelser

Eksempler på feil knyttet til tillatelser

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

Hva feilene betyr

Endringer gjort i HubSpot kan ikke synkroniseres til Salesforce fordi den tilknyttede 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 prøver å oppdatere et Salesforce-felt med en feil verdi eller opprette en feil tilknytning. 

For å løse feilen knyttet til Salesforce-feltrettigheter må du sørge for at Salesforce-integrasjonsbrukeren har lese- og redigeringsrettigheter 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 sine i Salesforce. Det anbefales at du sjekker Salesforce-integrasjonsbrukerens rettigheter i Salesforce.

Valglister

Eksempler på feil i utvalgslister

• Manglende valg i Salesforce-utvalgslisten
• Uoverensstemmende verdi for delstat eller land
• Alternativene stemmer ikke overens
• Inaktiv Salesforce-eier
• Begrenset utvalgsverdi
• Inaktivt salgsmulighetsstadium
• Salesforce-eiere er ikke synkronisert
• Alternativgrensen overskredet
• Standard salgsprosess utilgjengelig
• Manglende eller ugyldig salgsmulighetsfase

Hva feilene betyr

Postene synkroniseres ikke på grunn av en avvik mellom verdiene i utvalgslistefeltene i HubSpot og Salesforce. Dette kan skje når en verdi i utvalgslisten i det ene systemet ikke samsvarer med noen av de gjeldende verdiene i det andre, hvis utvalgslisten har nådd en grense for antall verdier, eller hvis verdien som sendes ikke er gyldig.

Slik løser du feilene

For å løse feilen«Uoverensstemmende verdi for delstat eller land » anbefales det at du sjekker at følgende krav er oppfylt:

• Den interne verdien for alternativet «Land » i HubSpot må samsvare med et eksisterende «Land»- alternativ i innstillingene for utvalgslisten «Delstat og land/territorium» i Salesforce. 
• Verdien for «State» må eksistere som et tilgjengelig alternativfor «State/Province»for postens «Country»-verdi i Salesforce. I tillegg må den interne verdien for egenskapsalternativet «State» i HubSpot samsvare med et eksisterende «State»- alternativ i Salesforce. 

For å løse feilen «Uoverensstemmende alternativer » anbefales det at du oppdaterer det interne navnet/API-navnet på alternativene i Salesforce-feltet, slik at det samsvarer med den interne verdien for egenskapsalternativene i HubSpot. 

For å løse feilen «Inaktiv Salesforce-eier » må du tilordne HubSpot-posten til en bruker som er aktiv i Salesforce. 

Feilen «Begrenset utvalgslisteverdi» oppstårnår innstillingen «Begrens utvalgslisten til verdiene definert i verdisettet» er aktivert for feltet i Salesforce. Når denne er aktivert i Salesforce, må verdien du prøver å synkronisere fra HubSpot til Salesforce, finnes som et alternativ i utvalgslisten i Salesforce. Det anbefales at du deaktiverer innstillingen «Begrens utvalgslisten til verdiene som er definert i verdisettet» i Salesforce, slik at alle verdier kan synkroniseres fra HubSpot til Salesforce. 

Feilen «Inaktivt salgsmulighetsstadium» oppstår når en salgsmulighet i Salesforce med et inaktivt salgsmulighetsstadium forsøker å synkroniseres til HubSpot. For å løse denne feilen må du endre salgsmulighetsstadiet i Salesforce til «aktivt»eller flytte salgsmuligheten til et aktivt stadium. 

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

For å løse feilen «Alternativgrensen overskredet» anbefales det at du sletter ekstra egenskapsalternativer 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 å synkroniseres med HubSpot uten en rekordtype. Hvis du har aktivert rekordtyper i Salesforce, men ikke bruker dem, eller har Salesforce-muligheter uten rekordtype, anbefales det at du samarbeider med Salesforce for å deaktivere alle rekordtyper eller opprette en ny rekordtype. 

For å løse feilen «Manglende eller ugyldig salgsmulighetsfase», må du sørge for at verdien for salgsmulighetsfasen i Salesforce finnes i HubSpot-pipeline.

For feil i Salesforce-oppgavefeltene må du sammenligne verdiene for «Oppgaveprioritet», «Status» eller «Type» i Salesforce med de tilsvarende alternativene for oppgaveegenskaper i HubSpot. «Oppgaveprioritet» støtter kun «Høy», «Middels», «Lav» og «Ingen». For «Status» og «Type» må du oppdatere Salesforce-verdiene slik at de samsvarer nøyaktig med de tilgjengelige alternativene i HubSpot, eller legge til tilsvarende alternativer i HubSpot.

Egenskapstilordninger

Eksempler på feil i egenskapstilordninger 

• Typeavvik
• Manglende Salesforce-ID
• Ugyldig Salesforce-ID

Hva feilene betyr

Postene synkroniseres ikke på grunn av en avvik i tilordningen mellom HubSpot-egenskapen og Salesforce-feltet. Dette kan bety at egenskaps- og felttypene ikke er kompatible, at egenskapen eller feltet ikke lenger finnes, eller at det må opprettes en tilordning for et Salesforce-referansefelt.

Slik løser du feilene 

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

Feilen «Manglende Salesforce-ID » oppstår når HubSpot har forsøkt å synkronisere en verdi som ikke er en eksisterende Salesforce-ID, til et referanse-/oppslagsfelt i Salesforce. 

For å løse feilen «Ugyldig Salesforce-ID » anbefales det at du sjekker den tilpassede valideringsregelen du har konfigurert i Salesforce. 

Egenskapsverdier

Eksempler på feil i egenskapsverdier

• Strengen er for lang
• Ugyldig e-post
• Manglende obligatorisk land
• Ugyldig verdi
• Tildeling av eier
• Begrenset unik verdi
• Manglende obligatorisk verdi

Hva feilene betyr

Postene synkroniseres ikke mellom HubSpot og Salesforce fordi de inneholder ugyldige egenskapsverdier. Disse feilene krever vanligvis at de enkelte berørte postene oppdateres for å rette feilen.

Slik løser du feilene

For å løse feilen «Strengen er for lang », må du forkorte feltverdien i Salesforce eller HubSpot, eller øke tegnbegrensningen for feltet i Salesforce. 

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

For å løse feilen «Manglende obligatorisk land » anbefales det at du sjekker at følgende krav er oppfylt:

• Den interne verdien for egenskapsalternativet «Land» i HubSpot må samsvare med et eksisterende «Land»- alternativ i innstillingene for utvalgslisten «Delstat og land/territorium» i Salesforce. 
• Verdien for «State» må finnes som et tilgjengelig alternativfor «State/Province»for postens «Country»-verdi i Salesforce. I tillegg må den interne verdien for egenskapsalternativet «State» i HubSpot samsvare med et eksisterende «State»-alternativ i Salesforce. 

For å løse feilen «Ugyldig verdi » anbefales det at du oppdaterer egenskapsverdien i Salesforce-posten slik at den oppfyller HubSpots krav til egenskapsverdien. 

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

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

For å løse feilen «Manglende obligatorisk verdi» må du legge til en verdi i Salesforce-posten for alle egenskaper som er merket som obligatoriske i HubSpot. 

Annet/ukjent

Eksempel på en «Annet/ukjent»-feil

• Det oppstod en ukjent Salesforce-duplikatfeil: Duplikat-ID angitt.

Hva feilen betyr

Denne feilen kan oppstå hvis du oppretter en feltkartlegging som inkluderer et standard Salesforce-ID-felt, for eksempel Lead-ID eller Kontakt-ID, og kartlegger det til den tilsvarende egenskapen Salesforce Lead-ID eller Salesforce Kontakt-ID i HubSpot.

Slik løser du feilen

Disse ID-verdiene administreres automatisk av integrasjonen og bør ikke inkluderes i tilpassede feltkartlegginger. Opprettelse av slike kartlegginger kan føre til uventet synkroniseringsatferd, spesielt når synkroniseringsregelen er satt til toveis.

For andre ukjente feil, vennligst kontakt HubSpot-kundestøtte for videre hjelp.

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

Konfigurer varsler om synkroniseringsfeil

1. I HubSpot-kontoen din klikker du på innstillinger-ikonet i den øverste navigasjonslinjen. Gå til Integrasjoner > Tilkoblede apper i menyen i venstre sidefelt.
2. Klikk på«Salesforce» i listen over tilkoblede apper. 
3. Gå til fanen Datasynkronisering. 
4. På fanen Synkroniseringsstatus, i delen Synkroniseringsfeil , klikker du påAdministrer varsler. 
5. I dialogboksen slår du på bryteren«Slå på varsler ». 
6. Velg alternativknappen ved siden avUmiddelbart,Daglig ellerUkentlig for å angi hyppigheten på varslingene dine. 
7. Klikk påLagre.