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

Integrationen mellan HubSpot och Salesforce kan drabbas av synkroniseringsfel som förhindrar att data synkroniseras. Du kan identifiera och åtgärda dessa synkroniseringsfel i dina integrationsinställningar för Salesforce.

Justera gränsen för API-anrop

1. I ditt HubSpot-konto klickar du på 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 Datasynkronisering. 
4. På fliken Synkroniseringsstatus, i avsnittet Använda API-anrop, kan du se hur många API-anrop du har använt under de senaste 24 timmarna. SiffranBegrä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å 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 Datasynkronisering. 
4. På fliken Synkroniseringsstatus, iavsnittetSynkroniseringsfel , kan du se kort för varje feltyp med antalet aktuella fel och berörda poster. Klicka på ett kort för en feltyp för att se detaljer om felen i den högra panelen. Läs mer om varje feltyp och rekommendationer för hur du åtgärdar dem. 

5. Om du vill se mer information om ett fel klickar du på informationsikonen i kolumnen Feltyp .
6. För att vidta åtgärder på enskilda poster, klicka på [#] poster i kolumnen Berörda poster och klicka sedan på Åtgärder > Skapa en tillfällig vy av HubSpot-poster för att skapa en filtrerad vy av de berörda posterna. 
7. När du har åtgärdat felen återgår du till fellistan. Markerakryssrutan till vänster om alla åtgärdade fel och klicka på Synkronisera om.
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

Kopplingar

Exempel på fel i kopplingar 

• Gränsen för kopplingar har nåtts
• Väntar på att kontot ska synkroniseras

• Fel i associationens kardinalitet

Vad felen betyder

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

Felet ”Association cardinality mismatch ” uppstår när en aktivitet som är kopplad till flera kontakter i HubSpot försöker synkroniseras till Salesforce. Integrationen stöder endast synkronisering av en kontaktkoppling per aktivitet.

Så här åtgärdar du felen 

För att åtgärda felet ”Association limit reached”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 åtgärda felet ”Väntar på att kontot ska synkroniseras ” rekommenderas att du importerar Salesforce -konton. 

För att åtgärda felet ”Association cardinality mismatch ” tar du bort ytterligare kontaktkopplingar så att endast en kontakt förblir kopplad till aktiviteten.

Anpassad kod

Exempel på fel i anpassad kod 

• Salesforce-automatisering
• Kontakt-ID saknas
• Valideringsregel för anpassat fält i Salesforce
• 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.

Så här åtgärdar du felen

Dubbletter

Exempel på fel med dubbletter

• E-postadressen används redan
• Regel för dubbletter i Salesforce

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 regel för borttagning av dubbletter i Salesforce. 

Så här åtgärdar du felen

För att åtgärda felet ”E-postadressen används redan ” tar du bort e-postadressen från den befintliga HubSpot-kontakten.

För att åtgärda felet ”Dupliceringsregel i Salesforce” rekommenderas att en Salesforce-administratör granskar de matchningsregler för deduplicering som har konfigurerats i Salesforce. Sammanfoga, uppdatera eller ta bort eventuella konflikterande Salesforce-poster, eller justera dedupliceringsregeln i Salesforce, innan du försöker synkronisera på nytt i HubSpot.

Behörigheter

Exempel på behörighetsfel

• Otillräcklig åtkomst eller saknad Salesforce-post
• Behörighet för Salesforce-fält
• Otillräcklig åtkomst till Salesforce

Vad felen betyder

Ändringar som görs 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.

Så här åtgärdar du 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 åtgärda felet med behörigheten till Salesforce-fältet måste du se till att användaren för Salesforce-integrationen har behörigheterna Läs och Redigera 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.

Valslistor

Exempel på fel i urvalslistor

• Saknat alternativ i Salesforce-urvalslistan
• Värdet för delstat eller land stämmer inte överens
• Alternativen stämmer inte överens
• Inaktiv Salesforce-ägare
• Begränsat värde i urvalslistan
• Inaktivt affärsmöjlighetsstadium
• Salesforce-ägare har inte synkroniserats
• Alternativgränsen överskriden
• Standardförsäljningsprocessen är inte tillgänglig
• Saknad eller ogiltig affärsmöjlighetsfas

Vad felen betyder

Poster synkroniseras inte på grund av en avvikelse mellan värdena i urvalslistorna i HubSpot och Salesforce. Detta kan inträffa när ett värde i urvalslistan i det ena systemet inte stämmer överens med något av de aktuella värdena i det andra, om urvalslistan har nått en gräns för antalet värden eller om det överförda värdet inte är giltigt.

Så här åtgärdar du felen

För att åtgärda felet”Mismatched state or country value ” rekommenderas att du kontrollerar att följande krav är uppfyllda:

• Det interna värdet för alternativet för egenskapen Land i HubSpot måste stämma överens med ett befintligt landalternativ i inställningarna för listan över 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 landvärde 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 åtgärda felet ”Alternativen stämmer inte överens ” rekommenderas att du uppdaterar det interna namnet/API-namnet på alternativet i Salesforce-fältet så att det stämmer överens med det interna värdet för egenskapsalternativen i HubSpot. 

För att åtgärda felet ”Inaktiv Salesforce-ägare ” ska du tilldela HubSpot-posten till en användare som är aktiv i Salesforce. 

Felet ”Begränsat värde i urvalslistan”uppstårnär inställningen ”Begränsa urvalslistan till de värden som definierats i värdesatsen” är aktiverad för fältet i Salesforce. När denna inställning är aktiverad i Salesforce måste det värde som du försöker synkronisera från HubSpot till Salesforce finnas som ett alternativ i Salesforces urvalslista. Vi rekommenderar att du inaktiverar inställningen ”Begränsa urvalslistan till de värden som definierats i värdesatsen” i Salesforce, så att alla värden kan synkroniseras från HubSpot till Salesforce. 

Felet ”Inaktivt affärsmöjlighetsstadium” uppstår när en affärsmöjlighet i Salesforce med ett inaktivt affärsmöjlighetsstadium försöker synkroniseras till HubSpot. För att åtgärda detta fel ändrar du affärsmöjlighetsstadiet i Salesforce till aktivteller flyttar affärsmöjligheten till ett aktivt stadium. 

För att åtgärda felet ”Salesforce-ägare har inte synkroniserats ” ska du se till att Salesforce-användarnas användartyp är inställd på Standard, Power Partner eller Gäst i Salesforce. 

För att åtgärda 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 till 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, rekommenderas 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.

För fel i Salesforce-uppgiftsfält ska du jämföra värdena för uppgiftsprioritet, status eller typ i Salesforce med motsvarande alternativ för uppgiftsegenskaper i HubSpot. Uppgiftsprioritet stöder endast Hög, Medel, Låg och Ingen. För status och typ ska du uppdatera Salesforce-värdena så att de exakt matchar de tillgängliga alternativen i HubSpot, eller lägga till matchande alternativ i HubSpot.

Egenskapsmappningar

Exempel på fel vid egenskapsmappning 

• Typkonflikt
• Saknat Salesforce-ID
• Ogiltigt Salesforce-ID

Vad felen betyder

Poster synkroniseras inte på grund av en avvikelse i mappningen mellan HubSpot-egenskapen och Salesforce-fältet. Detta kan innebära att egenskaps- och fälttyperna inte är kompatibla, att egenskapen eller fältet inte längre finns eller att en mappning för ett Salesforce-referensfält måste skapas.

Så här åtgärdar du felen 

För att åtgärda 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 ”Missing Salesforce ID ” uppstår när HubSpot har försökt synkronisera ett värde som inte är ett befintligt Salesforce-ID till ett referens-/uppslagsfält i Salesforce. 

För att åtgärda felet ”Ogiltigt Salesforce-ID ” rekommenderas att du kontrollerar den anpassade valideringsregeln som du har ställt in i Salesforce. 

Egenskapsvärden

Exempel på fel relaterade till egenskapsvärden

• Strängen är för lång
• Ogiltig e-postadress
• Obligatoriskt land saknas
• Ogiltigt värde
• Tilldelning av ägare
• Begränsat unikt värde
• Obligatoriskt värde saknas

Vad felen betyder

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

Så här åtgärdar du felen

För att åtgärda felet ”Strängen är för lång ” ska du 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 ” måste du uppdatera formateringen av e-postadressen i den Salesforce-post som försöker synkroniseras med HubSpot.

För att åtgärda felet ”Obligatoriskt land saknas ” rekommenderas att du kontrollerar att följande krav är uppfyllda:

• Det interna värdet för alternativet Land i HubSpot måste stämma överens med ett befintligt landalternativ i inställningarna för delstat och land/territorium i Salesforce. 
• Värdet för delstat måste finnas som ett tillgängligt alternativ för delstat/provinsför postens landvärde 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 åtgärda felet ”Ogiltigt värde ” rekommenderas 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 ”Ägar tilldelning ” när en HubSpot-aktivitet synkroniseras till Salesforce som en Salesforce-uppgift och HubSpot försöker tilldela uppgiften till en ägare i en Salesforce-kö.

För att åtgärda felet ”Begränsat unikt värde ” rekommenderas att du kontrollerar de matchningsregler för deduplicering som du har ställt in i Salesforce. 

För att åtgärda 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/Okänt

Exempel på annat/okänt fel

• Ett okänt Salesforce-duplikatfel inträffade: Duplikat-ID angivet.

Vad felet betyder

Detta fel kan uppstå om du skapar en fältmappning som innehåller ett standardfält för Salesforce-ID, till exempel Lead-ID eller Kontakt-ID, och mappar det till motsvarande egenskap Salesforce Lead-ID eller Salesforce Kontakt-ID i HubSpot.

Så här åtgärdar du felet

Dessa ID-värden hanteras automatiskt av integrationen och bör inte inkluderas i anpassade fältmappningar. Att skapa dessa mappningar kan orsaka oväntat synkroniseringsbeteende, särskilt när synkroniseringsregeln är inställd på tvåvägs.

För andra okända fel, kontakta HubSpot-supporten för ytterligare hjälp.

Observera: det går 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å 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 Datasynkronisering. 
4. På fliken Synkroniseringsstatus, i avsnittet Synkroniseringsfel , klickar du påHantera aviseringar. 
5. Aktivera knappen Aktiveraaviseringar i dialogrutan. 
6. Markera alternativknappen bredvidOmedelbart,Dagligen ellerVeckovis för att ställa in hur ofta du vill få aviseringar. 
7. Klicka påSpara.