Yhdistetään Revial Pipedriveen
Pipedrive-ylläpitäjällesi ja sille, joka hyväksyy integraation tietojen käyttöoikeudet — kuka valtuuttaa, scopet, mitä Revial lukee ja kirjoittaa, ja mitä se tarkoituksella jättää tekemättä.
Revial yhdistyy Pipedriveen Pipedrive Marketplace OAuth -sovelluksena. Liitettävää API-avainta tai luotavaa palvelutiliä ei ole. Yksi henkilö valtuuttaa sovelluksen kerran; Revial säilyttää sen jälkeen päivitystunnistetta, joka on sidottu kyseisen henkilön Pipedrive-käyttäjään ja yritykseen.
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.
Jokainen luettava ja kirjoitettava kenttä löytyy sivulta Mitä Revial synkronoi Pipedriven kanssa. Tunnistemallista, API-kulutuksesta ja virhetilanteista kerrotaan Pipedriven teknisessä integraatio-oppaassa.
1. Mitä sinun tulee päättää ennen yhdistämistä
1.1 Kuka valtuuttaa yhteyden
Mitä se päättää: kaiken, mitä Revial voi nähdä ja kirjoittaa. Revial kutsuu Pipedriven API:a kyseisen käyttäjän tunnisteella, joten se näkee täsmälleen samat diilit, henkilöt ja organisaatiot kuin käyttäjä ja kirjoittaa hänen nimissään.
- Jos Revialin tulee kattaa koko pipeline, valtuuta yhteys admin-tilillä tai muulla tilillä, jolla on koko yrityksen laajuinen näkyvyys.
- Jos Revial rajataan osaan pipelinea, valtuuta yhteys käyttäjällä, jonka Pipedriven näkyvyysryhmät ja käyttöoikeusjoukko jo rajaavat hänet siihen. Tämä on ainoa käytettävissä oleva rajausmekanismi.
Suosittelemme erillistä, nimettyä integraatiokäyttäjää jatkuvuuden vuoksi: jos myyjä lähtee ja hänen tilinsä poistetaan käytöstä, yhteys katkeaa.
1.2 Tallennetaanko tapaamistietoja kenttiin
Revial kirjoittaa jokaisen tapaamisen yhteenvedon Pipedriven muistiinpanona. Jos haluat lisäksi arvoja — yhteenvedon, litteroinnin tai mukautettuja poimintakenttiä — tiettyihin diilin, henkilön tai organisaation kenttiin, ylläpitäjä voi mäpätä ne Revialissa (luku 6). Kenttien on oltava jo olemassa.
2. Tärkeää: OAuth-scopet eivät voi erottaa B2B- ja B2C-tietoja
Pipedriven OAuth-scope määrittää, mitä päätepisteitä sovellus voi kutsua ja onko sillä luku- vai kirjoitusoikeus. Se ei suodata rivejä. persons:read antaa lukuoikeuden jokaiseen henkilöön, jonka valtuuttava käyttäjä näkee.
Rivitason rajoitukset tulevat käyttäjän omista oikeuksista: käyttöoikeusjoukosta ja näkyvyysryhmistä. Koska Revial toimii kyseisenä käyttäjänä, rajoitukset siirtyvät integraatioon — periytyvinä, ei Revialille erikseen määritettyinä.
| Oma asetelmasi | Mikä todellisuudessa erottaa datan |
|---|---|
| A. Kuluttajatiedot näkyvät vain erilliselle näkyvyysryhmälle / käyttöoikeusjoukolle | Valtuuta yhteys käyttäjällä, joka ei kuulu ryhmään. Pipedrive valvoo tätä. |
| B. Sama näkyvyys, eroteltu pipelinen perusteella | Pipedriven näkyvyys ei ole pipelinekohtainen käyttäjän omistamille tai jakamille diileille. Toimii parhaimmillaan osittain — ota meihin yhteyttä. |
| C. Sama näkyvyys, eroteltu vain kentän arvolla | Ei ilmaistavissa Pipedriven oikeuksilla. Vaatii näkyvyysryhmien uudelleenjärjestelyä tai rajausta Revialin puolella — ota meihin yhteyttä. |
Synkronointi kopioi kaiken, minkä valtuuttava käyttäjä näkee. Kirjoitukset kohdistuvat vain tietueisiin, jotka on yhdistetty tapaamisen osallistujiin — tämä on tuotteen toiminnallinen ominaisuus, ei Pipedriven valvoma rajoitus.
3. Yhdistäminen
Yhdistämisen tekee kohdassa 1.1 valittu Pipedrive-käyttäjä, jonka on oltava myös Revialin ylläpitäjä tai omistaja tilauksella, joka sisältää CRM-integraation (Medium tai Sales).
- Siirry Revialissa kohtaan Organisaatio → CRM-integraatiot.
- Napsauta Pipedrive-kortissa Yhdistä Pipedriveen.
- Kirjaudu Pipedriveen kohdassa 1.1 valittuna käyttäjänä. Jos toinen tili on jo kirjautuneena, kirjaudu ensin ulos — valtuutus sidotaan kirjautuneeseen käyttäjään.
- Tarkista pyydetty käyttöoikeus ja hyväksy asennus.
- Palaat Revialiin ilmoituksella "CRM yhdistetty onnistuneesti". Kortissa näkyy Yhdistetty ja valtuuttaneen käyttäjän Pipedrive-sähköpostiosoite. Tarkista osoite.
Revial tarkistaa tunnisteen kutsulla GET /api/v1/users/me ennen tallennusta ja käynnistää ensimmäisen synkronoinnin heti.
Yksi Pipedrive-yhteys organisaatiota kohden. Toista Pipedrive-yhteyttä ei voi muodostaa, kun yksi on yhdistettynä. Muita CRM-järjestelmiä voi yhdistää sen rinnalle.
Jos asennat Revialin Pipedrive Marketplacesta, Revial näyttää viestin "App installed! Click Connect to complete the setup." — viimeistele vaiheesta 2.
4. Revialin Pipedrive-sovelluksen scopet
Scopet on määritetty Marketplace-sovellukseen ja ovat samat kaikille asiakkaille; Revial ei lähetä scope-parametria.
| Scope | Käyttötarkoitus |
|---|---|
deals:read | Diilit ja diilien osallistujat |
deals:write | Muistiinpanot diileihin; mäpätyt diilikentät |
persons:read | Henkilöt |
persons:write | Muistiinpanot henkilöihin; mäpätyt henkilökentät |
organizations:read | Organisaatiot |
organizations:write | Muistiinpanot organisaatioihin; mäpätyt organisaatiokentät |
pipelines:read | Pipelinet ja vaiheet |
activities:read | Aktiviteetit |
users:read | Vain valtuuttavan käyttäjän tarkistus yhdistettäessä |
activities:write, products:read, products:write | Revial ei käytä |
Kirjoitusscopet ovat laajempia kuin Revialin käyttö. Pipedrivessa ei ole kenttätason scopeja, ja Revialin kenttien mäppäys voi kohdistua mihin tahansa kenttään, myös vakiokenttiin. Raja on se, mitä ylläpitäjäsi mäppäävät — sen valvoo Revialin ohjelmisto, ei scope. Jos tarvitset alustatason valvontaa, keino on valtuuttavan käyttäjän käyttöoikeusjoukko.
5. Mitä Revial lukee ja kirjoittaa
Lukee:
| Entiteetti | Päätepiste |
|---|---|
| Organisaatiot, henkilöt, diilit, aktiviteetit | GET /api/v2/organizations, /persons, /deals, /activities |
| Diilien osallistujat | GET /api/v1/deals/{id}/participants (yksi pyyntö diiliä kohden) |
| Pipelinet ja vaiheet | GET /api/v2/pipelines, GET /api/v2/stages |
| Muistiinpanot | GET /api/v1/notes |
| Valtuuttava käyttäjä | GET /api/v1/users/me (vain yhdistettäessä) |
| Kenttämääritykset | henkilö-, diili- ja organisaatiokenttien listat mäppäysnäkymää varten |
Ensimmäisen täyden synkronoinnin jälkeen synkronoinnit ovat inkrementaalisia (updated_since) ja ajetaan noin tunnin välein. Pipedriven poistetuiksi merkitsemät tietueet poistetaan Revialin kopiosta inkrementaalisissa synkronoinneissa; täysi synkronointi ei suodata niitä pois.
Kirjoittaa:
| Mitä | Mihin |
|---|---|
| Tapaamisten yhteenvedot | Pipedriven muistiinpanona tunnistettuun diiliin, organisaatioon tai henkilöön |
| Mäpätyt kentät | Ylläpitäjiesi mäppäämiin kenttiin tunnistetussa diilissä, henkilössä tai organisaatiossa |
Revial ei luo aktiviteetteja, diilejä, henkilöitä tai organisaatioita eikä lisää diilien osallistujia.
Osittaiset virheet raportoidaan, niitä ei piiloteta. Jos ensimmäisen pipelinen vaiheita ei voi lukea tai diilien osallistujien haku epäonnistuu, synkronointi merkitään osittaiseksi. Rate limit -vastaus osallistujien haussa kaataa kyseisen synkronoinnin diilivaiheen, joka yritetään uudelleen.
Muistiinpanojen tekijänä on valtuuttanut käyttäjä, koska kutsu tehdään hänen tunnisteellaan. Revial ei aseta erillistä omistajaa.
6. Kenttien mäppäys
Organisaation ylläpitäjät ja omistajat mäppäävät Revialin yhteenvetokenttiä ja mukautettuja poimintakenttiä Pipedrive-kenttiin kohdassa Organisaatio → CRM-asetukset → Ominaisuuksien yhdistäminen. Revial listaa henkilö-, diili- ja organisaatiokenttäsi, myös mukautetut.
- Kentän on oltava olemassa; Revial ei muuta Pipedrive-skeemaasi.
- Kenttää, jolla on jo arvo, ei muuteta, ellei mäppäystä ole asetettu ylikirjoittamaan.
- Jos eräpäivitys epäonnistuu, Revial yrittää jokaista kenttää erikseen ja raportoi epäonnistuneet.
- Koko litterointi voi päätyä Pipedriveen vain mäpätyn kentän kautta.
Tunnettu ongelma: organisaatiokenttien listassa näkyvät tällä hetkellä Pipedriven tiimikentät organisaatiokenttien sijaan. Ota yhteyttä Revialin tukeen, jos tarvitset organisaatiokenttien mäppäystä.
7. Mitä Revial jättää tarkoituksella tekemättä
Revial ei voi poistaa mitään Pipedrive-entiteettejä. Se ei luo tai muokkaa kenttiä, ei muuta pipelinejä tai vaiheita, ei muuta käyttäjäoikeuksia eikä koske yrityksen asetuksiin.
Revial ei pyydä sähköpostiscopea eikä koskaan lue sähköpostien sisältöä. Se lukee henkilöiden last_incoming_mail_time- ja last_outgoing_mail_time-aikaleimat arvioidakseen, onko diili hiljentynyt.
Nämä rajat perustuvat ohjelmiston toimintaan, eivät Pipedriven käyttöoikeuksiin. Ainoa Pipedriven itse valvoma raja on valtuuttavan käyttäjän näkyvyys.
8. Tunnistetiedot, vanheneminen ja pääsyn peruuttaminen
Pääsytunnisteet päivitetään automaattisesti ennen vanhenemista. Jos Pipedrive myöntää uuden päivitystunnisteen, Revial tallentaa sen. Sinun ei tarvitse huolehtia kierrätyksestä.
Päivitystunniste lakkaa toimimasta, kun valtuuttava käyttäjä poistetaan käytöstä, sovellus poistetaan tai Pipedrive mitätöi sen. Revial merkitsee silloin yhteyden uudelleenvaltuutusta vaativaksi, ja organisaation ylläpitäjä saa ilmoituksen "CRM: Authentication expired".
Revialin pääsyn peruuttaminen: poista Revial-sovellus Pipedrivesta tai poista valtuuttava käyttäjä käytöstä.
Yhteyden katkaiseminen Revialissa (Organisaatio → CRM-integraatiot → Katkaise yhteys) pysäyttää synkronoinnin ja poistaa taustalla Revialin synkronoiman kopion Pipedrive-datastasi, tallennetut tunnisteet ja kenttien mäppäykset.
Yhteyden katkaiseminen Revialissa ei peruuta käyttöoikeutta Pipedrivessa — Revial ei tee peruutuskutsua. Poista sovellus myös Pipedrivesta, jos haluat päättää käyttöoikeuden.
Revialin Pipedriveen jo kirjoittamat muistiinpanot ja kenttien arvot jäävät sinne.
9. Yhteyden tarkistaminen
- Yhteys hyväksyttiin ja näytetty sähköpostiosoite on oikea tili.
- Ensimmäinen synkronointi tuo organisaatiot, henkilöt ja diilit — vahvistaa lukuscopet ja valtuuttavan käyttäjän näkyvyyden.
- Diili on linkitetty oikeaan organisaatioon ja henkilöön.
- Kirjoita testimuistiinpano tunnettuun diiliin — vahvistaa muistiinpanon luonnin.
- Jos käytät mäppäystä, tarkista, että mäpättyyn kenttään kirjoitettiin.
- Tapauksessa A (luku 2) varmista, ettei kuluttajatietuetta ole synkronoidussa datassa.
10. Vianmääritys
| Oire | Todennäköinen syy |
|---|---|
| Kortissa näkyy odottamaton sähköpostiosoite | Toinen Pipedrive-tili oli kirjautuneena — katkaise yhteys, kirjaudu ulos Pipedrivesta ja yhdistä uudelleen |
| "Yhdistäminen peruutettu" | Asennus hylättiin Pipedrivessa |
| "Team already has an active Pipedrive connection. Disconnect it first." | Pipedrive-yhteys on jo olemassa |
| "You must be a team admin or owner to connect a CRM" | Pyydä Revialin ylläpitäjää tai omistajaa yhdistämään |
| "Failed to authenticate with Pipedrive" / "Failed to validate Pipedrive access" | Kirjautuminen keskeytyi tai tunnisteen tarkistus epäonnistui — yritä uudelleen |
| "Invalid or expired state" | Kirjautumiseen kului yli viisi minuuttia — aloita alusta |
| Monia diilejä puuttuu synkronoinnin jälkeen | Valtuuttava käyttäjä ei näe niitä — tarkista käyttöoikeusjoukko ja näkyvyysryhmät |
| "CRM: Authentication expired" ja kortissa lukee Ei yhdistetty | Sovellus poistettiin tai käyttäjä poistettiin käytöstä — yhdistä uudelleen |
| Kaikki muistiinpanot on merkitty yhdelle henkilölle | Odotettua — katso luku 5 |
| Mäpättyä kenttää ei päivitetä | Väärä kenttä tai arvo ei sovi kentän tyyppiin — Revial raportoi kenttäkohtaisen virheen |
| Diilien vaiheet näkyvät numeroina | Tunnettu rajoitus — katso Mitä Revial synkronoi Pipedriven kanssa |
| Synkronoinnit epäonnistuvat suurella tai kiireisellä tilillä | Pipedriven rate limitit — synkronointi ei hidasta, ja epäonnistuneet vaiheet yritetään uudelleen |
11. Kysymykset, jotka kannattaa ottaa esille ennen yhdistämistä
- Kuluttaja- ja yritystietueesi erotetaan vain kentän arvolla (tapaus C).
- Tarvitset myyjäkohtaisen tekijätiedon Pipedriveen kirjoitetuille muistiinpanoille.
- Haluat rajata Revialin tiettyihin pipelineihin.
- Tarkastuksesi edellyttää luvun 4 käyttämättömien scopejen poistamista.
HubSpotin tekninen integraatio-opas
HubSpot-ylläpitäjille, tietoturva-arvioijille ja IT:lle — miten Revialin molemmat HubSpot-sovellukset todentavat, API-kulutus, puheluanalyysin käsittelyketju, virhetilanteet ja auditointi.
Mitä Revial synkronoi Pipedriven kanssa
Pipedrive-ylläpitäjällesi ja sille, joka arvioi integraation tietojen käyttöoikeudet — jokainen Pipedrive-kenttä, jonka Revial lukee, kaikki mitä se kirjoittaa takaisin ja tunnetut puutteet.