Siirry sisältöön
Huomaa: Tämän artikkelin käännös on tarkoitettu vain tiedoksi. Käännös on luotu automaattisesti käännösohjelmiston avulla, eikä sitä ole välttämättä tarkistettu. Näin ollen tämän artikkelin englanninkielistä versiota on pidettävä hallitsevana versiona, joka sisältää uusimmat tiedot. Voit tutustua siihen täällä.

Hallitse Salesforce-integraation API-kutsuja ja synkronointivirheitä.

Päivitetty viimeksi: 7 marraskuuta 2025

Saatavilla minkä tahansa seuraavan Tilauksen kanssa, paitsi jos toisin mainitaan:

HubSpot-Salesforce-integraatiossa voi ilmetä synkronointivirheitä, jotka estävät tietojen synkronoinnin. Voit tunnistaa ja korjata nämä synkronointivirheet Salesforce-integraatioasetuksissa.

Säädä API-kutsuja koskevaa rajoitusta

  1. Napsauta HubSpot-tilisi ylänavigointipalkin settings asetuskuvaketta. Siiry vasemman sivuvalikkopalkin kohtaan Integraatiot > Yhdistetyt sovellukset.
  2. Napsauta yhdistettyjen sovellusten luettelossa Salesforce.
  3. Siirry Synkronoinnin tila -välilehteen.
  4. API-kutsuja käytetty -osiossa voit tarkastella, kuinka monta API-kutsuja olet käyttänyt viimeisen 24 tunnin aikana. Salesforcen asettama rajoitus on API-kutsuja, joita voit tehdä Salesforce-asetusten perusteella. Voit säätää HubSpotille osoitettavien kutsujen määrää muokkaamalla HubSpotille osoitettu -kenttää.

Screenshot showing the API call use by the Salesforce integration in HubSpot.

Tarkastele Salesforce-synkronointivirheitä

  1. Napsauta HubSpot-tilisi ylänavigointipalkin settings asetuskuvaketta. Siiry vasemman sivuvalikkopalkin kohtaan Integraatiot > Yhdistetyt sovellukset.
  2. Napsauta yhdistettyjen sovellusten luettelossa Salesforce.
  3. Siirry Synkronoinnin tila -välilehteen.
  4. Synkronointivirheet-kohdassa voit tarkastella kunkin virhetyypin kortteja, joissa näkyy nykyisten virheiden määrä ja virheiden vaikutukset tietueisiin. Napsauta virhetyypin korttia nähdäksesi virheiden tiedot oikeassa paneelissa. Lisätietoja kunkin virhetyypin ja ratkaisusuositusten osalta.

