HubSpot Tietämyskanta

Hallitse Salesforce-integraation API-kutsuja ja synkronointivirheitä.

Kirjoittanut HubSpot Support | Nov 2, 2021 11:18:12 AM

HubSpot-Salesforce-integraatiossa saattaa esiintyä synkronointivirheitä, jotka estävät tietojen synkronoinnin. Voit tunnistaa ja korjata nämä synkronointivirheet Salesforce-integraation asetuksissa.

Säädä API-puhelujen rajaa

  • Napsauta yhdistettyjen sovellusten luettelossa Salesforce.
  • Näytä Synkronoinnin tila -välilehdellä API-puhelujen käyttö -osiossa, kuinka monta API-puhelua olet käyttänyt viimeisten 24 tunnin aikana. Salesforce rajoittaa -luku on määrä, jonka voit tehdä API-puheluita Salesforce-asetusten perusteella. Jos haluat säätää, kuinka monta puhelua voidaan jakaa HubSpotille, muokkaa Allocated to HubSpot -kenttää.

Näytä Salesforcen synkronointivirheet

  • Napsauta yhdistettyjen sovellusten luettelossa Salesforcea.
  • Näytä Sync Health (Synkronoinnin tila ) -välilehden Sync errors (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.

  • Voit tarkastella virheen lisätietoja napsauttamalla virhetyyppi-sarakkeessa olevaa info info-kuvaketta .
  • Jos haluat ryhtyä toimenpiteisiin yksittäisten tietueiden osalta, napsauta [#] tietuetta Vaikuttavat tietueet -sarakkeessa 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 luetteloon. Valitse ratkaistujen virheiden vasemmalla puolella oleva valintaruutu ja napsauta Uudelleen synkronointi.
  • Voit viedä virheet valitsemalla virheiden luettelon vasemmassa yläkulmassa Export errors (CSV) (Vie virheet (CSV )).


Salesforcen synkronointivirhetyypit

Associations

Esimerkkejä yhdistämisvirheistä

  • Assosiaatio-raja saavutettu
  • Odotetaan tilin synkronointia

Mitä virheet tarkoittavat

Tietueet eivät synkronoidu, koska ne on yhdistetty Salesforce-tileihin, joita ei ole vielä synkronoitu HubSpot-yhtiöihin, tai koska ne on yhdistetty tietueisiin, jotka ovat saavuttaneet HubSpotin tietueiden yhdistämisrajan.

Virheiden korjaaminen

Voit ratkaista Assosiaatio-raja saavutettu -virheen poistamalla osan assosioituneista tietueista tai assosioimalla ne toiseen Salesforce-tietueeseen ja jatkamalla sitten synkronointia.

Waiting for account to sync -virheen ratkaisemiseksi on suositeltavaa suorittaa Salesforce-tilien tuonti.

Mukautettu koodi

Esimerkkejä mukautetun koodin virheistä

  • Salesforce-automaatio
  • Yhteystiedon tunnus puuttuu
  • Salesforcen mukautetun kentän validointisääntö
  • Salesforce-virta

Mitä virheet tarkoittavat

Tietueet eivät synkronoidu Salesforce-tilisi automaation, virtojen tai validointisääntöjen aiheuttaman ongelman vuoksi.

Virheiden korjaaminen

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

Kaksoiskappaleet

Esimerkkejä päällekkäisvirheistä

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

Mitä virheet tarkoittavat

Salesforcen liidiä tai kontaktia ei voida synkronoida HubSpotiin, koska sähköpostiosoite on jo olemassa HubSpotin kontaktitietueessa tai Salesforcen deduplikointisäännön vuoksi.

Miten virheet ratkaistaan

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

Salesforcen kaksoissäännön virheen ratkaisemiseksi on suositeltavaa tarkistaa Salesforceen määritetyt deduplikointisääntöjen vastaavuussäännöt.

Käyttöoikeudet

Esimerkkejä käyttöoikeusvirheistä

  • Riittämätön pääsy tai puuttuva Salesforce-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 käyttöoikeuksia tarvittavaan kenttään tai objektiin Salesforceen.

Miten virheet ratkaistaan

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

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

Riittämätön Salesforce-käyttöoikeus -virhe ilmenee, kun Salesforce-integraation käyttäjä ei voi suorittaa toimintoa Salesforceen Salesforce-käyttöoikeuksiensa vuoksi. On suositeltavaa tarkistaa Salesforce-integraatiokäyttäjän käyttöoikeudet Salesforceen.

Poimintalistat

Esimerkkejä valintalistan virheistä

  • Puuttuva Salesforce-valintaluettelovaihtoehto
  • Epäsuhtainen osavaltio- tai maakohtainen arvo
  • Väärät vaihtoehdot
  • Salesforce-omistaja ei ole aktiivinen
  • Rajoitettu valintalistan arvo
  • Inaktiivinen tilaisuusvaihe
  • Salesforce-omistajia ei synkronoitu
  • Vaihtoehtojen raja ylitetty
  • Oletusmyyntiprosessi ei ole käytettävissä
  • Puuttuva tai virheellinen tilaisuusvaihe

Mitä virheet tarkoittavat

Tietueet eivät synkronoidu, koska HubSpotin ja Salesforcen poimintalistan kenttien arvot poikkeavat toisistaan. Näin voi tapahtua, kun poimintalistan arvo toisessa järjestelmässä ei täsmää minkään nykyisen arvon kanssa toisessa järjestelmässä, jos poimintalista on saavuttanut arvojen rajan tai jos välitetty arvo ei ole kelvollinen.

Virheiden ratkaiseminen

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

  • HubSpotissa olevan Maa-ominaisuusvaihtoehdon sisäisen arvon on vastattava Salesforcen osavaltio- ja maa-/aluevalintaluetteloasetuksissa olevaa Maavaihtoehtoa.
  • Valtion arvon on oltava olemassa Salesforcessa tietueen Maa-arvoon liittyvänä Available State/Province -vaihtoehtona. Lisäksi HubSpotissa olevan State-ominaisuusvaihtoehdon sisäisen arvon on vastattava Salesforcessa olevaa State-vaihtoehtoa.

Mismatched options -virheen ratkaisemiseksi on suositeltavaa, että päivität Salesforce-kentän vaihtoehtojen sisäisen/API-nimen vastaamaan HubSpotin ominaisuuden vaihtoehtojen sisäistä arvoa.

Jos haluat ratkaista Inactive Salesforce owner -virheen, määritä HubSpot-tietue uudelleen käyttäjälle, joka on aktiivinen käyttäjä Salesforcessa.

Rajoitettu poimintaluettelon arvo -virhe ilmenee, kun Salesforce-kentän arvosarja-asetuksessa määritetyt arvot on otettu käyttöön Rajoita poimintaluettelo Salesforce-kentän arvoihin. 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 opportunity stage -virhe tapahtuu, kun Salesforce-mahdollisuus, jonka tilaisuusvaihe on inaktiivinen, yrittää synkronoida HubSpotiin. Voit korjata tämän virheen muuttamalla tilaisuuden vaiheen Salesforceen aktiiviseksi tai siirtämällä tilaisuuden aktiiviseen vaiheeseen.

Jos haluat ratkaista Salesforce-omistajia ei synkronoitu -virheen, varmista, että Salesforce-käyttäjien käyttäjätyypiksi on Salesforce-järjestelmässä asetettu Standard, Power Partner tai Guest.

Vaihtoehtorajan ylitys -virheen ratkaisemiseksi on suositeltavaa, että poistat HubSpotista ja Salesforcesta ylimääräisiä ominaisuusvaihtoehtoja, 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 Salesforce-mahdollisuuksia yritetään synkronoida HubSpotiin puuttuvalla tietuetyypillä. Jos olet ottanut Record Types -tyypit käyttöön Salesforceen, mutta et käytä niitä, tai jos sinulla on Salesforce-mahdollisuuksia, joilla ei ole Record Type -tyyppiä, on suositeltavaa, että teet yhteistyötä Salesforcen kanssa kaikkien Record Types -tyyppien poistamiseksi käytöstä tai uuden Record Type -tyypin luomiseksi.

Puuttuva tai virheellinen tilaisuusvaihe -virheen korjaamiseksi varmista, että Salesforce-tilaisuusvaiheen arvo on olemassa HubSpot-putkessa.

Ominaisuuksien yhdistäminen

Esimerkkejä ominaisuuksien yhdistämisvirheistä

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

Mitä virheet tarkoittavat

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

Virheiden ratkaiseminen

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

Puuttuva Salesforce ID -virhe ilmenee, kun HubSpot yritti synkronoida muun arvon kuin olemassa olevan Salesforce ID:n Salesforce-viite-/lookup-kenttään.

Puuttuva Salesforce ID -virheen ratkaisemiseksi on suositeltavaa tarkistaa Salesforceen määrittämäsi mukautettu validointisääntö.

Ominaisuuksien arvot

Esimerkkejä ominaisuuksien arvoja koskevista virheistä

  • Liian pitkä merkkijono
  • Virheellinen sähköpostiosoite
  • 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 ominaisuusarvoja, jotka eivät ole kelvollisia. Nämä virheet edellyttävät yleensä, että yksittäiset tietueet, joita virhe koskee, päivitetään virheen korjaamiseksi.

Virheiden korjaaminen

Voit ratkaista merkkijono liian pitkä -virheen lyhentämällä kentän arvoa Salesforcessa tai HubSpotissa tai lisäämällä kentän merkkirajaa Salesforcessa.

Väärän sähköpostiosoitteen virheen korjaamiseksi päivitä sähköpostiosoitteen muotoilu siinä Salesforce-tietueessa, jota yritetään synkronoida HubSpotiin.

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

  • HubSpotissa olevan Maa-ominaisuusvaihtoehdon sisäisen arvon on vastattava Salesforcen osavaltio- ja maa-/aluevalintaluettelon asetuksissa olevaa Maa-vaihtoehtoa.
  • State-arvon on oltava olemassa Salesforce-tietueen Country-arvon Available State/Province -vaihtoehtona. Lisäksi HubSpotissa olevan State-ominaisuusvaihtoehdon sisäisen arvon on vastattava Salesforcessa olevaa State-vaihtoehtoa.

Väärän arvon virheen ratkaisemiseksi on suositeltavaa päivittää Salesforce-tietueen ominaisuuden arvo vastaamaan HubSpotin ominaisuuden arvolle asettamia vaatimuksia.

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

Rajoitettu yksilöllinen arvo -virheen ratkaisemiseksi on suositeltavaa tarkistaa Salesforceen määrittämäsi deduplikointisääntöjen vastaavuussäännöt.

Puuttuva vaadittu arvo -virheen ratkaisemiseksi lisää arvo Salesforce-tietueeseen mille tahansa ominaisuudelle, joka on merkitty HubSpotissa vaadituksi.

Muut

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

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

Synkronointivirheilmoitusten määrittäminen

  • Napsauta yhdistettyjen sovellusten luettelossa Salesforcea.
  • 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 valintaruutu Välittömästi, Päivittäin tai Viikoittain -kohdan vierestä.
  • Napsauta Tallenna.