Hallitse Salesforce-integraation API-kutsuja ja synkronointivirheitä.

HubSpotin ja Salesforcen integroinnissa saattaa ilmetä synkronointivirheitä, jotka estävät tietojen synkronoinnin. Voit tunnistaa ja korjata nämä synkronointivirheet Salesforcen integrointiasetuksissa.

Säädä API-kutsujen rajaa

1. Napsauta HubSpot-tilisi ylänavigointipalkin asetuskuvaketta. Siiry vasemman sivuvalikkopalkin kohtaan Integraatiot > Yhdistetyt sovellukset.
2. Napsauta liitettyjen sovellusten luettelossaSalesforce. 
3. Siirry Tietojen synkronointi-välilehteen. 
4. Tarkista Synkronoinnin tila -välilehden API-kutsujen käyttö -osiosta, kuinka monta API-kutsua olet käyttänyt viimeisen 24 tunnin aikana.Salesforce-rajoitus -luku on niiden API-kutsujen määrä, jotka voit tehdä Salesforce-asetustesi perusteella. Voit säätää HubSpotille osoitettavien kutsujen määrää muokkaamalla HubSpotille osoitettu -kenttää. 

Tarkastele Salesforce-synkronointivirheitä

1. Napsauta HubSpot-tilisi ylänavigointipalkin asetuskuvaketta. Siiry vasemman sivuvalikkopalkin kohtaan Integraatiot > Yhdistetyt sovellukset.
2. Napsauta liitettyjen sovellusten luettelossaSalesforce. 
3. Siirry Data sync-välilehteen. 
4. Synkronoinnin tila -välilehdenSynkronointivirheet-osiossa voit tarkastella kunkin virhetyypin kortteja, joissa näkyy nykyisten virheiden määrä ja virheiden vaikutukset tietueisiin. Napsauta virhetyypin korttia nähdäksesi virheiden tiedot oikeanpuoleisessa paneelissa. Lue lisää kustakin virhetyypistä ja ratkaisuehdotuksista. 

5. Voit tarkastella virheen lisätietoja napsauttamalla Virhetyyppi-sarakkeen info-kuvaketta .
6. Jos haluat suorittaa toimia yksittäisille tietueille, 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. 
7. Kun olet korjannut virheet, palaa virhelistaan. Valitse korjattujen virheiden vasemmalla puolella olevavalintaruutu ja napsauta Synkronoi uudelleen.
8. Voit viedä virheet napsauttamalla Virheiden luettelon vasemmassa yläkulmassa olevaa Vie virheet (CSV) -painiketta.

Salesforce-synkronointivirheiden tyypit

Yhdistykset

Esimerkkejä liitännäisvirheistä 

• Yhdistämisraja saavutettu
• Odotetaan tilin synkronointia

Mitä virheet tarkoittavat

Tietueita ei synkronoida, 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 virheen ”Yhdistämisraja saavutettu”joko poistamalla joitakin yhdistettyjä tietueita tai yhdistämällä ne toiseen Salesforce-tietueeseen ja jatkamalla sitten synkronointia.

Voit korjata virheen ”Odotetaan tilin synkronointia ” tuomalla Salesforce -tilit järjestelmään. 

Mukautettu koodi

Esimerkkejä mukautetun koodin virheistä 

• Salesforce-automaatio
• Yhteystiedon tunnus puuttuu
• Salesforcen mukautetun kentän vahvistussääntö
• Salesforce-virtaus

Mitä virheet tarkoittavat

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

Virheiden korjaaminen

Kaksoiskappaleet

Esimerkkejä kaksoiskappalevirheistä

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

Mitä virheet tarkoittavat

Salesforce-liidiä tai -yhteyshenkilöä ei voi synkronoida HubSpotin kanssa, koska sähköpostiosoite on jo olemassa HubSpotin yhteyshenkilötietueessa tai Salesforcen päällekkäisyyksien poistosäännön vuoksi. 

Virheiden korjaaminen

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

Salesforce-kaksoiskappaleiden sääntövirheen ratkaisemiseksi on suositeltavaa, että Salesforce-järjestelmänvalvoja tarkistaa Salesforcessa määritetyt kaksoiskappaleiden poistamista koskevat säännöt. Yhdistä, päivitä tai poista sitten ristiriitaiset Salesforce-tietueet tai muokkaa kaksoiskappaleiden poistamista koskevaa sääntöä Salesforcessa ennen kuin yrität synkronoida uudelleen HubSpotissa.

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

Mitä virheet tarkoittavat

HubSpotissa tehdyt muutokset eivät voi synkronoitua Salesforceen, koska yhdistetyllä käyttäjällä ei ole pääsyä tarvittavaan kenttään tai objektiin Salesforcessa.

