Yhdistetään Revial Pipedriveen

Revial yhdistyy Pipedriveen Pipedrive Marketplace OAuth -sovelluksena. Ei ole liitettävää API-avainta, luotavaa palvelutiliä tai määritettävää käyttöoikeusjoukkoa. Yksi henkilö valtuuttaa sovelluksen kerran; Revial säilyttää sen jälkeen refresh tokenia, joka on sidottu kyseisen henkilön Pipedrive-tiliin ja yritykseen. Jälkikäteen ei ole kierrätettävää tunnistetietoa eikä jatkuvaa hallinnollista tehtävää.

Koska Revial toimii kyseisenä henkilönä, yhteys näkee täsmälleen sen, mitä hänkin näkee. Tämä yksittäinen seikka määrittää integraation laajuuden, ja luku 2 käsittelee sen kokonaisuudessaan. Se tarkoittaa myös, että ainoa laajuuteen liittyvä päätös, jonka voit tehdä, on se, kuka valtuutuksen tekee — Pipedrivessa ei ole mekanismia, jolla sovellukselle voisi antaa sen käyttäjää suppeamman näkymän, joten karsittavaa roolia ei ole.

1. Mitä sinun tulee päättää ennen yhdistämistä

Sinun on tehtävä kaksi päätöstä, ja molemmat ratkaistaan valitsemalla, kuka klikkaa Connect-painiketta.

1.1 Kuka valtuuttaa yhteyden

Mitä tulee päättää: mikä Pipedrive-käyttäjätili valtuuttaa sovelluksen.

Mitä se päättää: kaiken, mitä Revial voi nähdä ja kaiken, mitä Revial voi kirjoittaa. Revial kutsuu Pipedriven API:a kyseisen käyttäjän tunnisteella (token), joten se näkee täsmälleen samat diilit, henkilöt ja organisaatiot, jotka käyttäjä näkee Pipedriven käyttöliittymässä, ja kirjoittaa tietoja kyseisenä käyttäjänä.

Miten valita:

• Jos Revialin tulee kattaa koko pipeline, valtuuta yhteys admin-tilillä tai millä tahansa tilillä, jolla on koko yrityksen laajuinen näkyvyys.
• Jos Revialin käyttö tulee rajata vain osaan pipelinea, valtuuta yhteys käyttäjällä, jonka Pipedriven näkyvyysryhmät ja käyttöoikeusasetukset jo rajaavat näkyvyyden tähän osajoukkoon. Tämä on ainoa käytettävissä oleva rajausmekanismi.

Suosittelemme käyttämään erillistä, nimettyä integraatiokäyttäjää yksittäisen myyjän tilin sijaan – ei turvallisuussyistä, vaan jatkuvuuden vuoksi. Jos myyjä lähtee yrityksestä ja hänen Pipedrive-tilinsä deaktivoidaan, yhteys katkeaa ja jonkun toisen on valtuutettava se uudelleen.

1.2 Käytätkö mukautettuja kenttiä tapaamismuistiinpanoille

Mistä tieto löytyy: kysy Pipedrive-määrityksistänne vastaavalta henkilöltä, onko tapaamisten yhteenvetojen tai transkriptioiden tarkoitus tallentua tiettyyn mukautettuun kenttään diilissä, henkilössä tai organisaatiossa, tavallisen Pipedrive-muistiinpanon sijaan.

Mitä tulee päättää: jos on, niin mihin kohteeseen (diili / henkilö / organisaatio) ja mikä on mukautetun kentän avain (field key).

Mitä se päättää: määritämmekö yhteyttäsi varten kenttien mapauksen (field mapping). Revial voi lukea saatavilla olevat kenttäsi ja kirjoittaa nimettyyn kenttään. Sinun ei tarvitse tehdä muutoksia skeemaan – kentän on oltava jo olemassa.

Yhteenveto — pidä nämä tiedot saatavilla

2. Tärkeää: OAuth-scopet eivät voi erottaa B2B- ja B2C-tietoja

Jos luet tätä tarkasti siksi, että yksi Pipedrive-yrityksesi sisältää sekä yritys- että kuluttajatietoja, lue tämä osio ennen yhdistämistä.

Pipedriven OAuth-scope määrittää, mitä päätepisteitä sovellus voi kutsua ja onko sillä luku- vai kirjoitusoikeus. Se ei suodata rivejä. persons:read-oikeuden myöntäminen antaa lukuoikeuden jokaiseen henkilöön, jonka valtuutuksen antava käyttäjä voi nähdä. Ei ole olemassa scopea tai scopien yhdistelmää, joka määrittäisi "vain nämä diilit".

