Hantera API-anrop för integration av Salesforce och synkroniseringsfel
Senast uppdaterad: 27 maj 2025
Tillgänglig med något av följande abonnemang, om inte annat anges:
|
|
|
|
|
Integrationen HubSpot-Salesforce kan stöta på synkroniseringsfel, vilket 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
- 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.
- I listan över anslutna appar klickar du på Salesforce.
- På fliken Synkroniseringshälsa, i avsnittet Användning av API-anrop , kan du se hur många API-anrop du har använt under de senaste 24 timmarna. Summan Begränsad av Salesforce är den summa API-anrop som du kan göra baserat på dina Salesforce-inställningar. För att justera hur många Ringer som kan allokeras till HubSpot, redigera fältet Allokerat till HubSpot.
Visa fel i synkroniseringen av Salesforce
- 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.
- I listan över anslutna appar klickar du på Salesforce.
- På fliken Synkroniseringshälsa, under Synkroniseringsfel, visas kort för varje feltyp, med antalet aktuella fel och påverkade register. 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 lösningsrekommendationer.
- Om du vill visa mer information om ett fel klickar du på informationsikonen info i kolumnen Feltyp .
- Om du vill vidta åtgärder för enskilda register klickar du på [#] register i kolumnen Berörda register och klickar sedan på Åtgärder > Skapa en tillfällig vy av HubSpot-register för att skapa en filtrerad vy av de berörda registren.
- När du har löst felen går du tillbaka till listan med fel. Markera kryssrutan till vänster om alla lösta fel och klicka på Resynkronisera.
- Om du vill exportera dina fel klickar du på Export errors (CSV) längst upp till vänster i listan över fel.

Typer av fel vid synkronisering av Salesforce
Associations
Exempel på fel i associationer
- Gränsen för association nådd
- Väntar på att kontot ska synkroniseras
Vad felen innebär
Register synkroniseras inte eftersom de är associerade med Salesforce-konton som inte har synkroniserats med HubSpot Företag ännu, eller eftersom de är associerade med register som har nått HubSpots gräns för association av register.
Så här åtgärdar du felen
För att lösa felet Association limit reached kan du antingen ta bort några av de associerade registren eller associera dem med ett annat Salesforce-register och sedan fortsätta med synkroniseringen.
För att lösa felet Väntar på att konto ska synkroniseras rekommenderas att du kör en import av Salesforce-konton.
Kundkod
Exempel på fel i anpassad kod
- Automatisering av Salesforce
- ID för kontakt saknas
- Regel för validering av anpassade fält i Salesforce
- Salesforce flöde
Vad felen innebär
Register 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
Eftersom dessa fel härrör från Salesforce rekommenderas att du arbetar med din Salesforce-administratör för att lösa problemet i din anpassade kod i Salesforce.
Duplikat
Exempel på duplikatfel
- E-post som redan används
- Salesforce regel för dubbletter
Vad felen innebär
En potentiell kund eller kontakt i Salesforce kan inte synkroniseras med HubSpot eftersom e-postadressen redan finns i ett HubSpot-kontaktregister 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-post som redan används, ta bort e-postadressen från den befintliga HubSpot-kontakten.
För att lösa Salesforce-duplikatregelfelet rekommenderas att du kontrollerar de matchande reglerna för borttagning av dubbletter som konfigurerats i Salesforce.
Behörigheter
Exempel på fel i behörigheter
- Otillräcklig åtkomst eller saknat register i Salesforce
- Behörighet för Salesforce-fält
- Otillräcklig åtkomst till Salesforce
Vad felen innebär
Ändringar som görs i HubSpot kan inte synkroniseras med Salesforce eftersom den anslutna användaren inte har tillgång 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 saknat Salesforce-register när integrationen försöker uppdatera ett Salesforce-fält med ett felaktigt värde eller skapa en felaktig association.
För att lösa behörighetsfelet för Salesforce-fältet ska du se till att användaren av Salesforce integrationer har läs- och redigeringsbehörighet för fältet i Salesforce.
Felet Otillräcklig åtkomst till Salesforce uppstår när användaren av Salesforce integration inte kan utföra åtgärden i Salesforce på grund av deras användarrättigheter i Salesforce. Vi rekommenderar att du kontrollerar behörigheterna för användaren av integrationen i Salesforce i Salesforce.
Picklistor
Exempel på fel i picklistor
- Saknar alternativ för Salesforce-picklista
- Felaktigt värde för stat eller land
- Felmatchade alternativ
- Inaktiv Salesforce-ägare
- Begränsat värde i picklistan
- Inaktivt stadium för Möjlighet
- Salesforce-ägare inte synkroniserade
- Gränsen för alternativ överskriden
- Standardprocessen för försäljning är inte tillgänglig
- Möjlighetens steg saknas eller är ogiltigt
Vad felen innebär
Register synkroniseras inte på grund av en skillnad mellan picklistfältvärden i HubSpot och Salesforce. Detta kan hända när ett picklistvärde i det ena systemet inte matchar några aktuella värden i det andra, om picklistan har nått en gräns för värden eller om det värde som skickas inte är giltigt.
Så här åtgärdar du felen
För att lösa felet Mismatchat värde för stat eller land rekommenderar vi att du kontrollerar att följande krav är uppfyllda:
- Det interna värdet för egenskapen Country i HubSpot måste matcha ett befintligt Country-alternativ i dina inställningar för State och Country/Territory picklist i Salesforce.
- State-värdet måste finnas som ett tillgängligt State/Province-alternativ för registrets Country-värde i Salesforce. Dessutom måste det interna värdet för egenskapen State i HubSpot matcha ett befintligt State-alternativ i Salesforce.
För att lösa felet Mismatchade alternativ rekommenderas att du uppdaterar det interna / API-namnet på Salesforce-fältalternativen så att de matchar det interna värdet på egenskapens alternativ i HubSpot.
För att lösa felet Inaktiv Salesforce-ägare, tilldela HubSpot-registret till en användare som är en aktiv användare i Salesforce.
Felet Restricted picklist value uppstår när du har inställningen Restrict picklist to the values defined in the value set 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 Salesforce picklista. Vi rekommenderar att du stänger av Begränsa urvalslistan till de värden som definieras i värdeuppsättningsinställningen i Salesforce, så att alla värden kan synkroniseras från HubSpot till Salesforce.
Felet Inaktivt steg för möjlighet uppstår när en Salesforce-möjlighet med ett inaktivt steg för möjlighet försöker synkronisera till HubSpot. För att lösa detta fel ska du ändra Möjlighetens steg i Salesforce till aktivt eller flytta möjligheten till ett aktivt steg.
För att lösa felet Salesforce-ägare inte synkroniserade, se till att Salesforce-användarna har användartyp inställd på Standard, Power Partner eller Guest i Salesforce.
För att lösa felet Option limit exceeded rekommenderas att du tar bort extra alternativ för egenskaper i HubSpot och Salesforce som ditt team inte använder. Dessutom ska du se till att alla mappade egenskaper har motsvarande fältkartläggning.
I de flesta fall uppstår felet Default sales process unavailable när Möjligheter i Salesforce försöker synkronisera till HubSpot med ett saknat Register. Om du har aktiverat registertyper i Salesforce, men inte använder dem, eller om du har Salesforce Möjligheter utan registertyp, rekommenderar vi att du arbetar med Salesforce för att inaktivera alla registertyper eller skapa en ny registertyp.
För att lösa felet Saknas eller ogiltigt steg för möjlighet, se till att Salesforce-värdet för möjlighetssteget finns i HubSpot pipeline.
Egenskapskartläggningar
Exempel på fel i egenskapskartläggningar
- Typ av felmatchning
- Saknat Salesforce-ID
- Ogiltigt Salesforce-ID
Vad felen innebär
Register 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 Salesforce-referensfältkartläggning måste skapas.
Så här åtgärdar du felen
För att lösa felet Type mismatch ska du se till att egenskapstypen i HubSpot och fälttypen i Salesforce är kompatibla. Läs mer om de fälttyper för egenskaper i HubSpot som kan synkroniseras med Salesforce.
Felet Missing Salesforce ID uppstår när HubSpot försöker 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.
Egenskapernas värde
Exempel på fel i egenskaperna
- Strängen är för lång
- Ogiltig e-post
- Saknar obligatoriskt land
- Ogiltigt värde
- Tilldelning av ägare
- Begränsat unikt värde
- Saknar obligatoriskt värde
Vad felen innebär
Register synkroniseras inte mellan HubSpot och Salesforce eftersom de innehåller värden för egenskaper som inte är giltiga. Dessa fel kräver vanligtvis att de enskilda berörda registren uppdateras för att korrigera felet.
Så här åtgärdar du felen
För att lösa felet String too long, förkorta fältvärdet i Salesforce eller HubSpot, eller öka teckengränsen för fältet i Salesforce.
För att lösa felet Ogiltig e-post , uppdatera formateringen av e-postadressen på Salesforce-registret som försöker synkronisera till HubSpot.
För att lösa felet Missing required country rekommenderar vi att du kontrollerar att följande krav är uppfyllda:
- Det interna värdet för egenskapen Country i HubSpot måste matcha ett befintligt Country-alternativ i dina inställningar för State och Country/Territory picklist i Salesforce.
- State-värdet måste finnas som ett tillgängligt State/Province-alternativ för registrets Country-värde i Salesforce. Dessutom måste det interna värdet för egenskapen State i HubSpot matcha ett befintligt State-alternativ i Salesforce.
För att lösa felet Ogiltigt värde rekommenderas att du uppdaterar egenskapens värde på Salesforce-registret för att uppfylla HubSpots krav på egenskapens värde.
I de flesta fall uppstår felet Owner Assignment när en HubSpot-aktivitet synkroniseras till Salesforce som en Salesforce-uppgift och HubSpot försöker tilldela uppgiften till en Salesforce Queue-ägare.
För att lösa felet Begränsat unikt värde rekommenderas att du kontrollerar matchningsreglerna för borttagning av dubbletter som du har ställt in i Salesforce.
För att lösa felet Saknar obligatoriskt värde, lägg till ett värde i Salesforce-registret för alla egenskaper som är markerade som obligatoriska i HubSpot.
Övriga
Register synkroniseras inte på grund av ett okänt fel. Vänligen kontakta HubSpot-support för ytterligare hjälp med dessa fel.
Observera: Det är möjligt att massynkronisera 100 Salesforce-fel åt gången. Om du vill synkronisera fler än 100 fel måste du importera registren från Salesforce eller uppdatera en mappad egenskap.
Konfigurera meddelanden om synkroniseringsfel
- 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.
- I listan över anslutna appar klickar du på Salesforce.
- Klicka på fliken Synkroniseringshälsa.
- Under Synkroniseringsfel klickar du på Hantera aviseringar.
- I dialogrutan växlar du reglaget Slå på aviseringar på.
- Välj radioknappen bredvid Omedelbart, Dagligen eller Veckovis för att ställa in frekvensen för dina aviseringar.
- Klicka på Spara.