Käyttöohjeet

Rekisteröityminen ja kirjautuminen

1. Siirry osoitteeseen sms24.fi/rekisteroidy ja täytä rekisteröitymislomake.
2. Vahvista sähköpostiosoitteesi klikkaamalla saamaasi linkkiä.
3. Kirjaudu sisään sähköpostiosoitteellasi ja salasanallasi.
4. Tilillesi on hyvitetty 3 ilmaista tekstiviestiä, joilla voit testata palvelua.

Viestin lähettäminen

1. Kirjaudu sisään SMS24-palveluun.
2. Valitse valikosta "Lähetä viesti".
3. Syötä vastaanottajan puhelinnumero tai valitse kontakti/ryhmä.
4. Kirjoita viestisi (max 160 merkkiä per viesti).
5. Valitse haluatko lähettää viestin heti vai ajastaa sen myöhempään ajankohtaan.
6. Klikkaa "Lähetä" ja viestisi on matkalla!

Kontaktien hallinta

• Kontaktien lisääminen: Lisää kontakteja yksitellen tai tuo ne Excel- tai CSV-tiedostosta.
• Ryhmien luominen: Järjestä kontaktit ryhmiin helpottaaksesi viestien lähettämistä.
• Tiedoston tuonti: Valmistele Excel- tai CSV-tiedosto, jossa sarakkeet ovat: nimi, puhelinnumero. Tuo tiedosto kontaktien hallinnan kautta.

API-ohjeet

SMS24 tarjoaa REST API:n, jonka avulla voit integroida tekstiviestien lähettämisen omaan järjestelmääsi.

Autentikointi

Voit käyttää API:a kahdella tavalla:

• API-avain (suositeltu): Luo API-avain Oma SMS24 → API -sivulta ja käytä sitä Authorization-headerissa:

Authorization: Bearer SINUN_API_AVAIMESI

• Käyttäjätunnus + salasana: Käytä l (login) ja p (password) -parametreja.

JSON API (suositeltu)

Uudempi JSON-rajapinta, joka palauttaa kaikki vastaukset JSON-muodossa ja käyttää HTTP-statuskoodeja.

POST https://gw.sms24.fi/send
Content-Type: application/json

{
  "to": "358401234567",
  "message": "Hei! Tämä on testiviesti."
}

Usealle vastaanottajalle:

{
  "to": ["358401234567", "358409876543"],
  "message": "Viesti kaikille."
}

Lähettäjänimi (Sender ID)

Voit määrittää lähettäjänimen from-parametrilla. Lähettäjänimen täytyy olla lisätty ja hyväksytty Asetukset-sivulla ennen käyttöä.

{
  "to": "358401234567",
  "message": "Testiviesti",
  "from": "MiniYritys"
}

Jos from-parametria ei anneta, käytetään automaattisesti oletukseksi asetettua lähettäjänimeä.

Esimerkki (JSON body):

curl -X POST https://gw.sms24.fi/send \
  -H "Authorization: Bearer SINUN_API_AVAIMESI" \
  -H "Content-Type: application/json" \
  -d '{"to": "358401234567", "message": "Testiviesti", "from": "MiniYritys"}'

Esimerkki (query-parametrit):

curl -H "Authorization: Bearer SINUN_API_AVAIMESI" \
  "https://gw.sms24.fi/send?n=358401234567&m=Testiviesti&from=MiniYritys"

Onnistunut vastaus (200):

{
  "results": [
    {"number": "358401234567", "status": "ok", "batch_id": 123456}
  ]
}

Virhe (401/400):

{"error": "Authentication required"}
{"error": "Lähettäjänimi ei kuulu käyttäjälle"}
{"error": "Lähettäjänimi ei ole vielä hyväksytty"}

Saldon tarkistus (JSON)

GET https://gw.sms24.fi/credits

Esimerkki:

curl -H "Authorization: Bearer SINUN_API_AVAIMESI" \
  "https://gw.sms24.fi/credits"

Vastaus (200):

{"messages": 150}

Legacy API

Vanha rajapinta toimii edelleen. Käytä .html-päätettä legacy-muotoisiin vastauksiin:

GET https://gw.sms24.fi/send.html?l=TUNNUS&p=SALASANA&n=358401234567&m=Testiviesti

Vastaus (teksti):
  &ok[358401234567]=123456
  &error[358401234567]=Virheviesti

GET https://gw.sms24.fi/check_credits.html?l=TUNNUS&p=SALASANA

Vastaus (JSON):
  {"messages": 150}

Luo API-avain Oma SMS24 → API -sivulta aloittaaksesi.