HubSpot Kunskapsbas

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

Skriven av HubSpot Support | Nov 2, 2021 3:57:29 PM

HubSpot-Salesforce-integrationen 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

  • Klicka på Salesforce i listan över anslutna appar.
  • På fliken Synkningshä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. Siffran Begränsad av Salesforce är den mängd API-anrop du kan göra baserat på dina Salesforce-inställningar. Om du vill justera hur många anrop som kan allokeras till HubSpot redigerar du fältet Allokerat till HubSpot.

Visa synkroniseringsfel i Salesforce

  • Klicka på Salesforce i listan över anslutna appar.
  • På fliken Synkroniseringshälsa, under Synkroniseringsfel, visas kort för varje feltyp, med antalet aktuella fel och påverkade 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 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 poster klickar du på [#] poster i kolumnen Berörda poster och klickar sedan på Åtgärder > Skapa en tillfällig vy över HubSpot-poster för att skapa en filtrerad vy över de påverkade posterna.
  • När du har löst felen går du tillbaka till fellistan. Markera kryssrutan till vänster om alla åtgärdade fel och klicka på Resync.
  • Om du vill exportera dina fel klickar du på Exportera fel (CSV) längst upp till vänster i fellistan.


Typer av synkroniseringsfel i Salesforce

Associationer

Exempel på fel i associationer

  • Associationsgrä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 inte har synkroniserats till HubSpot-företag ännu, eller eftersom de är associerade med poster som har nått HubSpots gräns för postassociationer.

Så här löser du felen

För att lösa felet Associationsgräns nådd 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 konto ska synkroniseras rekommenderar vi att du kör en import av Salesforce-konton.

Anpassad kod

Exempel på fel i anpassad kod

  • Salesforce-automatisering
  • ID för kontakt saknas
  • Regel för validering av anpassade fält i Salesforce
  • Salesforce flöde

Vad felen innebär

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

Så här löser du felen

Eftersom dessa fel har sitt ursprung i Salesforce rekommenderar vi att du samarbetar med din Salesforce-administratör för att lösa problemet i din anpassade kod i Salesforce.

Duplikat

Exempel på duplikatfel

  • E-post redan i bruk
  • Salesforce duplikatregel

Vad innebär felen

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

Så här löser du felen

För att lösa felet Email already in use tar du 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 deduplicering som har ställts in i Salesforce.

Behörigheter

Exempel på fel i behörigheter

  • Otillräcklig åtkomst eller saknad Salesforce-post
  • 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 till Salesforce eftersom den anslutna användaren inte har åtkomst till det nödvändiga fältet eller objektet i Salesforce.

Hur man 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 association.

För att lösa behörighetsfelet för Salesforce-fältet måste du se till att användaren av Salesforce-integrationen 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-integrationen inte kan utföra åtgärden i Salesforce på grund av sina användarrättigheter i Salesforce. Vi rekommenderar att du kontrollerar behörigheterna för användaren av Salesforce-integrationen i Salesforce.

Picklistor

Exempel på fel i picklistor

  • Saknat alternativ för Salesforce-picklista
  • Felaktigt värde för stat eller land
  • Felmatchade alternativ
  • Inaktiv Salesforce-ägare
  • Begränsat värde i picklistan
  • Inaktiv möjlighetsstadium
  • Salesforce-ägare inte synkroniserade
  • Gränsen för alternativ överskriden
  • Standardförsäljningsprocess inte tillgänglig
  • Saknat eller ogiltigt möjlighetsstadium

Vad felen innebär

Poster synkroniseras inte på grund av en diskrepans 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 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 egenskapsalternativet 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 Available State/Province-alternativ för postens Country-värde i Salesforce. Dessutom måste det interna värdet för egenskapsalternativet State i HubSpot matcha ett befintligt State-alternativ i Salesforce.

För att lösa felet Mismatched options rekommenderas att du uppdaterar det interna/API-namnet för 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 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-picklistan. Vi rekommenderar att du stänger av funktionen Begränsa picklistan till de värden som definieras i inställningen för värdeuppsättning i Salesforce, så att alla värden kan synkroniseras från HubSpot till Salesforce.

Felet Inactive opportunity stage uppstår när en Salesforce-möjlighet med ett inaktivt opportunity stage försöker synkronisera till HubSpot. För att lösa det här felet ändrar du möjlighetsstadiet i Salesforce till aktivt eller flyttar möjligheten till ett aktivt stadium.

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 egenskapsalternativ i HubSpot och Salesforce som ditt team inte använder. Dessutom bör du se till att alla mappade egenskaper har motsvarande fälttyper.

I de flesta fall uppstår felet Default sales process unavailable när Salesforce-möjligheter försöker synkronisera till HubSpot med en saknad Record Type. Om du har aktiverat posttyper i Salesforce, men inte använder dem, eller om du har Salesforce-möjligheter utan en posttyp, rekommenderas att du arbetar med Salesforce för att inaktivera alla posttyper eller skapa en ny posttyp.

För att lösa felet Missing or invalid opportunity stage, se till att Salesforce opportunity stage-värdet finns i HubSpot-pipelinen.

Mappningar av egenskaper

Exempel på fel i egenskapsmappningar

  • Typ av felmatchning
  • Saknar Salesforce-ID
  • Ogiltigt Salesforce-ID

Vad felen innebär

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

Så här löser 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 HubSpot-egenskapsfälttyper 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 rekommenderas att du kontrollerar den anpassade valideringsregeln som du har ställt in i Salesforce.

Egenskapsvärden

Exempel på fel som gäller egenskapsvärden

  • Strängen är för lång
  • Ogiltig e-postadress
  • Saknar obligatoriskt land
  • Ogiltigt värde
  • Tilldelning av ägare
  • Begränsat unikt värde
  • Saknar 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.

Så här löser du felen

För att lösa felet Sträng för lång, 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-postadress uppdaterar du formateringen av e-postadressen i Salesforce-posten som försöker synkronisera med HubSpot.

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

  • Det interna värdet för egenskapsalternativet Country i HubSpot måste matcha ett befintligt Country-alternativ i dina inställningar för State och Country/Territory i Salesforce.
  • State-värdet måste finnas som ett Available State/Province-alternativ för postens Country-värde i Salesforce. Dessutom måste det interna värdet för egenskapsalternativet State i HubSpot matcha ett befintligt State-alternativ i Salesforce.

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

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 de matchningsregler för deduplicering som du har konfigurerat i Salesforce.

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

Annat fel

Poster 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 posterna från Salesforce eller uppdatera en mappad egenskap.

Konfigurera aviseringar om synkroniseringsfel

  • Klicka på Salesforce i listan över anslutna appar.
  • Klicka på fliken Synkroniseringshälsa.
  • Under Synkroniseringsfel klickar du på Hantera aviseringar.
  • I dialogrutan växlar du reglaget Slå på aviseringar på.
  • Välj alternativknappen bredvid Omedelbart, Dagligen eller Veckovis för att ange frekvensen för dina aviseringar.
  • Klicka på Spara.