Salesforce-integraation asennus- ja käyttöohje
Sisällysluettelo emaileri-integraation edellyttämät objektimuutokset... 3 Jakelulista-objektin muutokset... 3 Jakelulista-objekti / Näytä emailerissa -valinnan määritys... 3 Yhteystieto-Jakelulista -suhdeobjektin muutokset... 4 Yhteystieto-Jakelulista -suhdeobjekti/ Lisäkenttien määritys... 5 emaileri - Salesforce -integraation määritys Salesforcessa... 6 Yhdistetyn sovelluksen luominen... 6 emaileri - Salesforce -integraation määritys emailerissa... 7 Mistä löydät emailerissa tarvittavat Salesforce -integraatioasetukset... 7 Salesforce -moduulin toiminnot emailerissa... 8 Salesforce-jakelulistat näkymä... 8 Salesforce-rajapinnan kirjautuminen ei toimi... 8 Uuden Salesforce-jakelulistan päivitys emaileriin... 8 Uuden Salesforce-jakelulistan jäsenien päivitys... 8 Postituskieltojen hallinta... 9 Postituskieltojen siirtyminen emailerista Salesforceen... 9 Kiellon tehneen jäsenen poistuminen jakelulistalta emailerissa... 9 Postituskiellot ovat virastokohtaisia... 9 Uutiskirjeen lähetys Salesforce-jakelulistaan... 10 Postituskieltojen näkyminen Salesforcessa... 11
emaileri-integraation edellyttämät objektimuutokset Salesforce -ympäristöön tarvitaan emaileri-integraatiota varten muutamia lisäkenttiä Jakelulista- sekä Yhteystieto-Jakelulista-suhde -objekteihin. Jakelulista-objektin muutokset Jakelulista -objektiin lisätään Näytä emailerissa -valinta, jolla määritetään mitkä jakelulista näkyvät ja ovat synkronoitavissa emaileriin. Jakelulista-objekti / Näytä emailerissa -valinnan määritys Alla kuvakaappaus, jossa näkyy Näytä emailerissa -valinnan asetukset.
Yhteystieto-Jakelulista -suhdeobjektin muutokset Yhteystieto-Jakelulista-suhdeobjektiin lisätään virastokohtaiset Postituskielto -valinnat sekä Postituskielto asetettu -tekstikenttä. Alla luettelo kaikista Yhteystieto-Jakelulista-suhdeobjektiin lisättävistä kentistä ja niiden nimeäminen.
Yhteystieto-Jakelulista -suhdeobjekti / Lisäkenttien määritys Alla kuvakaappaus, jossa näkyy Postituskielto sekä Postituskielto asetettu -kentän asetukset STM:n osalta. Kaikki muut virastot luodaan vastaavalla tavalla, mutta kentän nimessä pitää olla formaatti unsub_### sekä unsub_info_###, jossa ### korvataan ko. viraston nimellä pienellä kirjoitettuna.
emaileri - Salesforce -integraation määritys Salesforcessa Salesforce -ympäristöön täytyy määrittää uusi Yhdistetty sovellus, jossa aktivoidaan OAuth-asetukset käyttöön sekä määritetään rajapinnan OAuth-näkyvyysalueet. Yhdistetyn sovelluksen luominen Uusi Yhdistetty sovellus luodaan seuraavasti: 1. Napsauta selainnäkymän yläosasta oikealta kohtaa Määritykset. 2. Napsauta vasemmalla näkyvästä valikosta kohtaa Laadi >> Luo >> Sovellukset. 3. Napsauta Yhdistetyt sovellukset -listan yllä olevaa [ Uusi ] -painiketta, jolloin näyttöön avautuu määrityslomake. 4. Lomakkeella on paljon erilaisia kenttiä ja asetuksia, mutta Emaileri -sovelluksen määrityksessä tarvitaan vain seuraavat asetukset: 5. Aseta lomakkeelle em. mallin mukaiset asetukset ja napsauta [ Tallenna ] -painiketta, jolloin Yhdistetty sovellus (Emaileri) tallennetaan.
emaileri - Salesforce -integraation määritys emailerissa Kun Salesforce -ympäristöön on määritetty uusi Yhdistetty sovellus (Emaileri), voidaan sovelluksen asetuksista nähdä emailerissa Salesforce-integraatioasetuksiin tarvittavat tiedot. Mistä löydät emailerissa tarvittavat Salesforce -integraatioasetukset Kun uusi Yhdistetty sovellus (Emaileri) on luotu, näkyy se Yhdistetyt sovellukset -listassa. Napsauttamalla listassa Yhdistetyn sovelluksen nimi (Emaileri) -linkkiä, näyttöön avautuu näkymä, josta saadaan Kuluttaja-avain (Client ID) ja kuluttajasalaisuus (Client Secret) -arvot. Näiden arvojen lisäksi emaileriin tarvitaan rajapintaa käyttävän lisenssin käyttäjätunnus (Username) sekä salasana (Password), jossa salasanan perään tulee emailerissa asettaa Client Secret -arvo. emailerissa käyttäjä ei pääse itse päivittämään näitä asetuksia vaan ne tehdään ja testataan aina emailerin asiakaspalvelun kautta.
Salesforce -moduulin toiminnot emailerissa Salesforce-jakelulistat näkymä Jos emaileri-käyttäjän tiliin on määritetty Salesforce-integraatio, näkyy palvelun päävalikon Asiakashallintaosassa Salesforce -toiminto, jota napsauttamalla näyttöön avautuu Salesforce-jakelulistat luettelo. Luettelossa näkyvät kaikki ne Jakelulistat, joihin on Salesforcessa asetettu Näytä emailerissa -valinta. Salesforce-rajapinnan kirjautuminen ei toimi Mikäli Salesforce -toiminto ei avaa Salesforce-jakelulistat luetteloa vaan sen sijaan ohjaa käyttäjän palvelun etusivu-näkymään, niin tällöin Salesforce -rajapinnan kirjautumisessa on tapahtunut virhe. Tällöin myös selaimen osoiterivillä näkyy SF_LOGIN_FAILED -virheilmoitus. Jos tällainen virhe tulee, kokeile uudestaan napsauttaa Salesforce toimintoa. Jos virhe toistuu, ota yhteyttä emaileri-palvelun asiakaspalveluun asiakaspalvelu@emaileri.fi tai puhelin 020 780 9220. Uuden Salesforce-jakelulistan päivitys emaileriin Salesforce-jakelulistat luettelon oikeassa yläreunassa on Hae jakelulistat -toimintolinkki. Napsauttamalla linkkiä palvelu hakee emaileriin kaikki Salesforceen luodut uudet jakelulistat, joihin on Salesforcessa asetettu Näytä emailerissa -valinta. Uuden Salesforce-jakelulistan jäsenien päivitys Salesforce-jakelulistat luettelossa näkyy rivikohtaisesti Päivitä jakelulista -toimintolinkki. Napsauttamalla linkkiä palvelu hakee emaileriin kaikki ko. jakelulistaan liitetyt jäsenet, joilla ei ole Salesforcessa jakelulistakohtaista postituskieltoa asetettuna. Päivityksen yhteydessä emailerissa jakelulistasta poistetaan kaikki ne asiakasliitokset, joita ei enää esiinny Salesforcessa tulevassa tiedossa. Eli jos jokin yhteyshenkilö poistetaan Salesforcessa jakelulistalta tai hänelle asetetaan postituskielto, niin tällöin hän poistuu myös emailerissa vastaavalta jakelulistalta.
Postituskieltojen hallinta emaileri-palvelu käsittelee Salesforce-jakelulistaan tehdyn lähetyksen postituskiellot jakelulistakohtaisesti. Jos vastaanottaja napsauttaa viestissä Peruuta uutiskirje -linkkiä, tallennetaan kielto siihen jakelulistaan, johon ko. lähetys on tehty. Postituskieltojen siirtyminen emailerista Salesforceen Postituskiellot siirretään emaileri Salesforceen aina, kun käyttäjä napsauttaa emailerissa Salesforce - toimintoa. Tällöin emaileri tunnistaa kaikki sellaiset kiellot, joita ei ole vielä siirretty ja siirtää nämä Salesforcen Bulk API -rajapinnan kautta Salesforceen. Vaikka kieltojen siirto Salesforceen tapahtuu viivästetysti, ei tästä ole haittaa, koska emaileri ei salli lähettää viestejä sellaisille jakelulistan jäsenille, joilla on kielto päällä. Kiellon tehneen jäsenen poistuminen jakelulistalta emailerissa Kun kielto on siirretty Salesforceen, kieltänyt jakelulistan jäsen ei enää ole mukana Salesforcesta emaileriin siirrettävässä kohderyhmässä. Tällöin jäsen poistetaan myös emailerissa ko. jakelulistalta. Vastaavasti, jos CRM-käyttäjä poistaa Salesforcessa jokin jäsenen jakelulistalta, niin seuraavalla kerralla, kun tämän jakelulistan jäsenet päivitetään emaileriin, poistuu ko. jäsen myös emailerissa tältä jakelulistalta. Postituskiellot ovat virastokohtaisia Postituskiellot hallitaan Salesfrocessa virastokohtaisesti eli STM:n lähetyksessä kiellon tehnyt jäsen kieltää ainoastaan STM:n postitukset, jolloin kielto ei vaikuta muiden virastojen postituksiin.
Uutiskirjeen lähetys Salesforce-jakelulistaan emailerissa uutiskirjeen lähetys Salesforce-jakelulistaan tapahtuu aivan vastaavasti kuin mihin tahansa muuhun kohderyhmään. Ainoana erona on se, että Salesforce-jakelulistaan tehtävässä lähetyksessä kohderyhmiä ei voida yhdistää eli vastaanottajajoukko muodostuu vain ko. jakelulistan jäsenistä. Alla kuvakaappaus emailerin vastaanottajien valintanäkymästä.
Postituskieltojen näkyminen Salesforcessa Salesforcessa postituskiellot näkyvät jäsen- ja virastokohtaisesti Yhteystieto-Jakelulista-suhde -näkymässä. Kiellot saadaan näkymään myös suoraan Jakelulista-näkymän Jakelulistalle kuuluvat yhteystiedot -listassa, mutta tämä edellyttää listanäkymään lisätään nämä sarakkeet Muokkaa asettelua -toiminnolla.