Yhdistetään Revial Salesforceen
OAuth-kirjautuminen, tuotanto- ja sandbox-ympäristöt, yhdistetyn sovelluksen hyväksyminen ja mitä tehdä, kun yhteys on estetty.
CRM-integraatio otetaan käyttöön kerran koko organisaatiolle. Salesforce yhdistetään interaktiivisella Salesforce-kirjautumisella (OAuth) — Salesforce palauttaa instanssisi URL-osoitteen kirjautumisen yhteydessä, joten tuotantoympäristölle ei tarvitse syöttää osoitetta.
Yhteys toimii yhden Salesforce-käyttäjän oikeuksin ja näkee vain sen, minkä kyseisen käyttäjän profiili, käyttöoikeusjoukot, jakosäännöt ja kenttätason suojaus sallivat. Suosittelemme erillistä integraatiokäyttäjää (esimerkiksi revialintegration@yourcompany.com).
Tarkat luettavat ja kirjoitettavat kentät löytyvät sivulta Mitä Revial synkronoi Salesforcen kanssa. Todennusmallista, API-kulutuksesta ja tietoturvasta kerrotaan Salesforcen teknisessä integraatio-oppaassa.
Yleiskatsaus
- Tapaamisbriiffit — rikastettuna Salesforcen myyntimahdollisuuden vaiheella, kontakteilla, viimeaikaisella aktiviteetilla ja asiakastiedoilla.
- Tapaamisten yhteenvedot — kirjataan automaattisesti valmiiksi merkittynä Taskina tunnistettuun myyntimahdollisuuteen tai asiakkaaseen.
- Kontaktien ja yritysten tunnistus — tapaamisen osallistujat linkitetään Salesforcen tietueisiin.
- Diilin konteksti — avoimet myyntimahdollisuudet, vaiheet ja summat näkyvät tapaamisten yhteydessä.
Revial lukee asiakkaat (Account), kontaktit, konvertoimattomat liidit, myyntimahdollisuudet (avoimet sekä ensimmäisessä synkronoinnissa viimeisten 12 kuukauden aikana muokatut), myyntimahdollisuuksien vaiheet, Eventit, Taskit, EmailMessage-tietueet ja klassiset muistiinpanot.
Vaatimukset
- Revial-rooli: Ylläpitäjä tai Omistaja organisaatiossasi.
- Revial-tilaus: CRM-integraation sisältävä tilaus (Medium tai Sales).
- Salesforce-käyttäjä: API-pääsy käytössä ("API Enabled") ja lukuoikeus yllä lueteltuihin objekteihin. Tavallinen myyntiprofiili riittää yleensä.
- Salesforce-versio, jossa on API-pääsy — Enterprise, Unlimited, Performance tai Developer. Essentials-versiossa API-pääsyä ei ole, ja Professional-versiossa se on lisäosa.
- Jos organisaatiosi rajoittaa yhdistettyjä sovelluksia: Salesforce-ylläpitäjä, joka voi hyväksyä Revial-sovelluksen (katso alla).
Vaihe 1 — Avaa CRM-integraatiot
- Siirry Revialissa kohtaan Organisaatio → CRM-integraatiot.
- Etsi Salesforce-kortti (Ei yhdistetty).
Vaihe 2 — Yhdistä
Tuotantoympäristö: napsauta Yhdistä Salesforceen.
Sandbox-ympäristö: valitse Sandbox-ympäristö ja syötä sandboxin oma kirjautumisosoite kenttään Salesforce-kirjautumisosoite ilman https://-alkua — esimerkiksi acme--uat.sandbox.my.salesforce.com. Napsauta sitten Yhdistä Salesforceen.
Käytä sandboxin omaa osoitetta, älä yleistä test.salesforce.com-osoitetta. Yleinen osoite ohjaa jo kirjautuneen käyttäjän siihen ympäristöön, johon hän on kirjautunut, jolloin tuotantoympäristö voi yhdistyä vahingossa.
Salesforce näyttää aina kirjautumisnäkymän, vaikka olisit jo kirjautunut, joten valitset itse tilin, jota integraatio käyttää. Kirjaudu, tarkista pyydetyt käyttöoikeudet ja napsauta Allow.
Ennen kuin mitään tallennetaan, Revial vaihtaa valtuutuskoodin tunnisteisiin, tarkistaa instanssin URL-osoitteen ja lukee kirjautuneen käyttäjän profiilin. Jos jokin vaihe epäonnistuu, mitään ei tallenneta ja palaat CRM-integraatioihin virheilmoituksen kanssa.
Vaihe 3 — Tarkista yhteys
Palaat Revialiin ilmoituksella "CRM yhdistetty onnistuneesti". Kortissa näkyy Yhdistetty, Salesforce-käyttäjän sähköpostiosoite sekä painikkeet Synkronoi nyt ja Katkaise yhteys. Tarkista, että sähköpostiosoite on oikea tili.
Ensimmäinen synkronointi
Ensimmäinen synkronointi käynnistyy automaattisesti taustalla yhdistämisen yhteydessä. Sen jälkeen Revial synkronoi noin tunnin välein, kun Automaattinen synkronointi on päällä CRM-asetuksissa (oletuksena päällä). Synkronoi nyt käynnistää synkronoinnin heti.
Salesforce-ylläpitäjälle — yhdistetyn sovelluksen hyväksyminen
Jos organisaatiosi rajoittaa, mitä yhdistettyjä sovelluksia käyttäjät voivat valtuuttaa, ylläpitäjän on hyväksyttävä Revial ennen kuin käyttäjät voivat yhdistää.
Milloin tätä tarvitaan? Käyttäjä näkee viestin "This app is blocked" tai "OAuth error: this app is not approved for access", tai kirjautuminen epäonnistuu heti Allow-painikkeen jälkeen.
- Kirjaudu Salesforceen järjestelmänvalvojana (System Administrator).
- Siirry kohtaan Setup → Apps → Connected Apps → Connected Apps OAuth Usage.
- Etsi Revial — se näkyy ensimmäisen yhdistämisyrityksen jälkeen.
- Napsauta Install / Manage → Edit Policies.
- Aseta Permitted Users (esimerkiksi "Admin approved users are pre-authorized") ja liitä sopiva profiili tai käyttöoikeusjoukko.
- Tallenna.
Tarkista myös, että yhdistävän käyttäjän profiilissa on API Enabled — ilman sitä kirjautuminen onnistuu, mutta jokainen API-kutsu epäonnistuu.
Yhteyden hallinta
Synkronointi — Salesforce-kortin Synkronoi nyt käynnistää synkronoinnin; kohdan Organisaatio → CRM-asetukset kytkin Automaattinen synkronointi kytkee tunnin välein tapahtuvan synkronoinnin päälle tai pois. Kun se on pois päältä, tapaamisten yhteenvetoja ei myöskään kirjoiteta automaattisesti.
Yhteyden katkaiseminen — napsauta Salesforce-kortissa Katkaise yhteys ja vahvista. Revial pysäyttää synkronoinnin ja poistaa taustalla synkronoidun kopion Salesforce-datastasi, tallennetut tunnisteet ja yhteyden asetukset (myös kenttien mäppäykset). Revialin jo kirjoittamat Taskit ja tietueet jäävät Salesforceen.
Yhteyden katkaiseminen Revialissa ei peruuta Revialin käyttöoikeutta Salesforcessa. Päätä käyttöoikeus peruuttamalla sovellus kohdassa Setup → Connected Apps OAuth Usage tai poistamalla yhdistävä käyttäjä käytöstä.
Yhdistetyn käyttäjän vaihtaminen — katkaise yhteys, odota että katkaisu on valmis, ja yhdistä uudelleen uutena käyttäjänä. Uutta yhteyttä ei voi muodostaa, kun Salesforce-yhteys on yhä yhdistettynä.
Vianmääritys
Yhteysvirheet
| Viesti | Mitä tehdä |
|---|---|
| "This app is blocked" / kirjautuminen epäonnistuu heti Allow-painikkeen jälkeen | Salesforce-ylläpitäjän on hyväksyttävä Revial-sovellus — katso yllä |
| "Yhdistäminen peruutettu" | Käyttöoikeus evättiin Salesforcen näkymässä. Yhdistä uudelleen ja napsauta Allow |
| "Failed to authenticate with Salesforce" | Koodin vaihto epäonnistui — yleensä kirjautuminen keskeytyi. Yritä uudelleen |
| "Failed to validate Salesforce access" | Kirjautuminen onnistui, mutta profiilin tarkistus epäonnistui. Tarkista, että käyttäjällä on API Enabled ja versiossasi on API-pääsy |
| "Missing instance URL from Salesforce" / "Not a recognized Salesforce domain" | Salesforce palautti instanssin, joka ei ole *.salesforce.com- tai *.force.com-osoitteessa. Ota yhteyttä Revialin tukeen ja kerro organisaatiosi My Domain -osoite |
| "Invalid or expired state" | Kirjautumiseen kului yli viisi minuuttia. Aloita uudelleen CRM-integraatioista |
| "Invalid Salesforce login host…" | Sandboxin osoite ei ole Salesforce-verkkotunnus. Syötä sandboxin oma osoite, esimerkiksi acme--uat.sandbox.my.salesforce.com |
| "Team already has an active Salesforce connection. Disconnect it first." | Katkaise olemassa oleva Salesforce-yhteys ensin |
| "You must be a team admin or owner to connect a CRM" | Pyydä Revial-organisaation ylläpitäjää tai omistajaa yhdistämään |
| "CRM integration is not available on your current plan…" | Tilaukseesi ei sisälly CRM-integraatiota |
| "Too many requests. Please try again later." | Liian monta yritystä lyhyessä ajassa. Odota hetki ja yritä uudelleen |
| "Failed to save connection" | Revial ei voinut tallentaa yhteyttä. Yritä uudelleen; ota yhteyttä tukeen, jos virhe toistuu |
Synkronointiongelmat
| Oire | Mitä tehdä |
|---|---|
| Dataa puuttuu synkronoinnin jälkeen | Yhdistävä käyttäjä ei näe näitä tietueita — tarkista jakosäännöt, rooli ja objektioikeudet |
| Sähköposteja, Eventejä tai Taskeja puuttuu ja yhteys pyytää uudelleenvaltuutusta | Käyttäjältä puuttuu lukuoikeus kyseiseen objektiin. Myönnä se; muu synkronointi valmistuu silti |
| Ilmoitus "CRM: Authentication expired" | Päivitystunniste peruutettiin — sovellus peruutettiin, käyttäjä poistettiin käytöstä tai salasana nollattiin. Katkaise yhteys ja yhdistä uudelleen |
| Salesforcessa poistettu tietue näkyy yhä Revialissa | Odotettua — Revial ei tunnista Salesforcen poistoja |
Pikaopas — yhdistäminen
- Revial → Organisaatio → CRM-integraatiot → Salesforce.
- Vain sandbox: valitse Sandbox-ympäristö ja syötä sandboxin oma kirjautumisosoite.
- Napsauta Yhdistä Salesforceen, kirjaudu integraatiokäyttäjänä ja napsauta Allow.
- Jos sovellus on estetty, pyydä Salesforce-ylläpitäjää hyväksymään se.
- Tarkista kortissa näkyvä sähköpostiosoite. Ensimmäinen synkronointi käynnistyy automaattisesti.
Pipedriven tekninen integraatio-opas
Pipedrive-ylläpitäjille, tietoturva-arvioijille ja IT:lle — miten Revial todentaa, mihin scopeihin ja oikeuksiin se tukeutuu, API-kulutus, virhetilanteet ja auditointi.
Mitä Revial synkronoi Salesforcen kanssa
Salesforce-ylläpitäjällesi ja sille, joka arvioi integraation tietojen käyttöoikeudet — jokainen Salesforce-kenttä, jonka Revial lukee, kaikki mitä se kirjoittaa takaisin ja tunnetut puutteet.