Administrer API-anrop og synkroniseringsfeil i Salesforce-integrasjonen

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

Juster grensen for API-anrop

1. I HubSpot-kontoen din klikker du på settings 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 Synkroniseringsstatus.
4. I delen Bruk av API-kall kan du se hvor mange API-kall du har brukt de siste 24 timene. Tallet Begrenset av Salesforce er antall API-kall du kan foreta basert på Salesforce-innstillingene dine. For å justere hvor mange kall som kan tildeles HubSpot, redigerer du feltet Tildelt til HubSpot.

Vis Salesforce-synkroniseringsfeil

1. I HubSpot-kontoen din klikker du på settings 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 Synkroniseringsstatus.
4. Under Synkroniseringsfeil kan du se kort for hver feiltype, med antall aktuelle feil og berørte poster. Klikk på et feiltype-kort for å se detaljer om feilene i høyre panel. Lær mer om hver feiltype og anbefalinger for løsning.

5. For å se flere detaljer om en feil, klikker du på informasjonsikonet « info » i kolonnen «Error Type» ( Feiltype).
6. For å utføre handlinger på individuelle poster, 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 i boksen til venstre for alle løste feil og klikk på Resync.
8. For å eksportere feilene dine, klikk på Eksporter feil (CSV) øverst til venstre i feillisten.

Typer av Salesforce-synkroniseringsfeil

Assosiasjoner

Eksempler på tilknytningsfeil

• Assosiasjonsgrensen 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 tilknytning av poster.

Hvordan løse feilene

For å løse feilen «Assosiasjonsgrensen er nådd» , kan du enten fjerne noen av de assosierte postene eller assosiere dem med 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å feil i tilpasset kode

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

Hva feilene betyr

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

Hvordan løse feilene

Duplikater

Eksempler på duplikatfeil

• E-postadressen er 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.

Hvordan løse 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 du sjekker samsvaringsreglene for deduplisering som er konfigurert i Salesforce.

Tillatelser

Eksempler på tillatelsesfeil

• Utilstrekkelig tilgang eller manglende Salesforce-post
• Salesforce-felt tillatelse
• Utilstrekkelig Salesforce-tilgang

Hva feilene betyr

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

For å løse feilen med Salesforce-feltetillatelse 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 i Salesforce. Det anbefales at du sjekker Salesforce-integrasjonsbrukerrettighetene i Salesforce.

Valglister

Eksempler på feil i valglister

• Manglende Salesforce-valgmulighet
• Feilaktig verdi for delstat eller land
• Uoverensstemmende alternativer
• Inaktiv Salesforce-eier
• Begrenset verdivalg i valglisten
• Inaktiv mulighetsfase
• Salesforce-eiere ikke synkronisert
• Alternativgrensen overskredet
• Standard salgsprosess utilgjengelig
• Manglende eller ugyldig mulighetsfase

Hva feilene betyr

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

Hvordan løse feilene

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

• Den interne verdien av alternativet Land i HubSpot må samsvare med et eksisterende alternativ for Land i innstillingene for delstater og land/territorier i Salesforce.
• Verdien for delstat må eksistere som et tilgjengelig alternativ for delstat/provins for verdien for land i Salesforce. I tillegg må den interne verdien for alternativet for delstat i HubSpot samsvare med et eksisterende alternativ for delstat i Salesforce.

For å løse feilen «Uoverensstemmende alternativer» anbefales det at du oppdaterer det interne/API-navnet på Salesforce-feltalternativene slik at det 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 valglisteverdi» oppstår når du har aktivert innstillingen «Begrens valgliste til verdiene som er definert i verdisettet» for feltet i Salesforce. Når dette er aktivert i Salesforce, må verdien du prøver å synkronisere fra HubSpot til Salesforce, finnes som et alternativ i Salesforce-valglisten. Det anbefales at du deaktiverer innstillingen Begrens valglisten til verdiene som er definert i verdisettet 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 å synkroniseres til HubSpot. For å løse denne feilen må du endre mulighetsfasen i Salesforce til aktiv eller flytte muligheten 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 til HubSpot med en manglende posttype. Hvis du har slått på posttyper i Salesforce, men ikke bruker dem, eller har Salesforce-muligheter uten posttype, anbefales det at du samarbeider med Salesforce for å deaktivere alle posttyper eller opprette en ny posttype.

For å løse feilen Manglende eller ugyldig mulighetsfase må du sørge for at verdien for Salesforce-mulighetsfasen finnes i HubSpot-pipeline.

Eiendomstilordninger

Eksempler på feil i egenskapstilordninger

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

Hva feilene betyr

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

Hvordan løse feilene

For å løse feilen Type mismatch (Typeavvik ), 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.

Eiendomsverdier

Eksempler på feil i egenskapsverdier

• Strengen er for lang
• Ugyldig e-post
• Mangler obligatorisk land
• Ugyldig verdi
• Eieroppgave
• Begrenset unik verdi
• Mangler 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» , oppdaterer du e-postadressens formatering i Salesforce-posten som forsøker å synkroniseres med HubSpot.

For å løse feilen Mangler obligatorisk land, anbefales det at du sjekker at følgende krav er oppfylt:

• Den interne verdien av alternativet Land i HubSpot må samsvare med et eksisterende alternativ for Land i innstillingene for delstater og land/territorier i Salesforce.
• Verdien for delstat må eksistere som et tilgjengelig alternativ for delstat/provins for verdien for land i Salesforce. I tillegg må den interne verdien for egenskapen Delstat i HubSpot samsvare med et eksisterende alternativ for delstat 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 «Eieroppgave» når en HubSpot-aktivitet synkroniseres til Salesforce som en Salesforce-oppgave, og HubSpot prøver å tildele oppgaven til en Salesforce-køeier.

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, legg til en verdi i Salesforce-posten for alle egenskaper som er merket som obligatoriske i HubSpot.

Annet

Poster 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 samtidig. For å synkronisere mer enn 100 feil, importerer du postene fra Salesforce eller oppdaterer en tilordnet egenskap.

Konfigurer varsler om synkroniseringsfeil

1. I HubSpot-kontoen din klikker du på settings 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 Synkroniseringsstatus.
4. Under Synkroniseringsfeil klikker du på Administrer varsler.
5. I dialogboksen slår du på bryteren Slå på varsler.
6. Velg alternativknappen ved siden av Umiddelbart, Daglig eller Ukentlig for å angi hyppigheten for varslene dine.
7. Klikk på Lagre.