SMS üzenetek

Normál szöveges üzenetek küldése SMSBAT API használatával. Az SMS a leguniverzálisabb üzenetküldési csatorna, amely a legmagasabb kézbesítési aránnyal rendelkezik az összes mobileszközön.

Áttekintés

Az SMS (Short Message Service) ideális:

Időkritikus értesítések
Tartalék a Viber/RCS üzenetekhez
A felhasználók elérése okostelefon nélkül
Univerzális kompatibilitás az összes mobilhálózaton
Magas szállítási arány (95%+)

Alapvető SMS-üzenet

Kérelem

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

Paraméterek

Paraméter	Típus	Kötelező	Leírás
"tól"	húr	Igen	Alfanumerikus feladóazonosító (legfeljebb 11 karakter)
"hoz"	húr	Igen	A címzett telefonszáma E.164 formátumban
"típus"	húr	Igen	`"sms"`
"szöveg"	húr	Igen	Üzenet tartalma
`customerMessageId`	húr	Nem	Az Ön belső követési azonosítója
"ttl"	egész	Nem	Élettartam másodpercben

Példák

Egyszerű SMS

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 ügyfél-azonosítóval

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

SMS TTL-lel

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

Karakterkódolás

GSM 7 bites kódolás

Normál GSM ábécé (160 karakter SMS-enként):

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

Kiterjesztett GSM karakterek

Ezek a karakterek 2 karakternek számítanak:

| ^ € { } [ ] ~ \

Unicode (UCS-2) kódolás

A speciális karaktereket tartalmazó üzenetek Unicode kódolást használnak (70 karakter SMS-enként):

Emoji: 😀 🎉 ❤️
Cirill: А Б В Г Д Е Ж
Különleges szimbólumok: ✓ ✗ ★ ♥

Üzenet hossza

Egyetlen SMS

GSM 7 bites: 160 karakter
Unicode: 70 karakter

Többrészes SMS

Ha az üzenet meghaladja a korlátot, az több részre oszlik:

GSM 7-bit: 153 karakter részenként
Unicode: 67 karakter részenként

Példa

{
  "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."
  }]
}

Ez az üzenet (201 karakter) 2 részre oszlik.

Válasz

Sikerreakció

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

Válaszmezők

Mező	Leírás
`messageId`	Egyedi azonosító a követéshez
"állapot"	Üzenet állapota ("elfogadva", "elutasítva")
"alkatrészek"	SMS részek száma
"hoz"	Címzett telefonszáma

Feladó azonosítója

Alfanumerikus feladó

Használja a márkanevét feladóként (legfeljebb 11 karakter):

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

Korlátozások:

Maximum 11 karakter
Csak betűk és számok
Nincs szóköz vagy speciális karakter
A címzett nem tud válaszolni az alfanumerikus feladóknak

Numerikus küldő

Használjon telefonszámot feladóként (kétirányú SMS esetén):

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

Használati esetek

OTP ellenőrzés

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

Rendelési értesítések

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

Találkozó emlékeztetők

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

Fizetési visszaigazolások

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

Bevált gyakorlatok

Üzenet tartalma

✅ Az üzenetek legyenek tömörek és világosak
✅ Tartalmazza a feladó azonosítóját
✅ Adjon hozzá cselekvésre ösztönzést, ha szükséges
✅ Használjon megfelelő nyelvtant és helyesírást
❌ Kerüld a túlzott írásjeleket!!!
❌ Ne használjon csupa nagybetűt
❌ Kerülje a gyanúsnak tűnő URL-rövidítőket

Karakterhasználat

Küldés előtt ellenőrizze a karakterek számát
Ügyeljen a kiterjesztett GSM karakterekre (2-nek számít)
A tömeges küldés előtt tesztelje a speciális karaktereket
Fontolja meg a GSM-kódolás használatát hosszabb üzenetekhez

Telefonszámok

Mindig az E.164 formátumot használja: +380XXXXXXXXX
Elküldés előtt ellenőrizze a telefonszámokat
Távolítsa el az érvénytelen számokat a listáról
Tartsa naprakészen névjegyzékét

Időzítés

Tartsa tiszteletben a helyi időzónákat
Kerülje az éjszakai küldést (22:00-8:00)
Vegye figyelembe a kereskedelmi üzenetek nyitvatartási idejét
Állítsa be a megfelelő TTL-t az időérzékeny üzenetekhez

Megfelelés

A marketingüzenetek küldése előtt szerezze be a hozzájárulást
Tartalmazza a leiratkozási utasításokat a promóciós SMS-ekhez
Kövesse a helyi előírásokat (GDPR stb.)
Tartsa tiszteletben a „Ne zavarjanak” listákat

Hibakezelés

Gyakori hibák

Hiba	Ok	Megoldás
`INVALID_RECIPIENT`	Rossz telefonformátum	E.164 formátum használata
`INVALID_SENDER`	Érvénytelen feladóazonosító	A feladóazonosító szabályok ellenőrzése
`MESSAGE_TOO_LONG`	Túllépi a maximális hosszt	Üzenet felosztása vagy rövidítése
`INVALID_ENCODING`	Nem támogatott karakterek	GSM vagy Unicode

Költségoptimalizálás

Az üzenetrészek csökkentése

Az üzenetek 160 (GSM) vagy 70 (Unicode) karakternél rövidebbek
Kerülje a Unicode kódot kiváltó speciális karaktereket
Adott esetben használjon rövidítéseket
Távolítsa el a felesleges helyeket

Optimalizálási példa

❌ Előtte (171 karakter, 2 SMS):

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.

✅ Utána (156 karakter, 1 SMS):

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

Tömeges küldés

Több üzenet küldése egy kérelemben:

{
  "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"
    }
  ]
}

Következő lépések

Viber Messages - Multimédiás üzenetküldés
RCS-üzenetek - Gazdag kommunikációs szolgáltatások
Állapot ellenőrzése - Kövesse nyomon a kézbesítés állapotát
Tartalék stratégiák - Tartalékok konfigurálása