Hantera API-anrop för Salesforce-integration och synkroniseringsfel

Integrationen mellan HubSpot och Salesforce kan stöta på synkroniseringsfel som förhindrar att data synkroniseras. Du kan identifiera och lösa dessa synkroniseringsfel i dina Salesforce-integrationsinställningar.

Justera gränsen för API-anrop

1. I ditt HubSpot-konto klickar du på settings inställningsikonen i det övre navigeringsfältet. I den vänstra sidomenyn går du till Integreringar > Anslutna appar.
2. Klicka påSalesforce i listan över anslutna appar. 
3. Gå till fliken Synkroniseringsstatus.  
4. I avsnittet Använda API-anropkan du se hur många API-anrop du har använt under de senaste 24 timmarna. Antaletbegränsat av Salesforce är antalet API-anrop du kan göra baserat på dina Salesforce-inställningar. För att justera hur många anrop som kan tilldelas HubSpot redigerar du fältet Tilldelat till HubSpot. 

Visa Salesforce-synkroniseringsfel

1. I ditt HubSpot-konto klickar du på settings inställningsikonen i det övre navigeringsfältet. I den vänstra sidomenyn går du till Integreringar > Anslutna appar.
2. Klicka påSalesforce i listan över anslutna appar. 
3. Gå till fliken Synkroniseringsstatus.  
4. Under Synkroniseringsfel kan du se kort för varje feltyp, med antalet aktuella fel och berörda poster. Klicka på ett felkort för att se detaljer om felen i den högra panelen. Läs mer om varje feltyp och rekommendationer för lösning. 

