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.
Tällä sivulla luetellaan kenttä kentältä, mitä Revial lukee Pipedrivesta ja mitä se kirjoittaa takaisin. Yhdistämisestä, scopeista ja pääsyn peruuttamisesta kerrotaan sivulla Yhdistetään Revial Pipedriveen. Koodimuotoiset nimet ovat Pipedriven API-kenttien nimiä.
Kaikki tapahtuu yhteyden valtuuttaneen Pipedrive-käyttäjän oikeuksin, joten Revial näkee täsmälleen saman kuin kyseinen käyttäjä.
1. Miten synkronointi toimii
- Synkronointi ajetaan noin tunnin välein. Ensimmäinen lukee kaiken, seuraavat vain edellisen synkronoinnin jälkeen päivittyneet tietueet (
updated_since). - Jokaista tietuetyyppiä luetaan enintään 50 000 tietuetta synkronointia kohden.
- Revial pyytää Pipedriven vakiomuotoisen tietueen ja tallentaa sen sellaisenaan alla mäpättyjen kenttien rinnalle. Vain taulukoissa luetellut kentät ovat käytössä.
- Pipedriven poistetuiksi merkitsemät tietueet poistetaan Revialin kopiosta inkrementaalisissa synkronoinneissa.
- Yhteyden katkaiseminen poistaa Revialin synkronoiman kopion Pipedrive-datastasi.
2. Organisaatiot
| Revialissa | Pipedrive-kenttä |
|---|---|
| Nimi | name |
| Osoite | Organisaation osoitteen osat |
| Luotu / päivitetty | add_time, update_time |
Verkkosivua, puhelinta, toimialaa, henkilöstömäärää ja liikevaihtoa ei lueta Pipedriven organisaatioista.
3. Henkilöt
| Revialissa | Pipedrive-kenttä |
|---|---|
| Etu-, suku- ja koko nimi | first_name, last_name, name |
| Sähköpostiosoitteet | emails — jokainen osoite tunnisteineen; ensisijaista käytetään tunnistamiseen |
| Puhelinnumerot | phones — jokainen numero tunnisteineen |
| Titteli | job_title |
| Organisaatio | org_id |
| Viimeksi vastaanotettu / lähetetty sähköposti | last_incoming_mail_time, last_outgoing_mail_time |
| Viimeisin aktiviteetti | last_activity_date |
Kahden sähköpostin aikaleiman avulla Revial arvioi, onko diili hiljentynyt. Revial ei koskaan lue sähköpostien aiheita, sisältöä tai vastaanottajia.
4. Diilit
| Revialissa | Pipedrive-kenttä |
|---|---|
| Diilin nimi | title |
| Arvo ja valuutta | value, currency |
| Tila (avoin / voitettu / hävitty) | status |
| Voiton todennäköisyys | probability |
| Arvioitu sulkemispäivä | expected_close_date |
| Toteutunut sulkemispäivä | won_time, lost_time tai close_time, kun diili on suljettu |
| Pipeline ja vaihe | pipeline_id, stage_id |
| Vaiheeseen siirtyminen | stage_change_time |
| Viimeisin aktiviteetti | last_activity_date |
| Organisaatio ja ensisijainen henkilö | org_id, person_id |
| Kaikki osallistujat | /api/v1/deals/{id}/participants — person_id ja ensisijaisuus |
5. Pipelinet ja vaiheet
Revial lukee ensimmäisen pipelinesi vaiheet: id, name ja order_nr.
6. Aktiviteetit ja muistiinpanot
| Tyyppi | Mitä Revial lukee |
|---|---|
| Aktiviteetit (kaikki tyypit) | type, subject, note, done, due_date ja due_time, duration, location, linkitetty henkilö, organisaatio ja diili |
| Muistiinpanot | content (muunnetaan pelkäksi tekstiksi), linkitetty henkilö, organisaatio ja diili |
7. Mitä Revial ei lue
- Sähköpostien sisältöä — Revial ei pyydä sähköpostiscopea.
- Omistajia diileistä, henkilöistä, organisaatioista, aktiviteeteista tai muistiinpanoista.
- Mukautettujen kenttien arvoja — niitä ei käytetä, vaikka ne voivat sisältyä tietueen tallennettuun kopioon, jos Pipedrive palauttaa ne oletuksena.
- Tuotteita, tiedostoja tai käyttäjälistaasi. Ainoa käyttäjäkutsu on valtuuttavan käyttäjän tarkistus yhdistämisen yhteydessä.
8. Tunnetut rajoitukset lukemisessa
- Diilien vaiheet näkyvät numeroina. Revial tallentaa Pipedriven vaihetunnisteen vaiheen nimen sijaan, joten avoimia diilejä ei luokitella vaiheen mukaan.
- Vain ensimmäisen pipelinen vaiheet luetaan.
- 50 000 tietueen rajan ylittävät tietueet ohitetaan, eikä myöhempi synkronointi hae niitä.
- Diiliä, jolla ei ole valuuttaa, käsitellään euroina.
- Täydessä synkronoinnissa poistettuja tietueita ei suodateta pois, ja diili, jonka tila on
deleted, tallennetaan avoimena. - Osallistujat haetaan yhdellä pyynnöllä diiliä kohden, ja rate limit -vastaus kaataa kyseisen synkronoinnin diilivaiheen, joka yritetään sitten uudelleen.
9. Mitä Revial kirjoittaa Pipedriveen
Revial ei koskaan poista mitään Pipedrivesta, ei luo henkilöitä, organisaatioita, diilejä tai aktiviteetteja eikä muuta pipelinejä tai kenttien määrityksiä.
9.1 Tapaamisen yhteenvetomuistiinpano — automaattinen
Kun tapaamisen yhteenveto on valmis, Revial luo Pipedriveen muistiinpanon (POST /api/v1/notes), jossa on content ja yksi kentistä deal_id, person_id tai org_id:
- Sisältö: "Meeting Summary – tapaamisen otsikko", ilmoitus tekoälyn tuottamasta sisällöstä, yhteenveto organisaatiosi muistiinpanopohjan mukaisesti ja linkki tapaamiseen Revialissa. Organisaatiolle kirjoitetussa muistiinpanossa luetellaan osallistujat, joita ei löytynyt henkilöistä. Kirjoitetaan CRM-tulostekielellä, jos sellainen on asetettu. Enintään 64 kt.
- Liitetään: tunnistettuun diiliin; jos sitä ei ole, organisaatioon; jos sitäkään ei ole, yksi muistiinpano jokaiselle tunnistetulle henkilölle. Ylläpitäjät voivat muuttaa järjestystä CRM-asetuksissa.
- Ei kirjoiteta, jos yksikään Pipedrive-tietue ei vastaa tapaamista. Kirjoitetaan kerran tapaamista kohden.
- Tekijänä on valtuuttanut käyttäjä — Revial ei aseta erillistä omistajaa.
Revialin tuki voi kytkeä automaattisen kirjoittamisen pois päältä yhteyskohtaisesti.
9.2 Mäpätyt kentät — valinnainen
Ylläpitäjät voivat mäpätä Revialin yhteenvetokenttiä (myös koko litteroinnin) ja mukautettuja poimintakenttiä henkilöiden, organisaatioiden ja diilien kenttiin.
- Revial päivittää vain tunnistetun tietueen (
PATCH /api/v2/{entity}/{id}). - Kenttää, jolla on jo arvo, ei muuteta, ellei mäppäystä ole asetettu ylikirjoittamaan. Revial lukee tietueen ensin tarkistaakseen tämän.
- Arvot muunnetaan kentän tyypin mukaan; teksti enintään 64 kt.
- Mäpätä voi minkä tahansa kentän, myös vakiokenttiä — valitse mäppäykset huolella.
- Jos eräpäivitys epäonnistuu, jokaista kenttää yritetään kerran erikseen ja epäonnistumiset kirjataan.
- Tunnettu ongelma: Pipedriven v2-API saattaa odottaa mukautettuja kenttiä sisäkkäisessä rakenteessa, jota Revial ei vielä lähetä. Jos mäpättyä mukautettua kenttää ei päivitetä, ota yhteyttä Revialin tukeen.
9.3 Manuaalinen kirjoitus Revialista
Kuka tahansa tiimin jäsen voi kirjoittaa tapaamismuistiinpanon Revialista valitsemaansa henkilöön, organisaatioon tai diiliin, muokata sitä ensin ja halutessaan kirjoittaa myös mäpätyt kentät. Tämä toimii, vaikka automaattinen kirjoittaminen olisi pois päältä.
9.4 Mitä ei kirjoiteta Pipedriveen
- Litterointimuistiinpanoja — koko litterointi päätyy Pipedriveen vain mäpätyn kentän kautta.
- Uusia diilejä — diilien luonti ei ole käytettävissä Pipedrivelle.
- Aktiviteetteja ja tehtäviä.
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ä.
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.