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 integraatio puhelut ja synkronointivirheitä

Päivitetty viimeksi: 27 toukokuuta 2025

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

Marketing Hub   Professional , Enterprise
Sales Hub   Professional , Enterprise
Service Hub   Professional , Enterprise
Operations Hub   Professional , Enterprise
Content Hub   Professional , Enterprise

integraatio saattaa esiintyä synkronointivirheitä, jotka estävät tietojen synkronoinnin. Voit tunnistaminen ja korjata nämä synkronointivirheet integraatio asetuksissa.

Säädä API-kutsu raja

  • Napsauta HubSpot-tilisi ylänavigointipalkin settings asetuskuvaketta. Siiry vasemman sivuvalikkopalkin kohtaan Integraatiot > Yhdistetyt sovellukset.
  • Napsauta yhdistettyjen sovellukset luettelo Salesforce.
  • Näytä Sync Health (Synkronoinnin tila ) -välilehdellä API-kutsu käyttö -osiossa, kuinka monta puhelut olet käyttänyt viimeisten 24 tunnin aikana. Salesforce rajoittaa -luku on määrä voit tehdä puhelut Salesforce-asetusten perusteella. Jos haluat säätää, kuinka monta puhelut voidaan jakaa HubSpotille, muokkaa Allocated to HubSpot -kenttää.

sync-health-api-call-use

Näytä Salesforcen synkronointivirheet

  • Napsauta HubSpot-tilisi ylänavigointipalkin settings asetuskuvaketta. Siiry vasemman sivuvalikkopalkin kohtaan Integraatiot > Yhdistetyt sovellukset.
  • Napsauta yhdistettyjen sovellukset luettelo Salesforce.
  • Näytä Synkronoinnin tila -välilehden Synkronointivirheet-kohdassa kunkin virhetyypin kortit, joissa on nykyisten virheiden ja vaikutuksen kohteena olevien tietueiden määrä. Napsauta virhetyyppikorttia nähdäksesi virheiden yksityiskohdat oikeassa paneelissa. Lisätietoja kustakin virhetyypistä ja ratkaisusuosituksista.

