Salesforce-integraation API-kutsuiden ja synkronointivirheiden hallinta

HubSpot-Salesforce-integraatiosynkronoi tietoja HubSpotin ja Salesforcen välillä. Synkronointivirheet voivat estää tietueiden tai ominaisuusarvojen synkronoinnin, mikä voi aiheuttaa eroja kahden järjestelmän tietojen välillä.

Seuraa integraation synkronoinnin tilaa, jotta voit tunnistaa ja korjata virheet, jotka estävät tietojen synkronoinnin. Voit myös seurata API-kutsuiden käyttöä ja määrittää ilmoituksia, jotta pysyt ajan tasalla uusista synkronointivirheistä.

Säädä API-kutsujen rajaa

1. Napsauta HubSpot-tilisi ylänavigointipalkin asetuskuvaketta. Siiry vasemman sivuvalikkopalkin kohtaan Integraatiot > Yhdistetyt sovellukset.
2. Napsauta liitettyjen sovellusten luettelossaSalesforcea. 
3. Siirry Tietojen synkronointi-välilehdelle. 
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 luettelossaSalesforcea. 
3. Siirry Data sync-välilehdelle. 
4. Synkronoinnin tila -välilehdenSynkronointivirheet-osiossa voit tarkastella kunkin virhetyypin kortteja, joissa näkyy nykyisten virheiden määrä ja virheiden kohteena olevat tietueet. Napsauta virhetyypin korttia nähdäksesi virheiden tiedot oikeanpuoleisessa paneelissa. Lue lisää kustakin virhetyypistä ja niiden ratkaisuehdotuksista. 

5. Voit tarkastella virheen lisätietoja napsauttamalla Virhetyyppi-sarakkeen tietokuvaketta .
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 virheluetteloon. 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ä assosiaatioista johtuvista virheistä 

• Yhdistämisraja saavutettu
• Odotetaan tilin synkronointia

• Yhdistelmän kardinaalisuuden epäsuhta

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. 

Yhdistämisen kardinaalisuuden epäsuhta -virhe ilmenee, kun HubSpotissa useisiin kontakteihin liitetty toiminto yrittää synkronoitua Salesforceen. Integraatio tukee vain yhden kontaktin yhdistämisen synkronointia toimintoa kohti.

Virheiden korjaaminen 

Voit korjata virheen ”Yhdistämisraja saavutettu”joko poistamalla osan yhdistetyistä tietueista tai yhdistämällä ne toiseen Salesforce-tietueeseen ja jatkamalla sitten synkronointia.

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

Voit korjata ”Association cardinality mismatch ” -virheen poistamalla ylimääräiset yhteyshenkilöiden liitännät niin, että vain yksi yhteyshenkilö on liitetty aktiviteettiin.

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 validointisääntöjen aiheuttaman ongelman vuoksi.

Virheiden korjaaminen

Kaksoiskappaleet

Esimerkkejä päällekkäisyysvirheistä

• 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. 

Kuinka korjata virheet

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

Salesforcen päällekkäisyyssäännön virheen korjaamiseksi on suositeltavaa, että Salesforcen järjestelmänvalvoja tarkistaa Salesforcessa määritetyt päällekkäisyyksien poistamista koskevat säännöt. Yhdistä, päivitä tai poista sitten ristiriitaiset Salesforce-tietueet tai muokkaa päällekkäisyyksien poistamista koskevaa sääntöä Salesforcessa ennen kuin yrität synkronoida tiedot 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 liitetyllä käyttäjällä ei ole pääsyä tarvittavaan kenttään tai objektiin Salesforcessa.

Kuinka korjata virheet

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 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. 

”Insufficient Salesforce access” -virhe 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-valintaluettelon vaihtoehto
• Epäyhtenäinen osavaltion tai maan 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, 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, jos valintaluettelon arvojen enimmäismäärä on saavutettu tai jos välitetty arvo ei ole kelvollinen.

Virheiden korjaaminen

Voit korjata virheen”Valtion tai maan arvo ei täsmää ” tarkistamalla, että seuraavat vaatimukset täyttyvät:

• HubSpotin Country -ominaisuuden 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 maan arvolle Salesforcessa. Lisäksi HubSpotin State-ominaisuus vaihtoehdon sisäisen arvon on vastattava olemassa olevaa osavaltion vaihtoehtoa Salesforcessa. 

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

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

”Inaktiivinen myyntimahdollisuuden vaihe” -virhe ilmenee , kun Salesforce-myyntimahdollisuus, jonka vaihe on inaktiivinen, yritetään synkronoida 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” Salesforcessa. 