Virheiden korjaaminen

Useimmissa tapauksissa virhe ”Insufficient access” tai ”missing Salesforce record” ilmenee, kun integraatio yrittää päivittää Salesforce-kentän virheellisellä arvolla tai luoda virheellisen liitännän. 

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 ”Insufficient Salesforce access” 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än käyttöoikeudet Salesforcessa.

Valintaluettelot

Esimerkkejä valintaluettelovirheistä

• Puuttuva Salesforce-valintaluettelovaihtoehto
• Epäyhtenäinen osavaltio- tai maakohtainen arvo
• Vaihtoehdot eivät täsmää
• Salesforce-omistaja ei ole aktiivinen
• Rajoitettu valintaluettelon arvo
• Ei-aktiivinen myyntimahdollisuuden vaihe
• Salesforce-omistajia ei ole synkronoitu
• Vaihtoehtojen raja ylitetty
• Oletusmyyntiprosessi ei käytettävissä
• Mahdollisuuden vaihe puuttuu tai on virheellinen

Mitä virheet tarkoittavat

Tietueita ei synkronoida HubSpotin ja Salesforcen valintaluettelokenttien arvojen välisten eroavaisuuksien vuoksi. Tämä voi tapahtua, kun yhden järjestelmän valintaluettelon arvo ei vastaa toisen järjestelmän nykyisiä arvoja, jos valintaluettelo on saavuttanut arvojen rajan tai jos välitetty arvo ei ole kelvollinen.

Virheiden korjaaminen

Voit korjata virheen, joka liittyy valtion tai maan arvon ristiriitaan, tarkistamalla, että seuraavat vaatimukset täyttyvät:

• HubSpotin Country -ominaisuusvaihtoehdon sisäisen arvon on vastattava olemassa olevaa Country- vaihtoehtoa Salesforcen osavaltio- ja maa/alue-valintaluettelon asetuksissa. 
• Osavaltion arvon on oltava käytettävissä oleva osavaltio-/maakunta-vaihtoehtotietueen Maan arvolle Salesforcessa. Lisäksi HubSpotin State-ominaisuus vaihtoehdon sisäisen arvon on vastattava olemassa olevaa State-vaihtoehtoa Salesforcessa. 

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

Voit korjata virheen ”Salesforce-omistaja ei ole aktiivinen ” 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än asetuksessa Rajoita valintaluettelo arvokokonaisuudessa määriteltyihin arvoihin on valittuna. Kun tämä on valittuna Salesforcessa, arvon, jota yrität synkronoida HubSpotista Salesforceen, on oltava vaihtoehtona Salesforcen valintaluettelossa. On suositeltavaa poistaa käytöstä Salesforce-asetus Rajoita valintaluetteloa arvokokonaisuudessa määriteltyihin arvoihin, jotta kaikki arvot voidaan synkronoida HubSpotista Salesforceen. 

Virhe ”Inactive opportunity stage ” ( Ei-aktiivinen myyntimahdollisuudenvaihe) ilmenee , kun Salesforce-myyntimahdollisuus, jonka vaihe on ei-aktiivinen, yrittää synkronoitua HubSpotin kanssa. Voit korjata tämän virheen muuttamalla myyntimahdollisuuden vaiheen Salesforcessa aktiiviseksitai siirtämällä myyntimahdollisuuden aktiiviseen vaiheeseen. 

Voit korjata virheen ”Salesforce-omistajia ei synkronoitu ” varmistamalla, että Salesforce-käyttäjien käyttäjätyypiksi on määritetty Standard, Power Partner tai Guest. 

Voit korjata virheen ”Option limit exceeded” poistamalla HubSpotista ja Salesforcesta ylimääräiset ominaisuusvaihtoehdot, joita tiimisi ei käytä. Varmista lisäksi, että kaikilla kartoitetuilla ominaisuuksilla on vastaavat kenttätyypit. 

Useimmissa tapauksissa virhe ”Oletusmyyntiprosessi ei käytettävissä ” ilmenee, kun Salesforce-myyntimahdollisuudet yrittävät synkronoitua HubSpotin kanssa puuttuvan tietuetyypin vuoksi. Jos olet ottanut tietuetyypit käyttöön Salesforcessa, mutta et käytä niitä, tai jos sinulla on Salesforce-myyntimahdollisuuksia ilman tietuetyyppiä, on suositeltavaa poistaa kaikki tietuetyypit käytöstä tai luoda uusi tietuetyyppi yhteistyössä Salesforcen kanssa. 

Voit ratkaista virheen ”Mahdollisuuden vaihe puuttuu tai on virheellinen ” varmistamalla, että Salesforce-mahdollisuuden vaiheen arvo on olemassa HubSpot-putkessa.