sync-health-sync-errors

  • Voit tarkastella virheen lisätietoja napsauttamalla virhetyyppi-sarakkeessa olevaa info info-kuvaketta .
  • Jos haluat ryhtyä toimenpiteisiin yksittäisten tietueiden osalta, napsauta [#] tietuetta sarakkeessa Vaikuttavat tietueet ja valitse sitten Toiminnot > Luo väliaikainen näkymä HubSpot-tietueista luodaksesi suodatetun näkymän vaikutuksen kohteena olevista tietueista.
  • Kun olet ratkaissut virheet, palaa virheiden luettelo. Valitse ratkaistujen virheiden vasemmalla puolella oleva valintaruutu ja napsauta Uudelleen synkronointi.
  • Voit vienti virheet valitsemalla virheiden luettelo vasemmassa yläkulmassa Vienti errors (CSV) ( Vie virheet (CSV )).
screenshot showing the button to export Salesforce sync errors in HubSpot

Salesforcen synkronointivirhetyypit

Yhdistykset

Esimerkkejä assosiaatioiden virheistä

  • Yhteys raja saavutettu
  • Odotetaan tili synkronointia

Mitä virheet tarkoittavat

Tietueet eivät synkronoidu, koska ne on yhdistetty Salesforce-tileihin, joita ei ole vielä synkronoitu Yritykset, tai koska ne on yhdistetty tietueisiin, jotka ovat saavuttaneet HubSpotin tietueen yhteys.

Kuinka ratkaista virheet

Voit ratkaista Yhteys limit reached -virheen poistamalla joitakin yhdistettyjä tietueita tai liittää ne toiseen tietue ja jatkamalla sitten synkronointia.

tili synkronointia odottavan virheen korjaamiseksi on suositeltavaa suorittaa Salesforce-tilientuonti.

Mukautettu koodi

Esimerkkejä mukautetun koodin virheistä

  • automaatio
  • Puuttuva yhteystieto
  • Salesforcen mukautetun kentän validointisääntö
  • Salesforce-virtaus

Mitä virheet tarkoittavat

Tietueet eivät synkronoidu tili automaatio, virtojen tai validointisääntöjen aiheuttaman ongelman vuoksi.

Kuinka ratkaista virheet

Koska nämä virheet ovat peräisin Salesforcesta, on suositeltavaa, että teet yhteistyötä Salesforcen ylläpitäjän kanssa ratkaistaksesi ongelman Salesforcen mukautetussa koodissasi.

Kaksoiskappaleet

Esimerkkejä päällekkäisvirheistä

  • Sähköposti jo käytössä
  • Salesforcen kaksoissääntö

Mitä virheet tarkoittavat

Salesforcen liidi tai yhteystieto ei voida synkronoida HubSpotiin, koska sähköposti on jo olemassa HubSpotin yhteystietotietue tai Salesforcen kaksoiskappaleiden poisto vuoksi.

Kuinka ratkaista virheet

Voit ratkaista Sähköposti on jo käytössä -virheen poistamalla sähköposti olemassa olevasta yhteystieto.

Salesforcen kaksoissääntövirheen ratkaisemiseksi on suositeltavaa tarkistaa Salesforceen määritetyt kaksoiskappaleiden poisto.

Luvat

Esimerkkejä käyttöoikeusvirheistä

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

Mitä virheet tarkoittavat

HubSpotissa tehtyjä muutoksia ei voida synkronoida Salesforceen, koska yhdistetyllä käyttäjällä ei ole pääsyä tarvittavaan kenttään tai objekti Salesforcessa.

Kuinka ratkaista virheet

Useimmissa tapauksissa Riittämätön pääsy tai puuttuva tietue -virhe ilmenee, kun integraatio yrittää päivittää Salesforce-kenttää väärällä arvolla tai luoda väärän yhteys.

Voit ratkaista Salesforce-kentän käyttöoikeusvirheen varmistamalla, että integraatio käyttäjällä on Salesforce-kentän luku- ja muokkausoikeudet.

Riittämätön Salesforce-käyttöoikeus -virhe ilmenee, kun integraatio käyttäjä ei voi suorittaa toimintoa Salesforcessa Salesforcen käyttöoikeuksiensa vuoksi. On suositeltavaa, että tarkistat integraatio käyttäjän oikeudet Salesforceen.

Poimintalistat

Esimerkkejä valintalistan virheistä

  • Puuttuva Salesforce-valintaluettelovaihtoehto
  • Epäsopiva osavaltion tai maan arvo
  • Väärät vaihtoehdot
  • Salesforce-omistaja ei ole aktiivinen
  • Rajoitettu valintalistan arvo
  • Inaktiivinen mahdollisuus
  • Salesforce-omistajia ei synkronoitu
  • Vaihtoehtojen raja ylitetty
  • Oletusmyyntiprosessi ei ole käytettävissä
  • Puuttuva tai virheellinen mahdollisuus

Mitä virheet tarkoittavat

Tietueet eivät synkronoidu, koska HubSpotin ja Salesforcen valintalista-kenttien arvojen välillä on ristiriita. Näin voi tapahtua, kun poimintaluettelon arvo toisessa järjestelmässä ei vastaa toisen järjestelmän nykyisiä arvoja, jos poimintaluettelo on saavuttanut arvorajan tai jos välitetty arvo ei ole kelvollinen.

Kuinka ratkaista virheet

Mismatched state or country value -virheen korjaamiseksi on suositeltavaa tarkistaa, että seuraavat vaatimukset täyttyvät:

  • HubSpotin ominaisuus sisäisen arvon on vastattava Salesforcen osavaltio- ja maa-/aluevalintaluettelon asetuksissa olevaa Maavaihtoehtoa.
  • Valtion arvon on oltava olemassa Salesforcen tietue Maa-arvon Available State/Province -vaihtoehtona. Lisäksi HubSpotissa olevan ominaisuus sisäisen arvon on vastattava Salesforcessa olevaa State-vaihtoehtoa.

Mismatched options -virheen korjaamiseksi on suositeltavaa päivittää Salesforce-kentän vaihtoehtojen API vastaamaan HubSpotin ominaisuus vaihtoehtojen sisäistä arvoa.

Jos haluat korjata Salesforce-omistajan toimimattomuus -virheen, määritä tietue uudelleen käyttäjälle, joka on aktiivinen käyttäjä Salesforcessa.

Rajoitettu valintalistan arvo -virhe ilmenee, kun Salesforce-kentän arvosarja-asetuksessa määritetyt arvot on rajoitettu valintalistaan. Kun tämä on otettu käyttöön Salesforceen, arvon, jota yrität synkronoida HubSpotista Salesforceen, on oltava vaihtoehtona Salesforcen valintalistassa. On suositeltavaa, että otat pois käytöstä Rajoita valintaluettelo Salesforcen arvojoukkoasetuksessa määritettyihin arvoihin, jotta kaikki arvot voidaan synkronoida HubSpotista Salesforceen.

Inactive mahdollisuus stage -virhe tapahtuu, kun mahdollisuus, jonka mahdollisuus on inaktiivinen, yrittää synkronoida HubSpotiin. Voit korjata tämän virheen muuttamalla mahdollisuus vaiheen Salesforceen aktiiviseksi tai siirtämällä mahdollisuus aktiiviseen vaiheeseen.

Jos haluat ratkaista Salesforce-omistajat eivät ole synkronoitu -virheen, varmista, että Salesforce-käyttäjien käyttäjätyypiksi on määritetty Salesforcessa Standard, Power Partner tai Guest.

Vaihtoehtorajoitus ylitetty -virheen korjaamiseksi on suositeltavaa poistaa HubSpotista ja Salesforcesta ylimääräisiä ominaisuus, joita tiimisi ei käytä. Varmista lisäksi, että kaikilla kartoitetuilla ominaisuuksilla on vastaavat kenttätyypit.

Useimmissa tapauksissa Default sales process unavailable -virhe ilmenee, kun mahdollisuudet yritetään synkronoida HubSpotiin puuttuvan Tietue kanssa. Jos olet ottanut Tietue Types -tyypit käyttöön Salesforceen, mutta et käytä niitä, tai jos sinulla on mahdollisuudet ilman Tietue Type -tyyppiä, on suositeltavaa, että teet yhteistyötä Salesforcen kanssa kaikkien Tietue Types -tyyppien poistamiseksi käytöstä tai uuden Tietue Type -tyypin luomiseksi.

Puuttuva tai virheellinen mahdollisuus -virheen korjaamiseksi varmista, että Salesforcen mahdollisuus arvo on olemassa myyntiputki.

Ominaisuus

Esimerkkejä ominaisuus yhdistämisvirheistä

  • Tyypin epäsuhta
  • Puuttuva Salesforce ID
  • Virheellinen Salesforce-tunnus

Mitä virheet tarkoittavat

Tietueet eivät synkronoidu, koska ominaisuus ja Salesforce-kentän välillä on ristiriita. Tämä voi tarkoittaa, että ominaisuus ja kentän tyypit eivät ole yhteensopivia, että ominaisuus tai kenttää ei enää ole olemassa tai että on luotava kenttäkartoitus.

Kuinka ratkaista virheet

Voit ratkaista Type mismatch -virheen varmistamalla, että HubSpotin ominaisuus ja Salesforcen kenttätyyppi ovat yhteensopivia. Lisätietoja HubSpotin ominaisuus kenttätyypeistä, jotka voidaan synkronoida Salesforceen.

Puuttuva Salesforce ID -virhe ilmenee, kun HubSpot yritti synkronoida muun kuin olemassa olevan Salesforce ID:n arvon Salesforcen viite- tai hakukenttään.

Väärän Salesforce-tunnuksen virheongelman ratkaisemiseksi on suositeltavaa tarkistaa Salesforceen määrittämäsi mukautettu validointisääntö.

Ominaisuus arvot

Esimerkkejä ominaisuus

  • Merkkijono liian pitkä
  • Virheellinen sähköposti
  • Puuttuu vaadittu maa
  • Virheellinen arvo
  • Omistajan määritys
  • Rajoitettu yksilöllinen arvo
  • Puuttuva vaadittu arvo

Mitä virheet tarkoittavat

Tietueet eivät synkronoidu HubSpotin ja Salesforcen välillä, koska ne sisältävät ominaisuus arvoja, jotka eivät ole voimassa. Nämä virheet edellyttävät yleensä, että yksittäiset tietueet, joita virhe koskee, päivitetään virheen korjaamiseksi.

Kuinka ratkaista virheet

Jos haluat korjata merkkijono liian pitkä -virheen, lyhennä kentän arvoa Salesforce- tai HubSpot-ohjelmassa tai lisää kentän merkkimäärää Salesforce-ohjelmassa.

Voit korjata Virheellinen sähköposti -virheen päivittämällä sähköposti muotoilun tietue, jota yritetään synkronoida HubSpotiin.

Puuttuva vaadittu maa -virheen korjaamiseksi on suositeltavaa tarkistaa, että seuraavat vaatimukset täyttyvät:

  • HubSpotin ominaisuus sisäisen arvon on vastattava Salesforcen osavaltio- ja maa-/aluevalintaluettelon asetuksissa olevaa Maavaihtoehtoa.
  • Valtion arvon on oltava olemassa Salesforcen tietue Maa-arvon Available State/Province -vaihtoehtona. Lisäksi HubSpotissa olevan ominaisuus sisäisen arvon on vastattava Salesforcessa olevaa State-vaihtoehtoa.

Väärän arvon virheen korjaamiseksi on suositeltavaa, että päivität tietue ominaisuus arvon vastaamaan HubSpotin vaatimuksia ominaisuus arvolle.

Useimmissa tapauksissa Omistajan määritys -virhe ilmenee, kun HubSpotin toiminta synkronoidaan Salesforceen tehtävä ja HubSpot yrittää määrittää tehtävä Salesforce-jonon omistajalle.

Rajoitettu yksilöllinen arvo -virheen ratkaisemiseksi on suositeltavaa tarkistaa Salesforceen määrittämät kaksoiskappaleiden poisto.

Puuttuva vaadittu arvo -virheen korjaamiseksi lisää arvo tietue mille tahansa ominaisuus, joka on merkitty vaadituksi HubSpotissa.

Muut

Tietueet eivät synkronoidu tuntemattoman virheen vuoksi. yhteystieto HubSpotin tukeen saadaksesi lisäapua näihin virheisiin.

Huomaa: on mahdollista synkronoida 100 Salesforce-virhettä kerrallaan. Jos haluat synkronoida yli 100 virhettä, tuonti tietueet Salesforce-tietueesta tai päivitä yhdistetty ominaisuus.

Määritä synkronointivirheilmoitukset

  • Napsauta HubSpot-tilisi ylänavigointipalkin settings asetuskuvaketta. Siiry vasemman sivuvalikkopalkin kohtaan Integraatiot > Yhdistetyt sovellukset.
  • Napsauta yhdistettyjen sovellukset luettelo Salesforce.
  • Napsauta Sync Health -välilehteä.
  • Napsauta Sync errors (Synkronointivirheet) -kohdassa Manage notifications (Hallitse ilmoituksia).
  • Kytke valintaikkunassa Ota ilmoitukset käyttöön -kytkin päälle.
  • Määritä ilmoitusten taajuus valitsemalla valintanappi Välittömästi, Päivittäin tai Viikoittain -kohdan vieressä.
  • Napsauta Tallenna.

sync-health-error-notifications

Oliko tästä artikkelista apua?
Tätä lomaketta käytetään vain dokumentaation palautteeseen. Lue, miten saat apua HubSpotin kanssa.