Rivitason rajoitukset Pipedrivessa tulevat käyttäjän omista oikeuksista: hänen oikeusjoukostaan ja näkyvyysryhmistään. Koska Revial toimii kyseisenä käyttäjänä, nämä rajoitukset siirtyvät integraatioon – mutta ne periytyvät, niitä ei määritetä Revialille erikseen.

Mikä tapaus koskee sinua?

Tapauksessa C Revial lukee ja kirjoittaa vain niitä tietoja, jotka se on yhdistänyt todelliseen tapaamisen osallistujaan, joten kuluttajatietoihin ei kosketa, ellei kuluttaja osallistu seurattuun myyntitapaamiseen. Haluamme olla tarkkoja tämän suhteen: kyseessä on tuotteen toiminnallinen ominaisuus, ei Pipedriven valvoma rajoitus. Jos hallintomallinne vaatii alustatason valvontaa, tapaus C edellyttää näkyvyysryhmien uudelleenjärjestelyä. Kerromme tämän mieluummin suoraan kuin annamme scope-listan antaa ymmärtää takuuta, jota se ei voi antaa.

3. Yhdistäminen

Yhdistämisen suorittaa kohdassa 1.1 valittu Pipedrive-käyttäjä. Tämän käyttäjän on oltava myös Revialin Ylläpitäjä tai Omistaja ja hänellä on oltava Medium- tai Sales-suunnitelma.

1. Mene Revialissa polkuun Organisaation asetukset → CRM.
2. Valitse Yhdistä Pipedriveen. Sinut ohjataan Pipedriveen.
3. Kirjaudu sisään kohdassa 1.1 valitulla tunnuksella, jos et ole jo kirjautunut. Jos olet jo kirjautunut sisään toisella tunnuksella, kirjaudu ensin ulos — valtuutus sitoutuu hiljaisesti siihen käyttäjään, joka on kirjautuneena sisään, ja tämä on yleisin virhe.
4. Tarkista pyydetyt scopet (kohta 4) ja valitse Salli ja asenna.
5. Sinut ohjataan takaisin Revialiin, jossa näkyy tila Yhdistetty sekä Pipedrive-sähköpostiosoite, johon yhteys on sidottu. Tarkista tämä sähköpostiosoite — se on vahvistuksesi siitä, että oikea tunnus suoritti valtuutuksen.

Revial validoi tokenin kutsumalla päätepistettä GET /api/v1/users/me ennen kuin mitään tallennetaan, joten epäonnistunut valtuutus hylätään välittömästi sen sijaan, että se ilmenisi myöhemmin rikkinäisenä synkronointina.

Revial tukee yhtä CRM-yhteyttä per organisaatio. Jos organisaatiollasi on jo CRM-yhteys, se on poistettava ennen kuin Pipedrive voidaan yhdistää — yhdistämisyritys hylätään sen sijaan, että se korvaisi olemassa olevan yhteyden hiljaisesti.

Se, voiko tavallinen käyttäjä suorittaa vaiheen 4, riippuu Pipedrive-suunnitelmastasi ja -asetuksistasi — jotkut yritykset rajoittavat Marketplace-sovellusten asennuksen vain ylläpitäjille. Jos valtuutuksen tekevä käyttäjä ei näe Salli ja asenna -painiketta, ylläpitäjän on joko asennettava sovellus tai poistettava tämä rajoitus.

4. Revialin pyytämät scopet

Nämä ovat Marketplace-sovelluksen määrittämiä, eivätkä ne ole asiakaskohtaisesti muokattavissa. Pipedrive näyttää ne suostumusnäkymässä.

Muistiinpanot luodaan yllä mainittujen deals/persons/organizations-scopejen kautta; Pipedrivella ei ole erillistä scopea muistiinpanoille.

Kolme scopea on käytössä, mutta niitä ei hyödynnetä. products:read, products:write ja activities:write ovat sovelluksen rekisteröinnissä, mutta Pipedrive-synkronointi ei kutsu mitään products-päätepistettä eikä luo aktiviteetteja — aktiviteettien takaisinkirjoitusta ei ole toteutettu Pipedrivelle. Ne ovat mukana sovelluksen määrittelyssä, eivät siksi, että integraatio käyttäisi niitä. Jos tämä on esteenä arvioinnillesi, kerro meille: ne voidaan poistaa sovelluksen rekisteröinnistä, ja vahvistamme tämän kirjallisesti.

