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

Integrationen mellan HubSpot och Salesforce kan drabbas av synkroniseringsfel som hindrar data från att 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å 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 Datasynkronisering. 
4. På fliken Synkroniseringsstatus, i avsnittet 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å settings inställningsikonen i det övre navigeringsfältet. I den vänstra sidomenyn går du till Integreringar > Anslutna appar.
2. I listan över anslutna appar klickar du påSalesforce. 
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 feltypkort 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 visa 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, klicka på Exportera fel (CSV) längst upp till vänster i fellistan.

Typer av Salesforce-synkroniseringsfel

Associationer

Exempel på associeringsfel 

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

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. 

Så här löser du felen 

För att lösa felet ”Gränsen för kopplingar har nåtts”kan du antingen ta bort några av de kopplade posterna eller koppla dem till 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å fel i anpassad kod 

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

Vad felen betyder

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

Så här löser 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 lösa felet E-postadressen används redan tar du bort e-postadressen från den befintliga HubSpot-kontakten.

För att lösa felet med dubblettregeln 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 konfliktande 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.

Så här löser 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 lösa 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

• Saknad alternativ i Salesforce-urvalslistan
• Stats- eller landsvärdet stämmer inte
• Alternativen stämmer inte överens
• Inaktiv Salesforce-ägare
• Begränsat värde i urvalslistan
• Inaktivt affärsmöjlighetsstadium
• Salesforce-ägare synkroniseras inte
• 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 aktuellt värde 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 löser du felen

För att lösa felet”Mismatched state or country value ” 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 landsalternativ 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 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 ”Mismatched options ” rekommenderas att du uppdaterar det interna/API-namnet på Salesforce-fältalternativen så att det stämmer överens med det interna värdet för egenskapsalternativen i HubSpot. 

För att lösa 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 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 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 lösa detta fel ändrar du affärsmöjlighetsstadiet i Salesforce till aktivteller flyttar affärsmöjligheten till ett aktivt stadium. 

För att lösa felet ”Salesforce-ägare synkroniseras inte ” ska du se till att Salesforce-användarna har användartypen 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-mö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-mö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, se till att värdet för affärsmöjlighetsfasen i Salesforce finns i HubSpot-pipeline.

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

Egenskapsmappningar

Exempel på fel i egenskapsmappningar 

• 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 betyda 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 löser du 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 ”Missing 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 rekommenderas att du kontrollerar den anpassade valideringsregeln 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
• Obligatoriskt land saknas
• Ogiltigt värde
• Ägaruppdrag
• Begränsat unikt värde
• Obligatoriskt värde saknas

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.

Så här åtgärdar du felen

För att lösa 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 e-postadressens format i den Salesforce-post som försöker synkroniseras med HubSpot.

För att lösa 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 matcha 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 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 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 ”Ägaruppdrag” när en HubSpot-aktivitet synkroniseras till Salesforce som en Salesforce-uppgift och HubSpot försöker tilldela uppgiften till en ägare av en Salesforce-kö.

För att lösa 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 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. Gå till fliken Datasynkronisering. 
4. På fliken Synkroniseringsstatus, i avsnittet Synkroniseringsfel , klickar du påHantera aviseringar. 
5. I dialogrutan aktiverar du växelnAktivera aviseringar. 
6. Välj alternativknappen bredvidOmedelbart,Dagligen ellerVeckovis för att ställa in frekvensen för dina aviseringar. 
7. Klicka påSpara.