Voit korjata virheen ”Option limit exceeded” 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-myyntimahdollisuuksia yritetään synkronoida HubSpotiin ja tietuetyyppi puuttuu. 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 korjata virheen ”Myyntimahdollisuuden vaihe puuttuu tai on virheellinen ” varmistamalla, että Salesforce-myyntimahdollisuuden vaiheen arvo löytyy HubSpotin myyntiputkesta.

Salesforce-tehtäväkenttien virheiden osalta vertaa Salesforcen tehtävän prioriteetti-, tila- tai tyyppi-arvoja vastaaviin tehtävän ominaisuusvaihtoehtoihin HubSpotissa.

• HubSpotintehtävän prioriteettiasetukset ovat: Korkea, Keskitaso, Matala ja Ei mitään.

• HubSpotintehtävän tila tukee seuraavia vaihtoehtoja: Ei aloitettu, Käynnissä, Odottaa, Valmis ja Lykätty.

• HubSpotintehtävän tyypit: Puhelu, Sähköposti, LinkedIn-yhteys, LinkedIn InMail, Kokous ja Tehtävä.

Koska nämä ovat oletusarvoisia, muokattamattomia HubSpot-ominaisuuksia, et voi lisätä uusia vaihtoehtoja HubSpotissa. Päivitä Salesforcen valintaluettelon arvot vastaamaan tarkalleen HubSpotissa käytettävissä olevia vaihtoehtoja, määritä Salesforcen kenttä uudelleen eri HubSpot-ominaisuudelle tai poista yhteensopimaton kenttämääritys kokonaan. Kun olet korjannut arvot ja määritykset, synkronoi kentät uudelleen.

Ominaisuusmääritykset

Esimerkkejä ominaisuusmääritysten virheistä 

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

Mitä virheet tarkoittavat

Tietueita ei synkronoida, koska HubSpot-ominaisuuden ja Salesforce-kentän välisessä liitoksessa 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ä Salesforce-viitekentän liitos on luotava.

Virheiden korjaaminen 

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

”Puuttuva Salesforce-tunnus” -virhe ilmenee, kun HubSpot yritti synkronoida olemassa olevasta Salesforce-tunnuksesta poikkeavan arvon Salesforcen viite- tai hakukenttään. 

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
• Vaadittua maata 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 merkkirajaa Salesforcessa. 

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

Korjaa ”Vaadittua maata puuttuu ” -virhe 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. 

”Virheellinen arvo ” -virheen korjaamiseksi on suositeltavaa päivittää Salesforce-tietueen ominaisuusarvo vastaamaan HubSpotin ominaisuusarvolle asettamia vaatimuksia. 

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 ”Puuttuva pakollinen arvo” -virheen lisäämällä Salesforce-tietueeseen arvon kaikille ominaisuuksille , jotka on merkitty pakollisiksi HubSpotissa. 

Muu / Tuntematon

Esimerkki muusta / tuntemattomasta virheestä

• Tuntematon Salesforce-kaksoiskappalevirhe: Määritetty kaksoiskappale-tunnus.

Mitä virhe tarkoittaa

Tämä virhe voi ilmetä, jos luot kenttämäärityksen, joka sisältää oletusarvoisen Salesforce-tunnuskentän, kuten Lead ID tai Contact ID, ja määrität sen vastaavalle Salesforce Lead ID- tai Salesforce Contact ID -ominaisuudelle HubSpotissa.

Virheen korjaaminen

Integraatio hallinnoi näitä ID-arvoja automaattisesti, eikä niitä tule sisällyttää mukautettuihin kenttämäärityksiin. Tällaisten määritysten luominen voi aiheuttaa odottamattomia synkronointiongelmia, erityisesti kun synkronointisääntö on asetettu kaksisuuntaiseksi.

Muiden tuntemattomien virheiden osalta ota yhteyttä HubSpot-tukeen saadaksesi lisäapua.

Huomaa: 100 Salesforce-virhettä kerrallaan on mahdollista synkronoida joukkosynkronoinnilla. 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 luettelossaSalesforcea. 
3. Siirry Tietojen synkronointi-välilehdelle. 
4. Napsauta Synkronoinnin tila -välilehden Synkronointivirheet-osiossa Hallitse ilmoituksia. 
5. Kytke valintaikkunassaIlmoitukset päälle -kytkin päälle. 
6. ValitseHeti,Päivittäin taiViikoittain -valintanappi ilmoitusten toistumistiheyden määrittämiseksi. 
7. NapsautaTallenna.