5. Om du vill se mer information om ett fel klickar du på informationsikonen i kolumnen Feltyp .
6. Om du vill vidta åtgärder för enskilda poster klickar du på [#] poster i kolumnen Påverkade poster och sedan på Åtgärder > Skapa en tillfällig vy av HubSpot-poster för att skapa en filtrerad vy av de poster som påverkas. 
7. När du har löst felen återgår du till fellistan. Markerakryssrutan till vänster om alla lösta fel och klicka på Synkronisera igen.
8. För att exportera dina fel klickar du på Exportera fel (CSV) längst upp till vänster i fellistan.

Typer av Salesforce-synkroniseringsfel

Associationer

Exempel på associationsfel 

• Associeringsgränsen har nåtts
• Väntar på att kontot ska synkroniseras

Vad felen betyder

Poster synkroniseras inte eftersom de är associerade med Salesforce-konton som ännu inte har synkroniserats med HubSpot-företag, eller eftersom de är associerade med poster som har nått HubSpots gräns för postassociationer. 

Hur man löser felen 

För att lösa felet" Associeringsgränsen har nåtts" kan du antingen ta bort några av de associerade posterna eller associera dem med en annan Salesforce-post och sedan fortsätta med synkroniseringen.

För att lösa felet Väntar på att kontot ska synkroniseras rekommenderas att du kör en import av Salesforce-konton. 

Anpassad kod

Exempel på anpassade kodfel 

• Salesforce-automatisering
• Saknad kontakt-ID
• Salesforce-valideringsregel för anpassat fält
• Salesforce-flöde

Vad felen betyder

Poster synkroniseras inte på grund av ett problem som orsakas av automatisering, flöden eller valideringsregler i ditt Salesforce-konto.

Hur du löser felen

Duplikater

Exempel på dubblettfel

• E-postadress används redan
• Salesforce-regel för dubbletter

Vad felen betyder

En Salesforce-lead eller -kontakt kan inte synkroniseras till HubSpot eftersom e-postadressen redan finns i en HubSpot-kontaktpost eller på grund av en dedupliceringsregel i Salesforce. 

Hur man löser felen

För att lösa felet E-postadress används redan, ta bort e-postadressen från den befintliga HubSpot-kontakten.

För att lösa felet Salesforce-dubbleringsregel rekommenderas att en Salesforce-administratör granskar matchningsreglerna för deduplicering som är konfigurerade i Salesforce. Slå sedan samman, uppdatera eller ta bort eventuella konflikterande Salesforce-poster, eller justera dedupliceringsregeln i Salesforce, innan du försöker synkronisera igen i HubSpot.

Behörigheter

Exempel på behörighetsfel

• Otillräcklig åtkomst eller saknad Salesforce-post
• Salesforce-fältbehörighet
• Otillräcklig åtkomst till Salesforce

Vad felen betyder

Ändringar som gjorts i HubSpot kan inte synkroniseras till Salesforce eftersom den anslutna användaren inte har åtkomst till det nödvändiga fältet eller objektet i Salesforce.

Hur du löser felen

I de flesta fall uppstår felet Otillräcklig åtkomst eller saknad Salesforce-post när integrationen försöker uppdatera ett Salesforce-fält med ett felaktigt värde eller skapa en felaktig koppling. 

För att lösa felet med behörighet för Salesforce-fältet , se till att Salesforce-integrationsanvändaren har läs- och redigeringsbehörighet för fältet i Salesforce. 

Felet Otillräcklig åtkomst till Salesforce uppstår när Salesforce-integrationsanvändaren inte kan utföra åtgärden i Salesforce på grund av sina användarbehörigheter i Salesforce. Vi rekommenderar att du kontrollerar Salesforce-integrationsanvändarens behörigheter i Salesforce.

Väljlistor

Exempel på fel i urvalslistor

• Saknad Salesforce-valslista
• Felaktigt värde för delstat eller land
• Felaktiga alternativ
• Inaktiv Salesforce-ägare
• Begränsat värde i urvalslistan
• Inaktivt affärsmöjlighetsstadium
• Salesforce-ägare synkroniseras inte
• Alternativgränsen överskriden
• Standardförsäljningsprocess otillgänglig
• Saknad eller ogiltig affärsmöjlighetsfas

Vad felen betyder

Poster synkroniseras inte på grund av en diskrepans mellan värdena i urvalslistfältet i HubSpot och Salesforce. Detta kan inträffa när ett värde i urvalslistan i det ena systemet inte matchar något av de aktuella värdena i det andra, om urvalslistan har nått gränsen för värden eller om det överförda värdet inte är giltigt.

Hur du löser felen

För att lösa feletmed felaktiga värden för delstat eller land rekommenderar vi att du kontrollerar att följande krav är uppfyllda:

• Det interna värdet för alternativet Land i HubSpot måste matcha ett befintligt alternativ för Land i dina inställningar för delstater och länder/territorier i Salesforce. 
• Värdet för delstat måste finnas som ett tillgängligt alternativ för delstat/provinsför postens värde för land i Salesforce. Dessutom måste det interna värdet för egenskapsalternativet Delstat i HubSpot matcha ett befintligt alternativ för delstat i Salesforce. 

För att lösa felet ”Olika alternativ ” rekommenderar vi att du uppdaterar det interna/API-namnet på Salesforce-fältalternativen så att det matchar det interna värdet för egenskapsalternativen i HubSpot. 

För att lösa felet Inaktiv Salesforce-ägare, tilldela HubSpot-posten till en användare som är aktiv i Salesforce. 

Felet Begränsat val i listan uppstårnär du har aktiverat Begränsa listan till de värden som definierats i värdeuppsättningen för fältet i Salesforce. När detta är aktiverat i Salesforce måste det värde som du försöker synkronisera från HubSpot till Salesforce finnas som ett alternativ i Salesforce-listan. Vi rekommenderar att du inaktiverar inställningen Begränsa listan till de värden som definierats i värdesatsen i Salesforce, så att alla värden kan synkroniseras från HubSpot till Salesforce. 

Felet Inaktiv affärsmöjlighetsfas uppstår när en affärsmöjlighet i Salesforce med en inaktiv affärsmöjlighetsfas försöker synkroniseras till HubSpot. För att lösa detta fel ändrar du affärsmöjlighetsfasen i Salesforce till aktiveller flyttar affärsmöjligheten till en aktiv fas. 

För att lösa felet Salesforce-ägare synkroniseras inte, se till att Salesforce-användarna har användartyp inställd på Standard, Power Partner eller Gäst i Salesforce. 

För att lösa felet Alternativgränsen överskriden rekommenderas att du tar bort extra egenskapsalternativ i HubSpot och Salesforce som ditt team inte använder. Se dessutom till att alla mappade egenskaper har motsvarande fälttyper. 

I de flesta fall uppstår felet Standardförsäljningsprocessen är inte tillgänglig när Salesforce-affärsmöjligheter försöker synkroniseras med HubSpot med en saknad posttyp. Om du har aktiverat posttyper i Salesforce men inte använder dem, eller har Salesforce-affärsmöjligheter utan posttyp, rekommenderar vi att du samarbetar med Salesforce för att inaktivera alla posttyper eller skapa en ny posttyp. 

För att lösa felet " Saknad eller ogiltig affärsmöjlighetsfas " ska du se till att värdet för affärsmöjlighetsfasen i Salesforce finns i HubSPOT-pipeline. 

Egenskapsmappningar

Exempel på fel i egenskapskartläggningar 

• Typkonflikt
• Saknad Salesforce-ID
• Ogiltigt Salesforce-ID

Vad felen betyder

Poster synkroniseras inte på grund av en diskrepans i mappningen mellan HubSpot-egenskapen och Salesforce-fältet. Detta kan betyda att egenskapen och fälttyperna inte är kompatibla, att egenskapen eller fältet inte längre finns eller att en Salesforce-referensfältmappning måste skapas.

Hur du löser felen 

För att lösa felet Typkonflikt måste du se till att egenskapstypen i HubSpot och fälttypen i Salesforce är kompatibla. Läs mer om de HubSpot-egenskapsfältstyper som kan synkroniseras med Salesforce. 

Felet Saknat Salesforce-ID uppstår när HubSpot försökte synkronisera ett annat värde än ett befintligt Salesforce-ID till ett referens-/uppslagsfält i Salesforce. 

För att lösa felet Ogiltigt Salesforce-ID rekommenderar vi att du kontrollerar den anpassade valideringsregel som du har ställt in i Salesforce. 

Egenskapsvärden

Exempel på fel i egenskapsvärden

• Strängen är för lång
• Ogiltig e-postadress
• Saknat obligatoriskt land
• Ogiltigt värde
• Ägarfördelning
• Begränsat unikt värde
• Saknat obligatoriskt värde

Vad felen betyder

Poster synkroniseras inte mellan HubSpot och Salesforce eftersom de innehåller egenskapsvärden som inte är giltiga. Dessa fel kräver vanligtvis att de enskilda berörda posterna uppdateras för att korrigera felet.

Hur du löser felen

För att lösa felet Strängen är för lång, förkorta fältvärdet i Salesforce eller HubSpot, eller öka teckenbegränsningen för fältet i Salesforce. 

För att åtgärda felet Ogiltig e-postadress uppdaterar du e-postadressens format i Salesforce-posten som försöker synkroniseras med HubSpot.

För att lösa felet Saknat obligatoriskt land rekommenderas att du kontrollerar att följande krav är uppfyllda:

• Det interna värdet för alternativet Land i HubSpot måste matcha ett befintligt alternativ för Land i dina inställningar för delstater och länder/territorier i Salesforce. 
• Värdet för delstat måste finnas som ett tillgängligt alternativ för delstat/provinsför postens värde för land i Salesforce. Dessutom måste det interna värdet för egenskapen Delstat i HubSpot matcha ett befintligt alternativ för delstat i Salesforce. 

För att lösa felet Ogiltigt värde rekommenderar vi att du uppdaterar egenskapsvärdet i Salesforce-posten så att det uppfyller HubSpots krav för egenskapsvärdet. 

I de flesta fall uppstår felet Ägarens tilldelning när en HubSpot-aktivitet synkroniseras till Salesforce som en Salesforce-uppgift och HubSpot försöker tilldela uppgiften till en Salesforce-köägare.

För att lösa felet Begränsat unikt värde rekommenderar vi att du kontrollerar de matchningsregler för deduplicering som du har ställt in i Salesforce. 

För att lösa felet Saknat obligatoriskt värde lägger du till ett värde i Salesforce-posten för alla egenskaper som är markerade som obligatoriska i HubSpot. 

Övrigt

Poster synkroniseras inte på grund av ett okänt fel. Kontakta HubSpot Support för ytterligare hjälp med dessa fel.

Observera: det är möjligt att synkronisera 100 Salesforce-fel åt gången. För att synkronisera fler än 100 fel, importera posterna från Salesforce eller uppdatera en mappad egenskap.

Konfigurera meddelanden om synkroniseringsfel

1. I ditt HubSpot-konto klickar du på settings inställningsikonen i det övre navigeringsfältet. I den vänstra sidomenyn går du till Integreringar > Anslutna appar.
2. Klicka påSalesforce i listan över anslutna appar. 
3. Navigera till fliken Synkroniseringsstatus. 
4. UnderSynkroniseringsfel klickar du påHantera aviseringar. 
5. I dialogrutan aktiverar du alternativetAktivera aviseringar. 
6. Välj alternativknappen bredvidOmedelbart,Dagligen ellerVeckovis för att ställa in hur ofta du vill få aviseringar. 
7. Klicka påSpara.