Salesforce-tehtäväkentän virheiden osalta vertaa Salesforcen Tehtävän prioriteetti-, Tila- tai Tyyppi-arvoja vastaaviin tehtävän ominaisuusvaihtoehtoihin HubSpotissa. Tehtävän prioriteetti tukee vain arvoja Korkea, Keskitaso, Matala ja Ei mitään. Päivitä Tila- ja Tyyppi-arvot Salesforcessa vastaamaan tarkalleen HubSpotin käytettävissä olevia vaihtoehtoja tai lisää vastaavat vaihtoehdot HubSpotissa.

Ominaisuusmääritykset

Esimerkkejä ominaisuusmääritysten virheistä 

• Tyyppien yhteensopimattomuus
• Salesforce-tunnus puuttuu
• Virheellinen Salesforce-tunnus

Mitä virheet tarkoittavat

Tietueita ei synkronoida HubSpot-ominaisuuden ja Salesforce-kentän välisen kartoituksen ristiriidan vuoksi. Tämä voi tarkoittaa, että ominaisuus- ja kenttätyypit eivät ole yhteensopivia, että ominaisuutta tai kenttää ei enää ole olemassa tai että Salesforce-viitekentän kartoitus on luotava.

Virheiden korjaaminen 

Voit korjata tyyppien yhteensopimattomuusvirheen varmistamalla, että HubSpotin ominaisuustyyppi ja Salesforcen kenttätyyppi ovat yhteensopivia. Lue lisää HubSpotin ominaisuuskenttätyypeistä, jotka voidaan synkronoida Salesforceen. 

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

Voit korjata virheen ”Invalid Salesforce ID ” tarkistamalla Salesforcessa määrittämäsi mukautetun vahvistussäännön. 

Ominaisuusarvot

Esimerkkejä ominaisuusarvojen virheistä

• Merkkijono liian pitkä
• Virheellinen sähköpostiosoite
• Vaadittu maa puuttuu
• Virheellinen arvo
• Omistajan määritys
• Rajoitettu yksilöllinen arvo
• Pakollinen arvo puuttuu

Mitä virheet tarkoittavat

Tietueita ei synkronoida HubSpotin ja Salesforcen välillä, koska ne sisältävät virheellisiä ominaisuusarvoja. Nämä virheet edellyttävät yleensä, että kyseiset tietueet päivitetään virheen korjaamiseksi.

Virheiden korjaaminen

Voit korjata virheen ”Merkkijono liian pitkä ” lyhentämällä kentän arvoa Salesforcessa tai HubSpotissa tai lisäämällä kentän merkkimäärää Salesforcessa. 

Voit korjata virheen ”Invalid email ” päivittämällä sähköpostiosoitteen muotoilun Salesforce-tietueessa, jota yritetään synkronoida HubSpotin kanssa.

Korjaa virhe ”Puuttuva pakollinen maa ” tarkistamalla, että seuraavat vaatimukset täyttyvät:

• HubSpotin Country -ominaisuusvaihtoehdon sisäisen arvon on vastattava olemassa olevaa Country- vaihtoehtoa Salesforcen osavaltio- ja maa/alue-valintaluettelon asetuksissa. 
• Osavaltion arvon on oltava olemassa käytettävissä olevana osavaltio-/maakuntavaihtoehtonatietueen Country- arvolle Salesforcessa. Lisäksi HubSpotin State-ominaisuus vaihtoehdon sisäisen arvon on vastattava olemassa olevaa State-vaihtoehtoa Salesforcessa. 

Voit korjata virheen ”Arvo ei kelpaa ” päivittämällä Salesforce-tietueen ominaisuusarvon vastaamaan HubSpotin vaatimuksia ominaisuusarvolle. 

Useimmissa tapauksissa Omistajan määritys -virhe 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ä Salesforce-tietueeseen arvon 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 kanssa.

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

Määritä synkronointivirheilmoitukset

1. Napsauta HubSpot-tilisi ylänavigointipalkin asetuskuvaketta. Siiry vasemman sivuvalikkopalkin kohtaan Integraatiot > Yhdistetyt sovellukset.
2. Napsauta liitettyjen sovellusten luettelossaSalesforce. 
3. Siirry Data sync-välilehdelle. 
4. Napsauta Synkronoinnin tila -välilehden Synkronointivirheet-osiossa Hallitse ilmoituksia. 
5. Kytke valintaikkunassaIlmoitukset-kytkin päälle. 
6. ValitseHeti,Päivittäin taiViikoittain -valintanappi asettaaksesi ilmoitusten tiheyden. 
7. NapsautaTallenna.