Tukipalvelu


inschool.fi(at)supportvisma.com

Visma Community


https://community.visma.com/


Kundsupport


inschool.fi(at)supportvisma.com

printer.png

SMS-rajapinnat

    Primus tukee useita vaihtoehtoisia tapoja lähettää tekstiviestejä. Ohjeessa on lueteltu rajapinnat sekä niihin liittyvät asetukset Koulun tiedot -rekisterissä.

    Rajapinnat

    1) Paikallinen operaattori

    Viestit lähtevät operaattorin viestikeskuksen kautta. Ennen toiminnon käyttöönottoa tulee selvittää, mikä operaattori on kunnan palveluntarjoaja, onko kunnalla jo sopimus viestikeskuksen käyttämisestä ja ellei ole, mitä viestien lähettäminen SMPP-protokollalla viestikeskuksen kautta vaatisi. Tätä vaihtoehtoa tukee ainakin DNA.

    Paikallisen operaattorin viestipalvelinta käytettäessä valitaan SMS palvelimen tyyppi -kenttään "SMPP V3.4". SMPP-ohjeet ja tunnukset saa koulun/kunnan käyttämältä operaattorilta. Operaattorille tulisi mainita, että lähetyksessä käytetään SMPP-protokollaa.

    Operaattorilta saadut tunnukset ja asetukset kannattaa testata ennen toiminnon käyttöönottoa testiohjelmalla. Viestien hinta ja palvelun toimitusaika vaihtelee operaattorin mukaan.

    2) Aspsms.com-palvelu

    Aspsms.com-palvelun saa käyttöön samantien rekisteröitymällä osoitteessa www.aspsms.com.

    Tätä vaihtoehtoa käytettäessä SMS palvelimen tyyppi -kenttään valitaan "aspsms.com". Rekisteröityessäsi saat tunnuksen ja salasanan, jotka täytetään SMS tunnus- ja SMS salasana -kenttiin. SMS osoite -kenttään tulee xml2.aspsms.com ja SMS portti -kenttään 5061. SMS lähettäjän nimi -kenttään merkitään teksti, jonka halutaan näkyvän viestin lähettäjänä, esim. "OpeVaasa". Lähettäjätiedon on oltava tekstiä, ei numero.

    3) TeliaSoneran Content Gateway

    Täytä kentät SMS osoite ja SMS portti. SMS palvelimen tyyppi -kenttään valitaan "Sonera http CGW". SMS lähettäjän nimi -kenttään merkitään lähettävä puhelinnumero, lyhytnumero tai lähettäjän nimi. Lähettäjän nimi annetaan muodossa dollarinmerkki+nimi, esim. $Mallilan kunta. Lähettäjänä näkyy annettu puhelinnumero tai annettu nimi.

    4) Sonera Mobiiliviesti

    SMS osoite -kenttään tulee api.opaali.telia.fi ja SMS portti -kenttään 443. SMS palvelimen tyyppi -kenttään valitaan "Sonera Mobiiliviesti". SMS välityspalvelu -kenttään tulee joko puhelinnumero tai lyhytnumero. Jos lyhytnumeroa ei ole käytössä, tulisi numeroksi laittaa lähettäjän puhelinnumero muodossa +358000000000. SMS lähettäjän nimi -kenttään täytetään nimi, joka koostuu max. 11 merkistä. Tämä näkyy viestin vastaanottajille. SMS tunnus- ja SMS salasana -kenttiin tulee tunnus ja salasana, jotka saa luomalla applikaation Telian Opaali-profiiliin. Applikaatiotyyppi voi olla Receive only MO (mobile originated) -liikennettä varten tai Massalähetys (bulk) MT (mobile terminated) -liikennettä varten. Jos käytössä ei ole lyhytnumeroa, käytetään Massalähetys-palvelua. Ks. tarkemmat ohjeet Telian sivuilta.

    5) SMTP-rajapinta

    SMTP-rajapinta toimii sellaisilla palvelimilla, joille voi lähettää tekstiviestejä sähköpostin välityksellä. Tämä vaihtoehto toimii esim. Kannel-järjestelmällä.

    Sähköpostin vastaanottajaksi merkitään pelkkä vastaanottajan puhelinnumero, esim. "0501234567". Numeron perään lisätään automaattisesti SMS-SMTP -domainnimi, esim. "@sms.mallila.fi". Sähköpostin otsikoksi (Subject-rivi) laitetaan SMS salasana -kentän tieto. Viestiosuuteen kirjoitetaan varsinainen tekstiviestin sisältö. SMS tunnus -kenttään merkitään viestin lähettäjä, esim. "koulu@mallila.fi". Tunnuksella tulee olla oikeus lähettää tekstiviestejä.

    Postipalvelin tarkistaa salasanan sekä onko "koulu@mallila.fi":llä oikeus lähettää tekstiviestejä. Jos salasana ja oikeudet ovat kunnossa, postipalvelin lähettää sähköpostin tekstiviestinä matkapuhelimeen.

    SMS palvelimen tyyppi -kenttään valitaan "SMTP-rajapinta". SMS-SMTP domainnimi -kenttään täytetään tekstiviestipalvelimen domain-nimi. Lisäksi täytetään kentät SMS osoite ja SMS portti.

    6) Kannel http

    Täytä kentät SMS osoite, SMS portti, SMS tunnus ja SMS salasana. SMS-palvelimen tyyppi -kenttään valitaan "Kannel http".

    7) Soneran monikanava

    Palvelu otetaan käyttöön täyttämällä Soneran yhteydenottolomake. Mainitse, että olet ottamassa käyttöön Soneran monikanava -palvelun Visma InSchoolin Primus-ohjelmassa.

    Tämä rajapinta sallii liikenteen vain salattuna (https), ja siksi täytyy varmistaa, että Primuksen palvelimen asennushakemistossa on tiedostot libeay32.dll ja ssleay32.dll.

    SMS osoite -kenttään tulee "ws.mkv.sonera.fi" ja SMS portti -kenttään 443. SMS tunnus- ja SMS salasana -kenttiin tulee Soneralta saatu tunnus ja salasana. SMS lähettäjän nimi -kentään täytetään nimi, joka voi olla max. 11 merkkiä alfanumeerisena tai 15 merkkiä numeroina.

    8) Fujitsu Invia http SMS GW

    Lisätietoja tästä vaihtoehdosta saat tukipalvelustamme tai Fujitsulta. Ottaessasi yhteyttä Fujitsuun, kerro, että kyse on Visma InSchoolin Wilma- tai Primus-järjestelmästä.

    9) Labyrintti

    Lisätietoja tästä vaihtoehdosta saat tukipalvelustamme tai osoitteesta www.labyrintti.com. Ottaessasi yhteyttä Labyrinttiin kerro, että kyse on Visma InSchoolin Wilma- tai Primus-järjestelmästä.

    10) Bitrace.fi

    Lisätietoja tästä vaihtoehdosta saat tukipalvelustamme tai osoitteesta www.bitrace.fi. Ottaessasi yhteyttä, kerro, että kyse on Visma InSchoolin Wilma- tai Primus-järjestelmästä.

    11) Messto

    SMS osoite -kenttään tulee www.messto.com ja SMS portti -kenttään 80. SMS-tunnus ja -salasana tulee täyttää myös. SMS palvelimen tyyppi -kenttään valitaan "Messto", Lähettäjän nimi -kenttää ei huomioida.

    12) Elisa SMS Gateway

    SMS osoite -kenttään tulee "gate.cc.elisa.fi" ja SMS-portti 80. SMS tunnus - ja SMS salasana -kentät tulee täyttää myös, Lähettäjän nimi -kenttää ei huomioida.

    13) Arena Interactive

    Täytä kentät SMS osoite ja SMS portti. Portiksi laitetaan 80. SMS palvelimen tyyppi -kenttään valitaan "Arena Interactive". SMS tunnus- ja SMS salasana -kenttiin laitetaan operaattorilta saatu tunus ja salasana. Jos liittymiä on useita, annetaan SMS välityspalvelu -kenttään operaattorin antama clientid. Jos liittymiä on vain yksi, voi kentän jättää tyhjäksi. SMS lähettäjän nimi -kenttään täytetään lähettäjän nimi, joka näkyy viestin vastaanottajalle. Jos kenttää ei ole täytetty, vastaanottajalle näkyy operaattorin kanssa määritelty selkokielinen lähettäjän nimi.

    14) Quriiri

    SMS osoite -kenttään tulee api.quriiri.fi ja SMS portti -kenttään 80. SMS lähettäjän nimi -kentässä olevassa nimessä voi olla max. 11 alfanumeerista merkkiä tai 15 numeroa. SMS salasana -kenttään tulee API key, jonka saa Quriirin asetussivuilta. SMS välityspalvelu siirretään laskutuksen ohjaustietona (billingref), jos se on koulun kortille täytetty.

    Päivitetty: 24.8.2017