Käyttöohjeet

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.

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 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.

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.

Mitä on MCP?

Model Context Protocol (MCP) on avoin standardi, joka antaa AI-assistenttien — kuten Claude, Cursor ja Windsurf — käyttää ulkoisia palveluita suoraan.

SMS24:n MCP-palvelimen avulla AI-assistenttisi voi lähettää tekstiviestejä, tarkistaa saldon ja hallita kontakteja puolestasi — pelkällä luonnollisella kielellä.

Mitä voit tehdä?

• Viestien lähetys — Lähetä tekstiviestejä yhdelle tai usealle vastaanottajalle luonnollisella kielellä.
• Saldon tarkistus — "Paljonko viestejä on jäljellä?" — AI kertoo saldon suoraan.
• Kontaktit — Hae vastaanottajia osoitekirjasta nimellä tai ryhmällä.

Asennus

Lisää SMS24 MCP -palvelin Claude Desktopiin, Cursoriin tai mihin tahansa MCP-yhteensopivaan sovellukseen.

1. Luo API-avain

Rekisteröidy tai kirjaudu sisään ja luo API-avain Oma SMS24 → API -sivulta.

2. Lisää konfiguraatio

Lisää seuraava JSON-lohko sovelluksesi MCP-asetuksiin:

{
  "mcpServers": {
    "sms24": {
      "url": "https://gw.sms24.fi/mcp",
      "headers": {
        "Authorization": "Bearer SINUN_API_AVAIMESI"
      }
    }
  }
}

Claude Desktop: Avaa Settings → Developer → Edit Config ja lisää yllä oleva sms24-lohko mcpServers-osion alle. Käynnistä Claude Desktop uudelleen.

Cursor / Windsurf: Lisää sama konfiguraatio sovelluksen MCP-asetuksiin. Katso sovelluksen ohjeista tarkempi polku.

Käyttöesimerkkejä

Kun MCP-palvelin on asennettu, voit pyytää AI-assistenttiasi esimerkiksi:

• "Lähetä viesti +358401234567: Tapaaminen siirtyy klo 14:00"
• "Kuinka monta viestiä minulla on jäljellä?"
• "Lähetä kaikille Myyntitiimi-ryhmän jäsenille: Viikkokokous peruttu"

Yhteensopivat sovellukset