3.1 VIESTIRAJAPINNAN PALVELUKUVAUS 1 Teksti- ja multimediaviestintää Viestirajapinnalla Soneran Palvelutuotannon Ratkaisun Viestirajapinta on TeliaSonera Finland Oyj:n (jäljempänä Sonera) asiakkailleen tarjoama teksti- ja multimediaviestien välityspalvelu, joka mahdollistaa tekstiviestien ja multimediaviestien lähettämisen ja vastaanottamisen päätelaitteitten ja yrityksen tietojärjestelmän välillä. Käyttämällä Viestirajapintaa yritys (jäljempänä Palveluntarjoaja) voi toteuttaa monipuolisia teksti- ja multimediaviesteihin perustuvia erityismaksullisia palveluja Soneran matkapuhelinasiakkaille (jäljempänä Loppukäyttäjä). Viestirajapintaan liitettävällä Laskutuspalvelulla Palveluntarjoaja voi toteuttaa Loppukäyttäjille maksullisia palveluja. Laskutuspalvelu sisältää tulonjaon Palveluntarjoajalle. Esimerkkejä Viestirajapinnalla toteutetuista palveluista: Eritysmaksulliset teksti- ja multimediaviestipalvelut Matkapuhelinten personointi: soittoäänet, taustakuvat, näytönsäästäjät, logot Viihdepalvelut: horoskoopit, vitsit, chatit, aikuisviihdepalvelut Informaatiopalvelut: aikataulut, kartat, tapahtumakalenterit, luettelot, tietopankit Nopean tiedonvälityksen palvelut: uutiset, talousinformaatio, urheilutulokset Markkinointi (Suoramarkkinointi matkapuhelimeen edellyttää Loppukäyttäjän kirjallista lupaa) Asiointipalvelut: asiakaspalvelu-, tilaus- ja palvelukanava, asiointi- tai tilauspalvelusta laskutetaan tekstiviestillä Loppukäyttäjän paikkatietoon perustuvat palvelut 2 Viestirajapinnan toimintaympäristö Viestirajapinta koostuu Content Gateway palvelinohjelmistosta, sanomaliikenneyhteydestä, laskutuspalvelusta ja sen lisäpalveluista, yhdestä tai useammasta lyhytsanomanumerosta (jäljempänä lyhytnumero) sekä Palveluntarjoajan hallitsemista sovelluksista. Content Gateway Palveluntarjoaja kytketään Soneran sanomienvälitysjärjestelmään Content Gateway palvelinohjelmistolla (jäljempänä CGW). Palvelinohjelmisto, asennus- ja käyttöohjeet sekä ohjeet palveluiden toteutukseen löytyvät Soneran Internet-sivuilta. CGW sisältää työkalut Viestirajapinnan tarjoamiin palveluihin ja ominaisuuksiin: tekstiviestintä, multimediaviestintä, erilaiset palvelutyyppi- ja laskutuspalveluvaihtoehdot, paikkatiedon välitys sekä valvontapalvelu. CGW jakautuu Soneran hallitsemaan Content Gateway Operator Serveriin (jäljempänä CGW-OS) ja Palveluntarjoajan hallitsemaan Content Gateway Provider Serveriin (jäljempänä CGW-PS). Palveluntarjoajan PS:n ja Soneran OS:n välisessä liikenteessä käytetään DES-salausta. Tarvittaessa vahvempi autentikointi on mahdollista SSLsalauksella. CGW toimii viestien välittäjänä, joka ohjaa matkapuhelimista lähetetyt viestit Palveluntarjoajan sovelluksille ja päinvastoin. Soneran matkapuhelimista lähetetyt viestit reititetään lyhytnumeron ja mahdollisen hakusanan perusteella CGW-OS:ltä Palveluntarjoajan CGW-PS:lle Palveluntarjoajan ilmoittamaan kiinteään IP-osoitteeseen.
Viestejä välitettäessä tietojärjestelmästä päätelaitteelle Palveluntarjoajan on käytettävä hallinnassaan olevaa lyhytnumeroa lähettäjän numerona. CGW OS sovellukset palomuuri CGW PS inter- net palomuuri Palvelujen toteutus ja hallinta Palveluntarjoaja vastaa sovellusten rakentamisesta, kehittämisestä, toiminnasta ja niiden liittämisestä CGW:hin, sekä sovellusten ylläpidosta ja sovellusten käyttöoikeuksien hallinnasta. Sovellusten ja Palveluiden toteutuksessa on noudatettava CGW:n rajapintamäärittelyä ja muita Soneran antamia ohjeita (mm. Content Gateway Guide for Service Development, Content Gateway Käyttöönotto- ja laskutusohje). Palveluja hallitaan Remote Control web -käyttöliittymällä, jota käyttäen Palveluntarjoaja voi asettaa myös Palvelujen loppukäyttäjähinnat, mikäli Viestirajapintaan on kytketty Laskutuspalvelu. Palveluntarjoaja voi aloittaa palvelujen testaamisen heti, kun CGW palvelinohjelmisto on asennettu. Sanomaliikenneyhteyden sallivan lisenssin kytkemiseksi Palveluntarjoajan tulee allekirjoittaa Soneran Palvelutuotannon Ratkaisu sopimus ja sen liite 1.1 Viestirajapinnan yhteys- ja palvelutiedot. Kaikki Palveluissa välitettävät viestit laskutetaan Palveluntarjoajalta hinnaston mukaisesti. Palveluntarjoajan toimintaedellytykset Palveluntarjoajalla on oltava TCP/IP protokollaa tukeva palvelin, johon CGWohjelmiston tarvittavat osat asennetaan. Palveluntarjoaja vastaa oman järjestelmänsä asentamisesta ja ylläpidosta. Tarkemmin laitteisto- ja ohjelmistovaatimuksista kerrotaan CGW-ohjelmiston käyttöohjeessa. Palvelutuotannon ratkaisun Viestirajapinnan käyttöön tarvitaan kiinteä julkinen IPosoite joko Internet- tai Soneran DataNet -yhteyden kautta. Dataosoite tulee olla sopi-
3 Laskutuspalvelu LIITE 3.1 Viestirajapinnan palvelukuvaus 12.05.2011 muksen tehneen asiakkaan hallinnassa. Datayhteys ei sisälly Palvelutuotannon ratkaisu palveluun. Palveluntarjoajan toimintaedellytyksistä lisää Palvelutuotannon ratkaisun sopimusehdoissa. Lyhytnumero Loppukäyttäjälle näkyvä Palveluntarjoajan osoite ja tunniste on Viestintäviraston (www.ficora.fi) hallinnoima lyhytnumero. Palveluntarjoaja voi anoa lyhytnumeron suoraan Viestintävirastolta tai pyytää sopimuksessa Soneraa anomaan lyhytnumeron. Myönnetty numero varataan Palveluntarjoajan käyttöön kaikissa yleisissä matkaviestinverkoissa Suomessa. Lyhytnumeroa varattaessa ja käytettäessä on otettava huomioon Viestintäviraston määräykset lyhytnumeroista ja palvelusisällöstä. Viestintävirasto laskuttaa Palveluntarjoajaa lyhytnumeroiden käyttöoikeudesta oman hinnastonsa mukaisesti. 3.1. Loppukäyttäjän laskuttaminen Kun Laskutuspalvelu on kytketty, Sonera laskuttaa Loppukäyttäjiä palvelutapahtumiin perustuen Palveluntarjoajan määrittämillä hinnoilla ja tulouttaa Palveluntarjoajalle tämän osuuden sopimusehtojen ja Soneran voimassa olevan hinnaston mukaisesti. Viestirajapinnan Laskutuspalvelusta sovitaan Palvelutuotannon Ratkaisu sopimuksen liitteellä 1.1 Viestirajapinnan yhteys- ja palvelutiedot. Laskutuspalvelu sisältää 3 vaihtoehtoa Loppukäyttäjän veloitukseen: 1. MO viestiin (Mobile Originated viesti) perustuva laskutus: Loppukäyttäjää laskutetaan päätelaitteelta tietojärjestelmään lähetetystä viestistä. MO viestiin perustuva laskuttaminen toteutetaan CGW:n palvelutyypillä receive only. 2. MT viestiin (Mobile Terminated viesti) perustuva laskutus: Palveluntarjoajan asettama perushinta laskutetaan Loppukäyttäjältä, kun palvelutapahtuma päättyy. Palveluntarjoaja voi ohjata Loppukäyttäjän laskutusta alittamalla Palvelulle määritellyn hinnan paluuviestissä kirjoittamalla hintakenttään Loppukäyttäjältä laskutettavan hinnan. Hinta ilmoitetaan hintakoodilla, joka vastaa Palvelun arvonlisäverotonta loppukäyttäjähintaa. MT-viestiin perustuva laskuttaminen toteutetaan CGW:n palvelutyypillä query/reply. 3. Push-laskutus: Loppukäyttäjää laskutetaan hänen vastaanottamistaan viesteistä. Loppukäyttäjä tilaa jatkuvaluonteisen push-palvelun lähettämällä viestin Palveluun. Sonera ilmoittaa tilaajalle tekstiviestillä Palvelun nimen, Palvelun maksimihinnan sekä ohjeet Palvelun sulkemisesta. Tilauksen jälkeen Palveluntarjoaja voi lähettää Palveluviestejä kunnes tilaaja sulkee palvelun. Loppukäyttäjältä laskutetaan Palveluntarjoajan palvelulle asettama hinta, jos Palveluntarjoaja ei ilmoita alentavaa hintatietoa. Push-laskutus toteutetaan CGW:n palvelutyypillä push. Loppukäyttäjähinnan asettaminen Palveluntarjoaja asettaa perushinnan kaikille Palveluille CGW:n Remote Control web - käyttöliittymällä. Hinta asetetaan Palvelukohtaisesti ilman arvonlisäveroa. Palvelun
loppukäyttäjähinnaksi voidaan asettaa 0,00 2,00 euroa arvonlisäveron käsittelyyn liittyvät rajoitteet huomioon ottaen. Palveluntarjoajan Palvelulle asettama perushinta laskutetaan Loppukäyttäjältä aina onnistuneesta palvelutapahtumasta. Jos Palveluntarjoaja päättää tapahtuman epäonnistuneeksi esimerkiksi virheellisen hakusanan johdosta, Loppukäyttäjää ei laskuteta tapahtumasta. Teknisessä ohjeessa kerrotaan Palveluntarjoajan mahdollisuuksista ohjata laskutusta. Palveluntarjoajan tulee varmistaa, että Loppukäyttäjää ei laskuteta saamatta jääneestä sisällöstä korkeimmalla mahdollisella Palvelun hinnalla. Mo-laskutuksessa käytetään laskutuksen ohjaamisessa CGW-kuittauksia. Mt- ja pushlaskutuksessa Palveluntarjoaja voi viestikohtaisesti alentaa Loppukäyttäjältä veloitettavaa hintaa. Palvelulle määritelty hinta alennetaan paluuviestissä kirjoittamalla hintakenttään Loppukäyttäjältä laskutettavan hinta. Hinta ilmoitetaan hintakoodilla, joka vastaa Palvelun arvonlisäverotonta loppukäyttäjähintaa. Ohjeet loppukäyttäjähinnan asettamiseen ja muuttamiseen sekä palvelutapahtuman keskeyttämiseen kuvataan Content Gateway käyttöönotto- ja laskutusohjeessa. Hintatiedotteelliset palvelut 2,01 20,00 euron hintaisten Palveluiden hinnat asetetaan Soneran asiakaspalvelussa palvelukohtaisesti. Samalla Palveluihin kytketään palvelutunnistekohtainen hintatiedote. Sonera noudattaa Teleforum ry:ssä sovittua toimialalle yhteistä Palvelujen hintatiedoterajaa. Arvonlisävero Palveluissa käsitellään Loppukäyttäjähintoina arvonlisäverottomia hintoja. Sonera lisää Palveluntarjoajan ilmoittamaan hintaan oletusarvoisesti arvonlisäveroa 22 %. Muut arvonlisäverokannat kytketään Soneran asiakaspalvelussa palvelutunnistekohtaisesti. Loppukäyttäjälle maksuttomat Palvelut Palveluntarjoaja voi toteuttaa Loppukäyttäjälle maksuttoman Palvelun eri tavoilla: 1. Käyttämällä Palvelussa 18-alkuista lyhytnumeroa: Viestintäviraston määräyksen mukaisesti Loppukäyttäjille maksuttomille Palveluille tarkoitetuissa 18-alkuisissa lyhytnumeroissa ei saa tarjota Loppukäyttäjille maksullisia Palveluja. 2. Asettamalla Loppukäyttäjähinnaksi 0,00 minkä tahansa hallinnassaan olevan palvelunumeron kautta tarjoamassaan Palvelussa. 3. Viestirajapinnan voi valita myös ilman laskutuspalvelua, jos Palvelusta ei haluta laskuttaa Loppukäyttäjiä. Viestirajapinta ilman laskutuspalvelua ei sisällä tuloutusta. Loppukäyttäjälle maksuttomissa Palveluissa viestien lähettäminen Palveluntarjoajan lyhytnumeroihin on Loppukäyttäjille maksutonta ja Palveluntarjoaja maksaa Palvelussa välitettävät viestit. Ohjeiden noudattaminen
4 Push-palvelu LIITE 3.1 Viestirajapinnan palvelukuvaus 12.05.2011 Laskutuspalvelun toteutuksessa on noudatettava Soneran antamia ohjeita (mm. Content Gateway Guide for Service Development, Content Gateway Käyttöönotto- ja laskutusohje). Loppukäyttäjän laskuttaminen tulee aina testata ennen uuden Palvelun käyttöönottamista. Soneran yleisten ehtojen (Soneran palveluiden yleiset toimitusehdot yritysasiakkaille) kohdan 11.2 mukaan Soneralla on oikeus sulkea Palveluntarjoajan palvelu, jos Palveluntarjoaja ei muistutuksista huolimatta täytä esimerkiksi loppukäyttäjälaskutukseen tai palveluiden estojen toteuttamiseen liittyviä sopimusvelvoitteitaan. CGW:n Push-palvelutyypillä voidaan toteuttaa Palveluja, joissa laskuttaminen perustuu Loppukäyttäjän vastaanottamiin viesteihin. Palveluntarjoaja voi toteuttaa Loppukäyttäjälaskutuksen viestikohtaisesti tai aikajaksoon perustuen esimerkiksi lähettämällä Loppukäyttäjälle yhden maksullisen viestin määrittelemänsä aikajakson aikana. Jos Palveluntarjoaja toteuttaa aikajaksoon perustuvan jatkuvan Palvelun, on Soneran asiakaspalvelulle ilmoitettava laskutusperusteesta. Yli 2,00 :n (2,01-20,00 ) push-palvelujen hinta asetetaan Soneran asiakaspalvelussa. Palveluntarjoajan on ilmoitettava push-palvelun hinnanmuutoksesta Soneran asiakaspalveluun. Palveluntarjoajan on lisättävä jokaiseen Loppukäyttäjälle lähetettyyn push-viestiin Palveluntarjoajan nimi ja/tai Palveluntarjoajan Internet-osoite. Yhdelle jatkuvan Palvelun tilaajalle voi lähettää vuorokauden aikana korkeintaan30 push-viestiä. Palveluntarjoajan on tarjottava Loppukäyttäjälle mahdollisuus sulkea palvelu hänen käyttämäänsä tilauskanavaa käyttäen. Sulkemisen jälkeen Palveluntarjoajan on poistettava Loppukäyttäjän tiedot palvelusta sekä ilmoitettava palvelun sulkenut Loppukäyttäjä välittömästi Soneralle CGW:n rajapintamääritysten mukaisesti ja lopetettava push-viestien lähettäminen. Palveluntarjoajan on ilmoitettava palvelua markkinoidessaan selvästi palvelun tilaamisen kokonaiskustannukset, joissa huomioidaan viestikohtainen hinta sekä viestien määrä tietyllä ajanjaksolla. Jos palvelun hinta muuttuu kesken sopimuskauden, Palveluntarjoajan on ilmoitettava muutoksesta kaikille palvelun senhetkisille tilaajille. 5 Paikkatiedon välitys ominaisuus Viestirajapinnan paikkatiedon välitys -ominaisuuden avulla Palveluntarjoaja voi toteuttaa Loppukäyttäjän sijaintitietoa hyödyntäviä palveluja. Kun Palveluntarjoaja on kytkenyt Paikkatiedon välitys ominaisuuden, välitetään Loppukäyttäjän WGS84- järjestelmän mukainen koordinaattitieto, arvio paikkatiedon tarkkuudesta, postinumero sekä kuntatieto Palveluntarjoajalle. Tieto välitetään kun Loppukäyttäjä lähettää Palveluntarjoajan määrittelemän hakusanan Palveluntarjoajan lyhytnumeroon. Paikkatiedon välitys on palvelukohtainen ominaisuus, joka perustuu palvelutunnisteeseen. Paikkatiedon välitystä hyödyntävä palvelu voi olla samassa lyhytnumerossa kuin muut palvelut. Loppukäyttäjän matkapuhelinnumeroa ei välitetä tapahtuman yhteydessä Palveluntarjoajalle. Paikkatieto voidaan välittää vain Soneran matkapuhelinverkkoon liittyneistä
6 Multimediaviestintä 7 Valvontapalvelu LIITE 3.1 Viestirajapinnan palvelukuvaus 12.05.2011 liittymistä. Paikkatieto perustuu matkapuhelimen käyttämän matkapuhelinverkon tukiaseman solun peittoalueen sijaintiin. Paikannuksen tarkkuus riippuu tukiasemaverkon tiheydestä ja solun peittoalueen koosta. Tiheän tukiasemaverkon alueella paikannuksen tarkkuus voi olla noin 200-2 000 metriä, mutta tarkkuus on huomattavasti heikompi alueilla, joissa tukiasemia on harvemmassa. Käytettävästä paikannustekniikasta johtuen välitettävä paikkatieto ei aina vastaa Loppukäyttäjän maantieteellistä sijaintia. Paikantavaa palvelua markkinoitaessa tai muuten palvelusta Loppukäyttäjälle kerrottaessa, Palveluntarjoajan tulee ilmoittaa Loppukäyttäjälle tästä ominaisuudesta erityisehdoissa määritellyllä tavalla. Paikkatiedon välitykseen sovellettavat erityisehdot ovat Palvelutuotannon Ratkaisu sopimuksen liitteenä 4.Paikkatiedon välitys ominaisuuden erityisehdot. Multimediaviestintää varten CGW sisältää Nokian multimediaviestikeskuksen EAIF rajapintaa muistuttavan HTTP-rajapinnan. Sovelluskehitystä varten tarvitaan Nokian Java API kirjasto tai muu ohjelmisto, joka käsittelee viestejä Nokian multimediaviestikeskuksen ymmärtämässä muodossa. Sonera ei vastaa Nokian MMSC Java APIn toiminnasta tai ohjeista. Palveluiden toteuttamisessa kannattaa käyttää aina uusinta kirjastoa. Viestirajapinnan kautta lähetettävien viestin koko on rajoitettu 100 kilotavuun. Viestejä lähetettäessä vastaanottavan Loppukäyttäjän matkapuhelinnumero on oltava kansainvälisessä muodossa (+358401234567) Multimediaviestinnässä Soneralla on oikeus muokata tarvittaessa sisältöä sisällön tehokkaan välittämisen edellyttämässä laajuudessa. Sisällön sovittaminen on Soneran sanomanvälitysjärjestelmän multimediaviestikeskuksen ominaisuus, joka parantaa mahdollisuutta toimittaa multimediaviesti vastaanottavaan päätelaitteeseen. Ominaisuus ottaa huomioon päätelaitteen ominaisuudet käsitellä multimediaviestejä ja sovittaa tarvittaessa sisällön päätelaitteeseen sopivaksi. Sovitus tehdään pääasiassa viestin kokoa tai kuva-aineiston kokoa pienentämällä niin, että viesti välitetään vastaanottajalle niin korkealaatuisena, kuin päätelaitteen ominaisuudet sallivat. Tarvittaessa osa sisällöstä poistetaan kokonaan, jos vastaanottava päätelaite ei tue tiedostotyyppiä. Sisällön sovittaminen vaikuttaa vain tietojärjestelmästä päätelaitteelle lähetettyihin viesteihin. Sisällön sovittamisen voi estää viestikohtaisesti noudattamalla teknistä ohjetta. Ne Palveluntarjoajan lähettämät multimediaviestit, joiden vastaanottajalla ei ole käytössään Soneran MMS-palvelua, välitetään Soneran Viestikeskus- palveluun. Viestikeskukseen välitetyistä viesteistä ilmoitetaan Loppukäyttäjälle tekstiviestillä. Palveluntarjoajan palveluja voidaan käyttää myös Soneran verkon ulkopuolelta niiden operaattoreiden matkapuhelinverkossa, jotka ovat sopineet Soneran kanssa verkkovierailusta. CGW sisältää valinnaisena ominaisuutena valvontapalvelun. Valvontapalvelu valvoo teknistä yhteyttä CGW OS:n ja PS:n välillä ja raportoi havainnoistaan sähköpostilla PS kohtaisesti Palveluntarjoajan ilmoittamaan sähköpostiosoitteeseen.
Palveluntarjoaja voi kytkeä valvontapalvelun käyttöönsä CGW Remote Control web käyttöliittymästä, jossa myös ilmoitetaan sähköpostiosoite valvontapalvelun lähettämille ilmoituksille. Valvonta perustuu CGW:stä sekä palveluympäristöstä saataviin virhe- ja häiriötietoihin. Valvontapalvelussa ei välitetä teksti- tai multimediaviestejä OS:n ja PS:n välillä.