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-anrop kan du se hur många API-anrop du har använt under de senaste 24 timmarna. Antalet begränsat av Salesforce är det antal 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. För att visa mer information om ett fel klickar du på informationsikonen info i kolumnen Feltyp .
6. Om du vill vidta åtgärder för enskilda poster klickar du på [#] poster i kolumnen Affected Records (Påverkade poster) och sedan på Actions (Åtgärder) > Create a temporary view of HubSpot records (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. Markera kryssrutan till vänster om alla lösta fel och klicka på Resync.
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å 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-anpassad fältvalideringsregel
• 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 med 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 du kontrollerar matchningsreglerna för deduplicering som är inställda i Salesforce.

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 som inte synkroniserats
• 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 felet " Oöverensstämmande värde 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/provins fö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år nä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 aktiv eller 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äljningsprocess otillgä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, 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 HubSpots 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 avvikelse 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 ogiltiga egenskapsvärden. Dessa fel kräver vanligtvis att de enskilda berörda posterna uppdateras för att korrigera felet.

Hur du åtgärdar 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/provins fö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 rekommenderas att du kontrollerar matchningsreglerna 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. Under Synkroniseringsfel klickar du på Hantera aviseringar.
5. I dialogrutan aktiverar du alternativet Aktivera aviseringar.
6. Välj alternativknappen bredvid Omedelbart, Dagligen eller Veckovis för att ställa in hur ofta du vill få aviseringar.
7. Klicka på Spara.