Administrer API-anrop og synkroniseringsfeil i Salesforce-integrasjonen

Integrasjonen mellom HubSpot og Salesforce kan oppleve synkroniseringsfeil som hindrer dataene i å synkroniseres. Du kan identifisere og løse disse synkroniseringsfeilene i innstillingene for Salesforce-integrasjonen.

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. Naviger 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 antall 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. Naviger 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

Koblinger

Eksempler på tilknytningsfeil 

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

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 posttilknytning. 

Slik løser du feilene 

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

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 med duplikater

• E-postadresse allerede i bruk
• Salesforce-regel for duplikater

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 dedupliseringsregel i Salesforce. 

Slik løser du feilene

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

For å løse feilen «Salesforce-duplikatregel » anbefales det at en Salesforce-administrator gjennomgår reglene for deduplisering som er konfigurert i Salesforce. Deretter må du slå sammen, oppdatere eller slette eventuelle konfliktfylte Salesforce-poster, eller justere dedupliseringsregelen 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
• Salesforce-feltrettighet
• 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 med Salesforce-feltrettigheter må du sørge for at Salesforce-integrasjonsbrukeren har lese- og redigeringsrettigheter til feltet i Salesforce. 

Feilen «Utilstrekkelig Salesforce-tilgang » 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
• Uoverensstemmende alternativer
• Inaktiv Salesforce-eier
• Begrenset utvalgsverdi
• Inaktivt salgsmulighetsstadium
• Salesforce-eiere 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 utvalgsfeltet i HubSpot og Salesforce. Dette kan skje når en verdi i utvalgsfeltet i det ene systemet ikke samsvarer med noen av de gjeldende verdiene i det andre, hvis utvalgsfeltet 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«Mismatched state or country value » anbefales det at du sjekker at følgende krav er oppfylt:

• Den interne verdien av alternativet for egenskapen Land i HubSpot må samsvare med et eksisterende alternativ for Land i innstillingene for utvalgslisten for 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å Salesforce-feltalternativene slik at de samsvarer med den interne verdien av 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 utvalgsverdi» oppstårnår du har slått på innstillingen «Begrens utvalget til verdiene definert i verdisettet» for feltet i Salesforce. Når dette er slått på i Salesforce, må verdien du prøver å synkronisere fra HubSpot til Salesforce, eksistere som et alternativ i Salesforce-utvalget. Det anbefales at du slår av innstillingen «Begrens utvalgslisten til verdiene som er definert i verdisettet» i Salesforce, slik at alle verdier kan synkroniseres fra HubSpot til Salesforce. 

Feilen «Inaktiv salgsmulighetsfase» oppstår når en Salesforce-salgsmulighet med en inaktiv salgsmulighetsfase forsøker å synkroniseres til HubSpot. For å løse denne feilen må du endre salgsmulighetsfasen i Salesforce til aktiveller flytte salgsmuligheten til en aktiv fase. 

For å løse feilen «Salesforce-eiere 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 å synkronisere med HubSpot med en manglende posttype. Hvis du har aktivert 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 salgsmulighetsfase», må du sørge for at verdien for salgsmulighetsfasen i Salesforce finnes i HubSpot-pipeline.

For feil i Salesforce-oppgavefeltet, sammenlign verdiene for oppgaveprioritet, status eller type i Salesforce med de tilsvarende oppgaveegenskapsalternativene i HubSpot. Oppgaveprioritet støtter kun Høy, Middels, Lav og Ingen. For Status og Type, oppdater Salesforce-verdiene slik at de samsvarer nøyaktig med de tilgjengelige alternativene i HubSpot, eller legg til samsvarende alternativer i HubSpot.

Egenskapstilordninger

Eksempler på feil i egenskapstilordninger 

• Typefeil
• 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 eksisterer, 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 prøvde å 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 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
• Eiertildeling
• Begrenset unik verdi
• Manglende obligatorisk 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

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 landalternativ i innstillingene for utvalgslisten for 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 «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 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

Oppføringene synkroniseres ikke på grunn av en ukjent feil. Kontakt HubSpot-kundestøtte for å få hjelp med disse feilene.

Merk: Det er mulig å synkronisere 100 Salesforce-feil om gangen. For å synkronisere mer enn 100 feil, importer postene fra Salesforce eller oppdater 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. I listen over tilkoblede apper klikker du påSalesforce. 
3. Gå til fanen Datasynkronisering. 
4. På fanen Synkroniseringsstatus, i delen Synkroniseringsfeil , klikker du påAdministrer varsler. 
5. I dialogboksen slår du på bryterenSlå på varsler. 
6. Velg alternativknappen ved siden avUmiddelbart,Daglig ellerUkentlig for å angi hyppigheten på varslingene dine. 
7. Klikk påLagre.