Screenshot showing the Sync errors cards for each error type.

  1. Voit tarkastella virheen lisätietoja napsauttamalla virhetyyppisarakkeessa olevaa info - tiedon kuvaketta .
  2. Jos haluat suorittaa toiminnon yksittäisille tietueille, napsauta [#] tietueita Vaikuttavat tietueet -sarakkeessa ja napsauta sitten Toiminnot > Luo väliaikainen näkymä HubSpot-tietueista, jotta voit luoda suodatetun näkymän vaikuttavista tietueista.
  3. Kun olet korjannut virheet, palaa virheiden luetteloon. Valitse ratkaistujen virheiden vasemmalla puolella oleva valintaruutu ja napsauta Resync(Synkronoi uudelleen).
  4. Voit viedä virheet napsauttamalla virheiden luettelon vasemmassa yläkulmassa olevaa Vie virheet (CSV) -painiketta .
screenshot showing the button to export Salesforce sync errors in HubSpot

Salesforce-synkronointivirheiden tyypit

Yhdistykset

Esimerkkejä assosiaatioista

  • Yhdistämisraja saavutettu
  • Odotetaan tilin synkronointia

Virheiden merkitys

Tietueet eivät synkronoidu, koska ne on liitetty Salesforce-tileihin, joita ei ole vielä synkronoitu HubSpot-yrityksiin, tai koska ne on liitetty tietueisiin, jotka ovat saavuttaneet HubSpotin tietueiden liittämisrajan.

Virheiden korjaaminen

Voit korjata Yhdistämisraja saavutettu -virheen joko poistamalla joitakin yhdistettyjä tietueita tai yhdistämällä ne toiseen Salesforce-tietueeseen ja jatkamalla sitten synkronointia.

Voit korjata virheen Odotetaan tilin synkronointia suorittamalla Salesforce -tilien tuonnin.

Mukautettu koodi

Esimerkkejä mukautetun koodin virheistä

  • Salesforce-automaatio
  • Puuttuva yhteystunnus
  • Salesforce-mukautetun kentän vahvistussääntö
  • Salesforce-virtaus

Virheiden merkitys

Tietueita ei synkronoida Salesforce-tilisi automaatio-, virtaus- tai vahvistussääntöjen aiheuttaman ongelman vuoksi.

Virheiden ratkaiseminen

Koska nämä virheet ovat peräisin Salesforcesta, on suositeltavaa, että otat yhteyttä Salesforce-järjestelmänvalvojaan ongelman ratkaisemiseksi Salesforcen mukautetussa koodissa.

Kaksoiskappaleet

Esimerkkejä kaksoiskappaleiden virheistä

  • Sähköpostiosoite jo käytössä
  • Salesforce-kaksoiskappaleiden sääntö

Mitä virheet tarkoittavat

Salesforce-liidiä tai -yhteystietoa ei voi synkronoida HubSpotiin, koska sähköpostiosoite on jo olemassa HubSpot-yhteystietueessa tai Salesforcen päällekkäisyyksien poistamissäännön vuoksi.

Virheiden korjaaminen

Voit korjata virheen " Sähköpostiosoite jo käytössä " poistamalla sähköpostiosoitteen olemassa olevasta HubSpot-yhteystiedosta.

Salesforcen kaksoiskappaleiden sääntövirheen ratkaisemiseksi on suositeltavaa tarkistaa Salesforcessa määritetyt kaksoiskappaleiden poistamisen vastaavuussäännöt.

Käyttöoikeudet

Esimerkkejä käyttöoikeusvirheistä

  • Riittämätön käyttöoikeus tai puuttuva Salesforce-tietue
  • Salesforce-kentän käyttöoikeus
  • Riittämätön Salesforce-käyttöoikeus

Virheiden merkitys

HubSpotissa tehdyt muutokset eivät synkronoidu Salesforceen, koska yhdistetyssä käyttäjätilissä ei ole pääsyä tarvittavaan kenttään tai objektiin Salesforcessa.

Virheiden korjaaminen

Useimmissa tapauksissa virhe "Riittämätön käyttöoikeus tai puuttuva Salesforce-tietue " ilmenee, kun integraatio yrittää päivittää Salesforce-kenttää virheellisellä arvolla tai luoda virheellisen assosiaation.

Voit korjata Salesforce-kentän käyttöoikeusvirheen varmistamalla, että Salesforce-integraation käyttäjällä on luku- ja muokkausoikeudet kyseiseen kenttään Salesforcessa.

Virhe " Riittämätön pääsy Salesforceen " ilmenee, kun Salesforce-integraation käyttäjä ei voi suorittaa toimintoa Salesforcessa käyttäjäoikeuksiensa vuoksi. On suositeltavaa tarkistaa Salesforce-integraation käyttäjäoikeudet Salesforcessa.

Valintaluettelot

Esimerkkejä valintaluettelovirheistä

  • Puuttuva Salesforce-valintaluettelovaihtoehto
  • Väärin sovitettu osavaltion tai maan arvo
  • Epäyhtenäiset vaihtoehdot
  • Ei-aktiivinen Salesforce-omistaja
  • Rajoitettu valintalistan arvo
  • Ei-aktiivinen myyntimahdollisuuden vaihe
  • Salesforce-omistajat eivät ole synkronoituja
  • Vaihtoehtojen raja ylitetty
  • Oletusmyyntiprosessi ei käytettävissä
  • Puuttuva tai virheellinen myyntimahdollisuuden vaihe

Virheiden merkitys

Tietueita ei synkronoida, koska HubSpotin ja Salesforcen valintaluettelokenttien arvot eivät täsmää. Tämä voi tapahtua, kun yhden järjestelmän valintaluettelon arvo ei vastaa toisen järjestelmän nykyisiä arvoja, valintaluettelo on saavuttanut arvojen rajan tai välitetty arvo ei ole kelvollinen.

Virheiden korjaaminen

Voit korjata virheen, joka koskee valtion tai maan arvon epäsuhtaa, tarkistamalla, että seuraavat vaatimukset täyttyvät:

  • HubSpotin Country- ominaisuusvaihtoehdon sisäinen arvo on vastattava olemassa olevaa Country -vaihtoehtoa Salesforcen State- ja Country/Territory-valintaluettelon asetuksissa.
  • Osavaltion arvon on oltava käytettävissä oleva osavaltio-/maakunta-vaihtoehto Salesforcen tietueen Maa- arvolle. Lisäksi HubSpotin osavaltio-ominaisuus vaihtoehdon sisäisen arvon on vastattava olemassa olevaa osavaltio- vaihtoehtoa Salesforcessa.

Voit korjata vaihtoehdot eivät täsmää -virheen päivittämällä Salesforce-kentän vaihtoehtojen sisäisen/API-nimen vastaamaan HubSpotin ominaisuusvaihtoehtojen sisäistä arvoa.

Voit korjata virheen " Inactive Salesforce owner " (Passiivinen Salesforce-omistaja) määrittämällä HubSpot-tietueen uudelleen käyttäjälle, joka on aktiivinen käyttäjä Salesforcessa.

Rajoitettu valintaluettelon arvo -virhe ilmenee , kun Salesforcen kentässä on käytössä Rajoita valintaluettelo arvojoukon asetuksissa määriteltyihin arvoihin -asetus. Kun tämä asetus on käytössä Salesforcessa, arvo, jonka yrität synkronoida HubSpotista Salesforcen, on oltava vaihtoehtona Salesforcen valintaluettelossa. On suositeltavaa poistaa Salesforcen asetus Rajoita valintaluettelo arvojoukon määriteltyihin arvoihin käytöstä, jotta kaikki arvot voidaan synkronoida HubSpotista Salesforceen.

Virhe " Inactive opportunity stage" ( Ei-aktiivinen myyntimahdollisuus) ilmenee , kun Salesforce-myyntimahdollisuus, jonka vaihe on ei-aktiivinen, yritetään synkronoida HubSpotiin. Voit korjata tämän virheen muuttamalla myyntimahdollisuuden vaiheen Salesforcessa aktiiviseksi tai siirtämällä myyntimahdollisuuden aktiiviseen vaiheeseen.

Voit korjata virheen Salesforce-omistajat eivät synkronoidu varmistamalla, että Salesforce-käyttäjien käyttäjätyyppi on asetettu Standard, Power Partner tai Guest Salesforcessa.

Voit korjata virheen Option limit exceeded (Vaihtoehtojen raja ylitetty) poistamalla HubSpotista ja Salesforcesta ylimääräiset ominaisuusvaihtoehdot, joita tiimisi ei käytä. Varmista lisäksi, että kaikilla kartoitettujen ominaisuuksien kenttätyypit vastaavat toisiaan.

Useimmissa tapauksissa virhe " Oletusmyyntiprosessi ei käytettävissä " ilmenee, kun Salesforce-mahdollisuudet yrittävät synkronoitua HubSpotiin puuttuvan tietuetyypin kanssa. Jos olet ottanut tietuetyypit käyttöön Salesforcessa, mutta et käytä niitä, tai jos sinulla on Salesforce-mahdollisuuksia ilman tietuetyyppiä, suosittelemme, että poistat kaikki tietuetyypit käytöstä tai luot uuden tietuetyypin yhteistyössä Salesforcen kanssa.

Voit korjata puuttuvan tai virheellisen myyntimahdollisuuden vaiheen virheen varmistamalla, että Salesforcen myyntimahdollisuuden vaiheen arvo on olemassa HubSpotin myyntiputkessa.

Ominaisuuksien kartoitukset

Esimerkkejä ominaisuuksien määritysten virheistä

  • Tyyppien yhteensopimattomuus
  • Puuttuva Salesforce-tunnus
  • Virheellinen Salesforce-tunnus

Virheiden merkitys

Tietueita ei synkronoida, koska HubSpot-ominaisuuden ja Salesforce-kentän välisessä kartoituksessa on ristiriita. Tämä voi tarkoittaa, että ominaisuus- ja kenttätyypit eivät ole yhteensopivia, että ominaisuus tai kenttä ei enää ole olemassa tai että Salesforce-viitekentän kartoitus on luotava.

Virheiden korjaaminen

Voit korjata tyyppien yhteensopimattomuusvir heen varmistamalla, että HubSpotin ominaisuustyyppi ja Salesforcen kenttätyyppi ovat yhteensopivia. Lue lisää HubSpot-ominaisuuskenttätyypeistä, jotka voidaan synkronoida Salesforcen kanssa.

Puuttuva Salesforce-tunnus -virhe ilmenee, kun HubSpot yritti synkronoida muun arvon kuin olemassa olevan Salesforce-tunnuksen Salesforcen viite-/hakukenttään.

Virheen " Virheellinen Salesforce-tunnus " ratkaisemiseksi on suositeltavaa tarkistaa Salesforcessa määrittämäsi mukautetun vahvistussäännön.

Ominaisuusarvot

Esimerkkejä ominaisuusarvojen virheistä

  • Liian pitkä merkkijono
  • Virheellinen sähköpostiosoite
  • Vaadittu maa puuttuu
  • Virheellinen arvo
  • Omistajan määritys
  • Rajoitettu yksilöllinen arvo
  • Puuttuva pakollinen arvo

Virheiden merkitys

Tietueita ei synkronoida HubSpotin ja Salesforcen välillä, koska ne sisältävät virheellisiä ominaisuusarvoja. Nämä virheet edellyttävät yleensä kyseisten tietueiden päivittämistä virheen korjaamiseksi.

Virheiden korjaaminen

Voit korjata virheen "String too long " (Merkkijono li ian pitkä) lyhentämällä kentän arvoa Salesforcessa tai HubSpotissa tai lisäämällä kentän merkkimäärän rajaa Salesforcessa.

Korjaa virhe "Virheellinen sähköpostiosoite " päivittämällä sähköpostiosoitteen muotoilu Salesforcen tietueessa, jota yritetään synkronoida HubSpotin kanssa.

Voit korjata virheen " Puuttuva vaadittu maa " tarkistamalla, että seuraavat vaatimukset täyttyvät:

  • HubSpotin Country- ominaisuusvaihtoehdon sisäinen arvo on vastattava olemassa olevaa Country -vaihtoehtoa Salesforcen State- ja Country/Territory-valintaluettelon asetuksissa.
  • State -arvon on oltava olemassa Available State/Province -vaihtoehtona tietueen Country- arvolle Salesforcessa. Lisäksi HubSpotin State-ominaisuusvai htoehdon sisäinen arvo on vastattava olemassa olevaa State- vaihtoehtoa Salesforcessa.

Voit korjata virheen " Virheellinen arvo " päivittämällä Salesforce-tietueen ominaisuusarvon vastaamaan HubSpotin vaatimuksia ominaisuusarvolle.

Useimmissa tapauksissa omistajan määritysvirhe ilmenee, kun HubSpot-toiminto synkronoidaan Salesforceen Salesforce-tehtävänä ja HubSpot yrittää määrittää tehtävän Salesforce-jonon omistajalle.

Rajoitettu yksilöllinen arvo -virheen korjaamiseksi on suositeltavaa tarkistaa Salesforcessa määrittämäsi päällekkäisyyksien poistamista koskevat säännöt.

Voit korjata puuttuvan pakollisen arvon virheen lisäämällä arvon Salesforce-tietueeseen kaikille ominaisuuksille , jotka on merkitty pakollisiksi HubSpotissa.

Muu

Tietueita ei synkronoida tuntemattoman virheen vuoksi. Ota yhteyttä HubSpot-tukeen, jos tarvitset lisäapua näiden virheiden korjaamisessa.

Huomaa: on mahdollista synkronoida kerralla 100 Salesforce-virhettä. Jos haluat synkronoida yli 100 virhettä, tuo tietueet Salesforcesta tai päivitä kartoitettu ominaisuus.

Synkronointivirheiden ilmoitusten määrittäminen

  1. Napsauta HubSpot-tilisi ylänavigointipalkin settings asetuskuvaketta. Siiry vasemman sivuvalikkopalkin kohtaan Integraatiot > Yhdistetyt sovellukset.
  2. Napsauta yhdistettyjen sovellusten luettelossa Salesforce.
  3. Siirry Synkronoinnin tila -välilehteen.
  4. Napsauta Synkronointivirheet-kohdassa Hallitse ilmoituksia.
  5. Kytke valintaikkunassa Ilmoitukset -kytkin päälle.
  6. Valitse ilmoitusten tiheyden asetukseksi Välittömästi, Päivittäin tai Viikoittain.
  7. Napsauta Tallenna.
Oliko tästä artikkelista apua?
Tätä lomaketta käytetään vain dokumentaation palautteeseen. Lue, miten saat apua HubSpotin kanssa.