Hyppää sisältöön

SMS-viestejä

Lähetä vakiotekstiviestejä SMSBAT API:n avulla. SMS on yleisin viestintäkanava, jolla on korkein toimitusnopeus kaikissa mobiililaitteissa.

Yleiskatsaus

SMS (Short Message Service) on ihanteellinen:

  • Aikakriittiset ilmoitukset
  • Viber-/RCS-viestien varoitus
  • Käyttäjien tavoittaminen ilman älypuhelimia
  • Universaali yhteensopivuus kaikissa mobiiliverkoissa
  • Korkeat toimituskulut (95%+)

Perustekstiviesti

Pyyntö

{
  "from": "YourSender",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your SMS message text"
}

Parametrit

Parametri Tyyppi Pakollinen Kuvaus
"alkaen" merkkijono Kyllä Aakkosnumeerinen lähettäjän tunnus (enintään 11 ​​merkkiä)
"to" merkkijono Kyllä Vastaanottajan puhelinnumero E.164-muodossa
"tyyppi" merkkijono Kyllä Aseta "tekstiviestiksi"
"teksti" merkkijono Kyllä Viestin sisältö
customerMessageId merkkijono Ei Sisäinen seurantatunnuksesi
ttl kokonaisluku Ei Elinaika sekunneissa

Esimerkkejä

Yksinkertainen tekstiviesti

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -H "X-Authorization-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{
      "from": "YourBrand",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Hello! This is a test SMS message."
    }]
  }'

SMS asiakastunnuksella

{
  "messages": [{
    "from": "YourStore",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "Your order #12345 has been shipped.",
    "customerMessageId": "order-12345-notification"
  }]
}

Tekstiviesti TTL:llä

{
  "messages": [{
    "from": "YourApp",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "Your verification code is: 123456",
    "ttl": 300
  }]
}

Merkkikoodaus

7-bittinen GSM-koodaus

Normaali GSM-aakkoset (160 merkkiä per tekstiviesti):

A-Z a-z 0-9
@ £ $ ¥ è é ù ì ò Ç Ø ø Å å
Δ _ Φ Γ Λ Ω Π Ψ Σ Θ Ξ
! " # % & ' ( ) * + , - . / : ; < = > ?

Laajennetut GSM-merkit

Nämä merkit lasketaan kahdeksi merkiksi:

| ^ € { } [ ] ~ \

Unicode (UCS-2) -koodaus

Erikoismerkkejä sisältävät viestit käyttävät Unicode-koodausta (70 merkkiä per tekstiviesti):

  • Emoji: 😀 🎉 ❤️
  • Kyrillinen: А Б В Г Д Е Ж
  • Erikoissymbolit: ✓ ✗ ★ ♥

Viestin pituus

Yksi tekstiviesti

  • GSM 7-bittinen: 160 merkkiä
  • Unicode: 70 merkkiä

Moniosainen tekstiviesti

Kun viestisi ylittää rajan, se jaetaan useisiin osiin:

  • GSM 7-bittinen: 153 merkkiä per osa
  • Unicode: 67 merkkiä per osa

Esimerkki

{
  "messages": [{
    "from": "YourBrand",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "This is a very long message that will be split into multiple parts. Each part will be delivered separately but will appear as a single message on the recipient's phone. The system automatically handles the splitting and reassembly."
  }]
}

Tämä viesti (201 merkkiä) jaetaan kahteen osaan.

Vastaus

Menestysvastaus

{
  "messagelistId": 123456,
  "messages": [
    {
      "messageId": "abc123def456",
      "status": "accepted",
      "parts": 2,
      "customerMessageId": "order-12345-notification",
      "to": "+380XXXXXXXXX"
    }
  ]
}

Vastauskentät

Kenttä Kuvaus
"messageId" Yksilöllinen tunniste seurantaa varten
"tila" Viestin tila ("hyväksytty", "hylätty")
"osat" SMS-osien määrä
"to" Vastaanottajan puhelinnumero

Lähettäjätunnus

Aakkosnumeerinen lähettäjä

Käytä tuotemerkkiäsi lähettäjänä (enintään 11 merkkiä):

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Hello from YourBrand!"
}

Rajoitukset:

  • Enintään 11 merkkiä
  • Vain kirjaimet ja numerot
  • Ei välilyöntejä tai erikoismerkkejä
  • Vastaanottaja ei voi vastata aakkosnumeerisille lähettäjille