Suostumusnäkymässä näkemäsi scope-lista määräytyy sovelluksen rekisteröinnin mukaan, ei Revialin pyynnön perusteella. Revial ei välitä scope-parametria ohjatessaan sinut Pipedriveen, joten Pipedrive näyttää ja myöntää täsmälleen ne oikeudet, jotka on määritetty Marketplace-sovellukselle — sama lista jokaiselle asiakkaalle. Scopeja ei rajata asiakaskohtaisesti.

Kirjoitusoikeuksia antavat scopet ovat laajempia kuin mihin Revial niitä käyttää. Pipedrivella ei ole kenttätason scopeja: deals:write sallii minkä tahansa kentän päivittämisen missä tahansa näkyvissä olevassa diilissä, ei ainoastaan sitä yhtä kenttää, jonka Revial on määritetty kirjoittamaan. Revial kirjoittaa muistiinpanoja ja korkeintaan nimeämiäsi mukautettuja kenttiä — mutta tämän rajan asettaa ohjelmisto, ei scope. Jos tarvitset alustatason valvontaa, keino tähän on valtuuttavan käyttäjän käyttöoikeusasetukset, ei scope-lista.

5. Mitä Revial lukee ja kirjoittaa

Lukee — synkronoinnin aikana:

Ensimmäisen täyden synkronoinnin jälkeen seuraavat synkronoinnit ovat inkrementaalisia: Revial välittää updated_since-parametrin ja hakee vain viimeisimmän ajon jälkeen muuttuneet tietueet. Pipedriven poistetuksi merkitsemät tietueet tunnistetaan samalla ajolla ja poistetaan Revialin kopiosta, joten poisto Pipedrivessa heijastuu myös Revialiin jättämättä orpoja tietueita.

Kirjoittaa:

Nämä ovat ainoat kaksi kirjoitustoimintoa. Revial ei luo Pipedrive-aktiviteetteja, ei lisää diilien osallistujia eikä muokkaa diilin, henkilön tai organisaation vakiokenttiä.

Joidenkin aliresurssien haut epäonnistuvat hiljaa. Jos diilin osallistujien tai myyntiputken vaiheiden lukeminen epäonnistuu, Revial kirjaa sen lokiin ja jatkaa, jolloin synkronointi raportoidaan onnistuneeksi puuttuvista tiedoista huolimatta virheen nostamisen sijaan. Jos osallistujien ja diilien yhdistäminen tai vaihetiedot näyttävät synkronoinnin jälkeen puutteellisilta, ilmoita siitä meille — on syytä tarkistaa lokitiedot sen sijaan, että olettaisit tietojen puuttuvan Pipedrivesta.

Muistiinpanot merkitään valtuutuksen tehneen käyttäjän nimiin, koska kutsu tehdään hänen tunnisteellaan (token). Revial ei aseta muistiinpanolle erillistä omistajaa yhdistääkseen sen yksittäisen tapaamisen omistajaan. Jos useiden myyjien tapaamiset synkronoidaan yhden yhteyden kautta, jokainen Pipedriveen syntyvä muistiinpano näyttää tekijänään valtuutuksen tehneen käyttäjän. Tämä on todellinen rajoitus eikä virheellinen asetus — jos myyjäkohtainen kirjaus Pipedrivessa on sinulle tärkeä, ota meihin yhteyttä.

6. Mukautettujen kenttien määritys

Jotkin organisaatiot haluavat tapaamisten yhteenvedot tai transkriptiot nimettyyn mukautettuun kenttään vapaamuotoisen muistiinpanon sijaan. Revial tukee tätä vain konfiguroimalla.

Anna meille entiteetti (diili, henkilö tai organisaatio) ja kentän avain. Revial voi listata yhteytesi saatavilla olevat kentät — mukaan lukien mukautetut kentät — joten sinun ei tarvitse etsiä avainta itse.

Kentän on oltava jo olemassa. Revial ei luo kenttiä eikä muokkaa Pipedrive-skeemaasi.

Jos kenttien eräpäivitys epäonnistuu, Revial yrittää päivittää jokaisen kentän yksitellen uudelleen ja ilmoittaa, mitkä päivitykset epäonnistuivat, sen sijaan että koko kirjoitustoiminto hylättäisiin.

7. Mitä Revial jättää tarkoituksella tekemättä

Revial ei voi poistaa mitään Pipedrive-entiteettejä. Se ei luo tai muokkaa mukautettuja kenttiä, ei muuta myyntiputkia tai niiden vaiheita, ei muuta käyttäjäoikeuksia eikä koske yrityksen asetuksiin.

