Yhdistetään Revial Microsoft Dynamics 365:een
Instanssin URL-osoitteen löytäminen, yhdistäminen Microsoft-kirjautumisella tai Entra-palvelutilillä sekä ylläpitäjän suostumus, jonka IT-ylläpitäjäsi saattaa joutua antamaan.
CRM-integraatio otetaan käyttöön kerran koko organisaatiolle. Se toimii yhtenä identiteettinä — Dynamics-käyttäjänä tai sovelluskäyttäjänä (Application User) — ja kyseisen identiteetin Dataverse-suojausroolit määräävät, mitä Revial voi nähdä ja muuttaa.
Jokainen luettava ja kirjoitettava sarake löytyy sivulta Mitä Revial synkronoi Microsoft Dynamics 365:n kanssa. Todennusmallista, käyttöoikeuksista ja API-toiminnasta kerrotaan Dynamics 365:n teknisessä integraatio-oppaassa.
Yleiskatsaus
- Tapaamisbriiffit — rikastettuna myyntimahdollisuuden vaiheella, kontakteilla ja asiakastiedoilla Dynamicsista.
- Tapaamisten yhteenvedot — kirjoitetaan automaattisesti muistiinpanona tunnistettuun myyntimahdollisuuteen, asiakkaaseen tai kontaktiin.
- Kontaktien ja yritysten tunnistus — tapaamisen osallistujat linkitetään Dynamicsin tietueisiin.
- Diilin konteksti — avoimet myyntimahdollisuudet, vaiheet ja arvot näkyvät tapaamisten yhteydessä.
Revial synkronoi asiakkaat, kontaktit, liidit, myyntimahdollisuudet ja myyntiprosessin vaiheet. Aktiviteetteja (tapaamiset, sähköpostit, tehtävät, puhelut) ja muistiinpanoja ei synkronoida Dynamicsista.
Kaksi tapaa yhdistää
| Tapa | Sopii | Mitä tarvitaan |
|---|---|---|
| Microsoft-kirjautuminen | Useimmille organisaatioille | Dynamics-käyttäjä (mieluiten erillinen integraatiokäyttäjä) |
| Palvelutili (vain sovellus) | Organisaatioille, jotka eivät halua käyttäjätiliä mukaan | Entra-sovellusrekisteröinti ja client secret sekä sovelluskäyttäjä Dynamicsissa |
Vaatimukset
- Revial-rooli: Ylläpitäjä tai Omistaja organisaatiossasi.
- Revial-tilaus: CRM-integraation sisältävä tilaus (Medium tai Sales).
- Dataverse-oikeudet: yhdistävällä identiteetillä on oltava suojausrooli, jossa on lukuoikeus asiakkaisiin, kontakteihin, liideihin, myyntimahdollisuuksiin ja järjestelmäkäyttäjiin sekä luontioikeus muistiinpanoihin. Dynamicsin ylläpitäjäoikeuksia ei tarvita.
- Dynamics 365 -instanssisi URL-osoite, esimerkiksi
https://yourorg.crm4.dynamics.com.
Vaihe 1 — Etsi instanssisi URL-osoite
Avaa Dynamics selaimessa ja kopioi osoite .dynamics.com-loppuun asti. Osoite on muotoa https://yourorg.crmN.dynamics.com, jossa aluepääte riippuu datakeskuksesta — esimerkiksi crm Pohjois-Amerikka, crm4 EMEA (myös Suomi), crm11 Yhdistynyt kuningaskunta.
Revial hyväksyy minkä tahansa crmN-alueen. Polut ja lopun kauttaviivat poistetaan automaattisesti; osoitteen on käytettävä HTTPS:ää.
Vaihe 2 — Avaa CRM-integraatiot
- Siirry Revialissa kohtaan Organisaatio → CRM-integraatiot.
- Etsi Microsoft Dynamics 365 -kortti (Ei yhdistetty).
Vaihe 3a — Yhdistä Microsoft-kirjautumisella
- Liitä URL-osoite kenttään Syötä Dynamics 365 -URL-osoitteesi.
- Napsauta Yhdistä Microsoftin kautta.
- Valitse Microsoft-tili, jota integraatio käyttää, ja kirjaudu.
- Tarkista pyydetyt käyttöoikeudet ja napsauta Accept.
Jos Microsoft näyttää viestin "Need admin approval", IT-ylläpitäjäsi on ensin annettava Revialille suostumus Microsoft Entrassa — katso alla.
Revial tarkistaa yhteyden Dataversen WhoAmI-kutsulla ja lukee käyttäjän nimen ja sähköpostiosoitteen ennen tallennusta.
Vaihe 3b — Yhdistä palvelutilillä (vain sovellus)
Entra-ylläpitäjäsi luo ensin:
- Yhden vuokraajan sovellusrekisteröinnin ja sille client secretin. Se ei tarvitse API-käyttöoikeuksia eikä uudelleenohjausosoitetta.
- Sovelluskäyttäjän (Application User) Dynamicsiin kyseiselle sovellukselle oikeaan liiketoimintayksikköön ja suojausroolin, joka kattaa yllä kuvatut oikeudet.
Sitten Revialissa:
- Napsauta Yhdistä palvelutilillä (vain sovellus).
- Syötä Dynamics-URL, Application (client) ID, Client secret ja Directory (tenant) ID (GUID).
- Napsauta Yhdistä palvelutili.
Revial hakee tunnisteen ja suorittaa WhoAmI-kutsun ennen kuin mitään tallennetaan. Client secret tallennetaan salattuna.
Vaihe 4 — Tarkista yhteys
Kortissa näkyy Yhdistetty ja Microsoft-käyttäjän sähköpostiosoite — tai "Yhdistetty palveluperiaatteella (sovelluskäyttäjä)" — instanssin URL-osoite sekä painikkeet Synkronoi nyt ja Katkaise yhteys.
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ä kohdassa Organisaatio → CRM-asetukset. Synkronoi nyt käynnistää synkronoinnin heti.
Microsoft Entra — ylläpitäjän suostumus (vain Microsoft-kirjautuminen)
Jos vuokraajasi ei salli käyttäjien antaa suostumusta sovelluksille itse, käyttäjä näkee viestin "Need admin approval", ja pyyntö siirtyy Entran kohtaan Admin consent requests.
- Kirjaudu Microsoft Entra -hallintakeskukseen Global Administrator- tai Application Administrator -oikeuksin.
- Siirry kohtaan Enterprise applications → Admin consent requests.
- Etsi Revial — se näkyy ensimmäisen yhdistämisyrityksen jälkeen.
- Avaa Permissions, napsauta Grant admin consent ja vahvista.
Suostumus kattaa Revialin delegoidun pääsyn Dynamics 365:een kirjautuneena käyttäjänä. Suostumus koskee kaikkia vuokraajan käyttäjiä — käy se läpi tietoturvatiimisi kanssa. Palvelutilitapa ei vaadi suostumusta.
Yhteyden hallinta
Synkronointi — kortin Synkronoi nyt käynnistää synkronoinnin; CRM-asetusten 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 Katkaise yhteys ja vahvista. Revial pysäyttää synkronoinnin ja poistaa taustalla synkronoidun kopion Dynamics-datastasi, tallennetut tunnisteet tai client secretin sekä kenttien mäppäykset. Revialin jo kirjoittamat muistiinpanot jäävät Dynamicsiin.
Yhteyden katkaiseminen Revialissa ei peruuta mitään Microsoftin puolella. Päätä käyttöoikeus poistamalla Revialin yrityssovellus Entrasta (Microsoft-kirjautuminen) tai poistamalla client secret tai sovelluskäyttäjä käytöstä (palvelutili).
Uudelleen yhdistäminen — uutta Dynamics-yhteyttä ei voi muodostaa, kun yhteys on olemassa. Virhetilassa olevan yhteyden voi yhdistää uudelleen Microsoft-kirjautumisella, mutta yhteyden asetukset (kuten tapaamismääritykset) nollautuvat. Palvelutilin secretin vaihtaminen edellyttää tällä hetkellä yhteyden katkaisemista ja uudelleen yhdistämistä, jolloin data poistetaan ja synkronoidaan uudelleen.
Muita CRM-järjestelmiä voi yhdistää Dynamicsin rinnalle.
Vianmääritys
Yhteysvirheet
| Viesti | Mitä tehdä |
|---|---|
| "Need admin approval" | IT-ylläpitäjän on annettava suostumus Entrassa — katso yllä |
| "Yhdistäminen peruutettu" | Käyttöoikeus evättiin Microsoftin näkymässä |
| "Invalid Dynamics 365 URL format. Expected format: https://yourteam.crm4.dynamics.com" | Käytä selaimen osoiteriviltä https://yourorg.crmN.dynamics.com -osoitetta |
| "URL must use HTTPS" | Aloita osoite https:// |
| "Failed to authenticate with Dynamics 365" | Kirjautuminen keskeytyi — yritä uudelleen |
| "Failed to validate Dynamics 365 access" | Tilillä ei ole Dataverse-suojausroolia tai lisenssiä tähän instanssiin |
| "Invalid or expired state" | Kirjautumiseen kului yli viisi minuuttia — aloita alusta |
| "Team already has an active Dynamics 365 connection. Disconnect it first." | Dynamics-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 |
| "tenant_id must be the customer Entra tenant GUID" | Syötä Directory (tenant) ID GUID-muodossa |
| "Could not authenticate with these credentials…" | Tarkista client ID, secret, tenant-GUID ja että sovelluskäyttäjällä on pääsy tähän instanssiin |
| "A Dynamics 365 connection already exists for this team…" | Katkaise olemassa oleva Dynamics-yhteys ensin |
Synkronointiongelmat
| Oire | Mitä tehdä |
|---|---|
| Dataa puuttuu synkronoinnin jälkeen | Yhdistävän identiteetin suojausrooli ei kata näitä tietueita |
| Synkronointi pysähtyy yhteen tauluun | Identiteetiltä puuttuu lukuoikeus tauluun tai taulun muutosten seuranta ei ole käytössä |
| Ilmoitus "CRM: Authentication expired" | Kirjautumisen käyttöoikeus peruutettiin — katkaise yhteys ja yhdistä uudelleen |
| Ilmoitus "CRM: App credential invalid" | Palvelutilin secret vanheni tai poistettiin — sitä ei korjata yhdistämällä samalla secretillä; luo uusi ja yhdistä uudelleen |
Pikaopas — yhdistäminen
- Kopioi Dynamics-osoite selaimen osoiteriviltä.
- Revial → Organisaatio → CRM-integraatiot → Microsoft Dynamics 365.
- Liitä osoite ja napsauta Yhdistä Microsoftin kautta — tai käytä palvelutilivaihtoehtoa.
- Kirjaudu ja hyväksy. Jos näet viestin "Need admin approval", välitä yllä oleva suostumusosio IT-ylläpitäjällesi.
- Tarkista, että kortissa lukee Yhdistetty. Ensimmäinen synkronointi käynnistyy automaattisesti.
Salesforcen tekninen integraatio-opas
Salesforce-ylläpitäjille, tietoturva-arvioijille ja IT:lle — miten Revial todentaa, mitä se lukee ja kirjoittaa, tarvittavat oikeudet, API-kulutus, virhetilanteet ja auditointi.
Mitä Revial synkronoi Microsoft Dynamics 365:n kanssa
Dynamics-ylläpitäjällesi ja sille, joka arvioi integraation tietojen käyttöoikeudet — jokainen Dataverse-sarake, jonka Revial lukee, kaikki mitä se kirjoittaa takaisin ja tunnetut puutteet.