Numeerinen lähettäjä

Käytä puhelinnumeroa lähettäjänä (kaksisuuntaiseen tekstiviestiin):

{
  "from": "+380123456789",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Hello! You can reply to this message."
}

Käyttötapaukset

OTP-vahvistus

{
  "from": "YourApp",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your verification code is: 123456. Valid for 5 minutes.",
  "ttl": 300
}

Tilausilmoitukset

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your order #12345 has been delivered. Thank you for shopping with us!"
}

Ajanvarausmuistutukset

{
  "from": "YourClinic",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Reminder: Your appointment is scheduled for tomorrow at 2:00 PM."
}

Maksuvahvistukset

{
  "from": "YourBank",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Payment of 100 USD to Merchant ABC was successful. Transaction ID: 789xyz"
}

Parhaat käytännöt

Viestin sisältö

  • ✅ Pidä viestit ytimekkäinä ja selkeinä
  • ✅ Liitä mukaan lähettäjän tunniste
  • ✅ Lisää tarvittaessa toimintakehotus
  • ✅ Käytä oikeaa kielioppia ja oikeinkirjoitusta
  • ❌ Vältä liiallisia välimerkkejä!!!
  • ❌ Älä käytä isoja kirjaimia
  • ❌ Vältä epäilyttäviltä näyttäviä URL-lyhennyksiä

Hahmon käyttö

  • Tarkista merkkimäärä ennen lähettämistä
  • Ole tietoinen laajennetuista GSM-merkeistä (lasketaan 2:ksi)
  • Testaa erikoismerkeillä ennen joukkolähetystä
  • Harkitse GSM-koodauksen käyttöä pidemmissä viesteissä

Puhelinnumerot

  • Käytä aina muotoa E.164: +380XXXXXXXXX
  • Vahvista puhelinnumerot ennen lähettämistä
  • Poista virheelliset numerot luettelostasi
  • Pidä yhteystietoluettelosi ajan tasalla

Ajoitus

  • Kunnioita paikallisia aikavyöhykkeitä
  • Vältä lähettämistä yöllä (22.00 - 8.00)
  • Harkitse kaupallisten viestien aukioloaikoja
  • Aseta oikea TTL aikaherkille viesteille

Vaatimustenmukaisuus

  • Hanki suostumus ennen markkinointiviestien lähettämistä
  • Sisällytä ohjeet mainostekstiviestien käytöstä poistamiseen
  • Noudata paikallisia määräyksiä (GDPR jne.)
  • Kunnioita "Älä häiritse" -luetteloita

Virheiden käsittely

Yleisiä virheitä

Virhe Syy Ratkaisu
INVALID_RECIPIENT Väärä puhelinmuoto Käytä muotoa E.164
INVALID_SENDER Virheellinen lähettäjän tunnus Tarkista lähettäjän tunnussäännöt
MESSAGE_TOO_LONG Ylittää enimmäispituuden Jaa tai lyhennä viesti
INVALID_ENCODING Merkit, joita ei tueta Käytä GSM:tä tai Unicodea

Kustannusoptimointi

Vähennä viestiosia

  • Pidä viestit alle 160 (GSM) tai 70 (Unicode) merkin pituisina
  • Vältä Unicoden laukaisevia erikoismerkkejä
  • Käytä tarvittaessa lyhenteitä
  • Poista tarpeettomat tilat

Esimerkkioptimointi

❌ Ennen (171 merkkiä, 2 tekstiviestiä): 

Hello John! Your order #12345 has been successfully delivered to your address at 123 Main Street. Thank you for shopping with us! We hope to see you again soon.

✅ After (156 merkkiä, 1 tekstiviesti): 

Hi John! Order #12345 delivered to 123 Main St. Thanks for shopping with us! Visit example.com/order/12345 for details.

Joukkolähetys

Lähetä useita viestejä yhdellä pyynnöllä:

{
  "messages": [
    {
      "from": "YourBrand",
      "to": "+380111111111",
      "type": "sms",
      "text": "Message 1"
    },
    {
      "from": "YourBrand",
      "to": "+380222222222",
      "type": "sms",
      "text": "Message 2"
    },
    {
      "from": "YourBrand",
      "to": "+380333333333",
      "type": "sms",
      "text": "Message 3"
    }
  ]
}

Seuraavat vaiheet