Sen lukuoikeudet rajoittuvat osiossa 5 lueteltuihin entiteetteihin. Erityisesti on huomioitava, että Revial ei pyydä sähköpostin lukuoikeuksia — se ei lue Pipedrive-sähköpostisynkronointisi sisältöä, ja integraatio on tarkoituksella rakennettu välttämään mail:full-vaatimusta. Se lukee last_incoming_mail_time- ja last_outgoing_mail_time-aikaleimat, joita Pipedrive ylläpitää henkilön perustiedoissa ja joiden avulla se arvioi, onko diili hiljentynyt. Vain aikaleimat — ei koskaan aiheita, viestien sisältöjä tai vastaanottajia.

On tärkeää ymmärtää, mikä näitä rajoja valvoo. Yllä mainitut rajat perustuvat siihen, mitä ohjelmisto tekee, eivät Pipedriven käyttöoikeuksiin — osiossa 4 mainitut kirjoitusoikeudet sallisivat teknisesti enemmän. Ainoa raja, jota Pipedrive itse valvoo, on valtuutuksen antaneen käyttäjän näkyvyys.

8. Tunnistetiedot, vanheneminen ja pääsyn peruuttaminen

Pääsytunnisteet ovat voimassa 60 minuuttia, ja Revial päivittää ne automaattisesti. Virkistystunnisteet vaihtuvat jokaisen päivityksen yhteydessä eivätkä vanhene ennalta määrätyssä ajassa. Sinun ei tarvitse huolehtia niiden vaihtamisesta.

Virkistystunniste lakkaa toimimasta, kun:

• valtuutuksen antaneen käyttäjän Pipedrive-tili poistetaan käytöstä tai poistetaan kokonaan;
• sovellus poistetaan Pipedrive Marketplacesta;
• Pipedrive mitätöi sen.

Revial erottaa perutun tai virheellisen virkistystunnisteen väliaikaisesta käyttökatkosta ja ilmoittaa sen yhteytenä, joka vaatii uudelleenvaltuutuksen, sen sijaan että se yrittäisi yhdistää hiljaa uudelleen.

Peruuttaaksesi Revialin pääsyn: poista Revial-sovellus Pipedrive Marketplacesta → Installed apps tai poista valtuutuksen antanut käyttäjä käytöstä. Kumpikin toimenpide astuu voimaan välittömästi.

Yhteyden katkaiseminen Revialin sisällä (Organization Settings → CRM → Disconnect) pysäyttää kaiken synkronoinnin, poistaa Revialin synkronoiman kopion CRM-datasta ja poistaa tallennetut tunnistetiedot.

Muistiinpanot ja kenttien arvot, jotka Revial on aiemmin kirjoittanut Pipedriveen, pysyvät siellä; yhteyden katkaiseminen ei poista mitään CRM:stäsi.

9. Yhteyden tarkistaminen

Suosittelemme tarkistamaan yhteyden tässä järjestyksessä, sillä jokainen vaihe testaa eri scopea.

1. Yhteys on hyväksytty ja näytetty sähköpostiosoite on oikea tili. Tämä vahvistaa, että token on voimassa ja users:read toimii – ja mikä tärkeintä, että oikea henkilö antoi valtuutuksen.
2. Ensisynkronointi tuo organisaatiot, henkilöt ja diilit. Tämä vahvistaa read-scopet ja valtuutuksen antaneen käyttäjän näkyvyyden.
3. Tarkista, että diili näyttää oikean pipeline-vaiheen. Vahvistaa pipelines:read-oikeuden.
4. Lisää testimuistiinpano tunnettuun diiliin. Vahvistaa muistiinpanon luomisen.
5. Jos käytät kenttien mäppäystä, tarkista, että määritettyyn kenttään on kirjoitettu. Vahvistaa kyseisen entiteetin kirjoitusoikeuden.
6. Varmista kohdan 2 tapauksessa A, ettei kuluttajatietuetta ole läsnä synkronoidussa datassa. Tämä tarkistus todistaa, että valtuutuksen antaneen käyttäjän näkyvyysrajoitus on todella voimassa.

10. Vianmääritys

11. Kysymykset, joihin emme voi vastata puolestasi

Ota nämä asiat esille kanssamme ennen yhdistämistä, ei sen jälkeen:

• Kuluttaja- ja yritystietueesi on erotettu toisistaan vain kentän arvolla (tapaus C).
• Tarvitset myyjäkohtaisen attribuution Pipedriveen kirjoitetuille muistiinpanoille.
• Haluat rajoittaa Revialin tiettyihin pipelineihin.
• Katselmointisi edellyttää kirjallista vahvistusta kappaleen 4 products-scopeista.